11# PowerUtils.Text
22Helpers, extensions and utilities for manipulating
33
4- | Package | Version | Downloads |
5- | --- | --- | --- |
6- | ` PowerUtils.Text ` | [ ![ NuGet] ( https://img.shields.io/nuget/v/PowerUtils.Text.svg )] ( https://www.nuget.org/packages/PowerUtils.Text ) | [ ![ Nuget] ( https://img.shields.io/nuget/dt/PowerUtils.Text.svg )] ( https://www.nuget.org/packages/PowerUtils.Text ) |
4+ ![ CI] ( https://github.com/TechNobre/PowerUtils.Text/actions/workflows/main.yml/badge.svg )
5+ [ ![ NuGet] ( https://img.shields.io/nuget/v/PowerUtils.Text.svg )] ( https://www.nuget.org/packages/PowerUtils.Text )
6+ [ ![ Nuget] ( https://img.shields.io/nuget/dt/PowerUtils.Text.svg )] ( https://www.nuget.org/packages/PowerUtils.Text )
7+
8+
79
810## Support to
911- .NET 2.0 or more
@@ -12,6 +14,21 @@ Helpers, extensions and utilities for manipulating
1214
1315
1416
17+ ## Features
18+
19+ - [ Extensions] ( #Extensions )
20+ - [ CleanExtraSpaces] ( #string.CleanExtraSpaces )
21+ - [ CleanExtraLineBreak] ( #string.CleanExtraLineBreak )
22+ - [ CleanExtraLineBreakAndLineBreak] ( #string.CleanExtraLineBreakAndLineBreak )
23+ - [ EmptyOrWhiteSpace] ( #string.EmptyOrWhiteSpace )
24+ - [ CompressText] ( #string.CompressText )
25+ - [ Truncate] ( #string.Truncate )
26+ - [ UppercaseFirst] ( #string.UppercaseFirst )
27+ - [ CapitalizeName] ( #string.CapitalizeName )
28+ - [ CleanSpecialCharacters] ( #string.CleanSpecialCharacters )
29+
30+
31+
1532## Documentation
1633
1734### How to use
@@ -29,64 +46,83 @@ Install-Package PowerUtils.Text
2946dotnet add package PowerUtils.Text
3047```
3148
32- ### Extensions
33-
34-
35- #### string.CleanExtraSpaces();
49+ ### Extensions <a name =" Extensions " ></a >
3650
51+ #### string.CleanExtraSpaces(); <a name =" string.CleanExtraSpaces " ></a >
3752Clean extra spaces. Replace tabs to one space and double spaces to one space
3853
3954``` csharp
4055// result = "Hello world!!!"
4156var result = " Hello world!!! " .CleanExtraSpaces ();
4257```
4358
44-
45- #### string.CleanExtraLineBreak();
46-
59+ #### string.CleanExtraLineBreak(); <a name =" string.CleanExtraLineBreak " ></a >
4760Clean extra line breaks. Replace double line breaks to one line break
4861
4962``` csharp
5063// result = "Hello\r\nWorld!!!"
5164var result = " Hello\r\n\r\n\r\n World!!!" .CleanExtraLineBreak ();
5265```
5366
54- #### string.CleanExtraLineBreakAndLineBreak();
55-
67+ #### string.CleanExtraLineBreakAndLineBreak(); <a name =" string.CleanExtraLineBreakAndLineBreak " ></a >
5668Clean extra spaces, override tabs to one space, double spaces to one space and double line breaks to one line break
5769
5870``` csharp
5971// result = "Hello\r\nWorld!!!"
6072var result = " Hello \r\n\r\n\r\n World!!! " .CleanExtraLineBreakAndLineBreak ();
6173```
6274
63- #### string.EmptyOrWhiteSpace();
64-
75+ #### string.EmptyOrWhiteSpace(); <a name =" string.EmptyOrWhiteSpace " ></a >
6576Convert a string with empty or white spaces to null
6677
6778``` csharp
6879// result = null
6980var result = " " .EmptyOrWhiteSpace ();
7081```
7182
72- #### string.CompressText(maxLength);
73-
83+ #### string.CompressText(maxLength); <a name =" string.CompressText " ></a >
7484Compress text if greater the max length
7585
7686``` csharp
77- // result = "Hell� "
87+ // result = "Hell... "
7888var result = " Hello world!!!" .CompressText (5 );
7989```
8090
81- #### string.Truncate(maxLength);
82-
91+ #### string.Truncate(maxLength); <a name =" string.Truncate " ></a >
8392Truncate text if greater the max length
8493
8594``` csharp
8695// result = "Hello"
8796var result = " Hello world!!!" .Truncate (5 );
8897```
8998
99+ #### string.UppercaseFirst(); <a name =" string.UppercaseFirst " ></a >
100+ Uppercase the first character
101+
102+ ``` csharp
103+ // result = "Hello world!!!"
104+ var result = " hello world!!!" .UppercaseFirst ();
105+ ```
106+
107+ #### string.CapitalizeName(); <a name =" string.CapitalizeName " ></a >
108+ Capitalize the people amd company names
109+
110+ ``` csharp
111+ // result = "Nelson Nobre"
112+ var result = " nelson nobre" .CapitalizeName ();
113+ ```
114+
115+ #### string.CleanSpecialCharacters(substitute = ""); <a name =" string.CleanSpecialCharacters " ></a >
116+ Capitalize the people amd company names
117+
118+ ``` csharp
119+ // result1 = "HelloWorld"
120+ var result1 = " Hello World!!!" .CleanSpecialCharacters ();
121+
122+ // result2 = "Hello-World"
123+ var result2 = " Hello World" .CleanSpecialCharacters (" -" );
124+ ```
125+
90126
91127
92128## Contribution
@@ -97,4 +133,16 @@ var result = "Hello world!!!".Truncate(5);
97133
98134## LICENSE
99135
100- [ MIT] ( https://github.com/TechNobre/PowerUtils.Text/blob/main/LICENSE )
136+ [ MIT] ( https://github.com/TechNobre/PowerUtils.Text/blob/main/LICENSE )
137+
138+
139+
140+ ## Release Notes
141+
142+
143+ ### v1.1.0 - 2021/07/18
144+
145+ #### New features
146+ - Added extension ** string.UppercaseFirst()** . To uppercase the first character;
147+ - Added extension ** string.CapitalizeName()** . To capitalize the people and company names;
148+ - Added extension ** string.CleanSpecialCharacters()** . To replace all special characters in a string for other character;
0 commit comments