Skip to content
/ Aqua.StringHelpers Public
forked from ualehosaini/Aqua.StringHelpers

Aqua String Helpers is an Open Source and Free Software package consists of a set of utilities that facilitate the job of the developer and save his time while dealing with a string. Please feel free to fork and contribute

License

MIT, MIT licenses found

Licenses found

MIT
License
MIT
License.md
0 stars 3 forks Branches Tags Activity
Star
Notifications You must be signed in to change notification settings

el7lme/Aqua.StringHelpers

BranchesTags
Β 
Β 

Repository files navigation

Build status NuGet Version

About Aqua String Helpers:

Aqua String Helpers is an Open Source and Free Software package consists of a set of utilities that facilitate the job of the developer and save his time while dealing with a string. Every developer could be a beneficiary of this library; however, those who deal with database and integration applications are likely the most potential beneficiaries.

List of Features and Methods

  1. IsNullOrEmpty
  2. IsNullOrWhiteSpace
  3. IsDigit
  4. IsInteger
  5. IsNumber
  6. IsAlphaNumeric
  7. IsValidURL
  8. IfNullReturnEmptyString
  9. Reverse
  10. RemoveExtraSpaces
  11. RemoveAllLineBreaks
  12. RemoveNonASCIIChars
  13. RemoveNumberOfCharsAtBegining
  14. RemoveNumberOfCharsAtEnd
  15. ReplaceTabsWithSpaces
  16. ReplaceNewLinesWithSpaces
  17. ReplaceDoubleQuotesWithSingle
  18. ReplaceSingleQuotesWithDouble
  19. ReplaceNonASCIICharsWith
  20. ReplaceFirstOccurrence
  21. ToCleanString
  22. ToAlphaNumericString
  23. ToHtml
  24. ToAbbreviation
  25. ToNcharAbbreviation
  26. ToHyperlink
  27. ToSentenceCase
  28. ToBase64
  29. ToSummarisedText
  30. ToSummarisedTextRight
  31. ToCsvCompatible
  32. ToUkTelephoneFormat
  33. ToUpperCaseCanonicalGuid
  34. ToDoubleQuotedString
  35. ToStringArrayFromDelimitedString
  36. ToUrlFriendly
  37. ToCanonicalGuid
  38. ToDistinctListOfWords
  39. To16ByteSaltedHash
  40. CapitaliseEachWord
  41. AddToBeginingIfMissed
  42. DecodeBase64
  43. CountStringOccurrences
  44. FindAllDigits
  45. FindNumberOfDigits
  46. CorrectPathSlashes
  47. CenterAligned
  48. HowManyOccurrences
  49. CleanNonNumericChars
  50. NullIfEqualTo
  51. GetTotalNumberOfWords
  52. GetTotalNumberOfCharachters
  53. GetFirstLongestWord
  54. GetFirstShortestWord
  55. GetTotalNumberOfLines
  56. GetUrlDomain
  57. GetFileExtension
  58. AddToEndIfMissed
  59. GenerateLoremIpsumString
  60. GenerateLoremIpsumHtmlSafe
  61. Coalesce
  62. GetFirstNullOrEmpty

Features and Methods

IsNullOrEmpty

IsNullOrEmpty is an extension method, equivalent for the traditional string.IsNullOrEmpty() static method. Returns true if the string examined is null or empty, otherwise returns false.

//using Aqua.StringHelpers;

string input;
bool output;

input = null;
output = input.IsNullOrEmpty();  // output = true

input = "";
output = input.IsNullOrEmpty();  // output = true

input = " ";
output = input.IsNullOrEmpty();  // output = false

input = "lorem ipsum dolor";
output = input.IsNullOrEmpty();  // output = false

πŸ”™Back to the Full List of Features

IsNullOrWhiteSpace

IsNullOrEmpty is an extension method, equivalent for the traditional string.IsNullOrWhiteSpace() static method. Returns true if the string examined is null or empty, otherwise returns false.

//using Aqua.StringHelpers;

string input;
bool output;

input = null;
output = input.IsNullOrWhiteSpace();  // output = true

input = "";
output = input.IsNullOrWhiteSpace();  // output = true

input = " ";
output = input.IsNullOrWhiteSpace();  // output = false

input = "lorem ipsum dolor";
output = input.IsNullOrWhiteSpace();  // output = false

πŸ”™Back to the Full List of Features

IsDigit

//using Aqua.StringHelpers;

char input;
bool output;

input = '0';
output = input.IsDigit();  // output = true

input = '9';
output = input.IsDigit();  // output = true

input = 'A';
output = input.IsDigit();  // output = false

πŸ”™Back to the Full List of Features

IsInteger

//using Aqua.StringHelpers;

string input;
bool output;

input = null;
output = input.IsInteger();  // output = false

input = "";
output = input.IsInteger();  // output = false

input = " ";
output = input.IsInteger();  // output = false

input = "5";
output = input.IsInteger();  // output = true

input = "555";
output = input.IsInteger();  // output = true

input = "555.50";
output = input.IsInteger();  // output = false

input = "lorem ipsum dolor";
output = input.IsInteger();  // output = false

πŸ”™Back to the Full List of Features

IsNumber

//using Aqua.StringHelpers;

string input;
bool output;

input = null;
output = input.IsNumber();  // output = false

input = "";
output = input.IsNumber();  // output = false

input = " ";
output = input.IsNumber();  // output = false

input = "5";
output = input.IsNumber();  // output = true

input = "555";
output = input.IsNumber();  // output = true

input = "555.50";
output = input.IsNumber();  // output = true

input = "lorem ipsum dolor";
output = input.IsNumber();  // output = false

πŸ”™Back to the Full List of Features

IsAlphaNumeric

//using Aqua.StringHelpers;

string input;
bool output;

input = null;
output = input.IsAlphaNumeric();  // output = false

input = "";
output = input.IsAlphaNumeric();  // output = false

input = " ";
output = input.IsAlphaNumeric();  // output = false

input = "5";
output = input.IsAlphaNumeric();  // output = true

input = "5A";
output = input.IsAlphaNumeric();  // output = true

input = "A5";
output = input.IsAlphaNumeric();  // output = true

input = "lorem ipsum dolor";
output = input.IsAlphaNumeric();  // output = false

input = "loremipsumdolor";
output = input.IsAlphaNumeric();  // output = true

input = "$loremips((umdolor";
output = input.IsAlphaNumeric();  // output = false

πŸ”™Back to the Full List of Features

IsValidURL

using Aqua.StringHelpers;

string input;
bool output;

input = null;
output = input.IsValidURL();  // output = false

input = "";
output = input.IsValidURL();  // output = false

input = " ";
output = input.IsValidURL();  // output = false

input = "http://wideitsolutions.co.uk";
output = input.IsValidURL();  // output = true

input = "https://wideitsolutions.co.uk";
output = input.IsValidURL();  // output = true

input = "http://dev.wideitsolutions.co.uk";
output = input.IsValidURL();  // output = true

input = "http://wideitsolutions.co.uk/dev";
output = input.IsValidURL();  // output = true

πŸ”™Back to the Full List of Features

IfNullReturnEmptyString

//using Aqua.StringHelpers;

string input;
string output;

input = null;
output = input.IfNullReturnEmptyString();  // output = ""

input = "";
output = input.IfNullReturnEmptyString();  // output = ""

input = " ";
output = input.IfNullReturnEmptyString();  // output = " "

input = "lorem ipsum";
output = input.IfNullReturnEmptyString();  // output = "lorem ipsum"

πŸ”™Back to the Full List of Features

Reverse

//using Aqua.StringHelpers;

string input;
string output;

input = null;
output = input.Reverse();  // output = null

input = "";
output = input.Reverse();  // output = ""

input = " ";
output = input.Reverse();  // output = " "

input = "lorem ipsum";
output = input.Reverse();  // output = "muspi merol"

input = "A12345";
output = input.Reverse();  // output = "54321A"

πŸ”™Back to the Full List of Features

RemoveExtraSpaces

//using Aqua.StringHelpers;

string input;
string output;

input = null;
output = input.RemoveExtraSpaces();  // output = null

input = "";
output = input.RemoveExtraSpaces();  // output = ""

input = " ";
output = input.RemoveExtraSpaces();  // output = ""

input = "lorem ipsum";
output = input.RemoveExtraSpaces();  // output = "lorem ipsum"

input = "  lorem ipsum      lorem ipsum  ";
output = input.RemoveExtraSpaces();  // output = "lorem ipsum lorem ipsum"

πŸ”™Back to the Full List of Features

RemoveAllLineBreaks

//using Aqua.StringHelpers;

string input;
string output;

input = null;
output = input.RemoveAllLineBreaks();  // output = null

input = "";
output = input.RemoveAllLineBreaks();  // output = ""

input = " ";
output = input.RemoveAllLineBreaks();  // output = " "

input = "lorem\n ipsum";
output = input.RemoveAllLineBreaks();  // output = "lorem ipsum"

input = "  lorem \nipsum      lorem\n ipsum  ";
output = input.RemoveAllLineBreaks();  // output = "  lorem ipsum      lorem ipsum  "

πŸ”™Back to the Full List of Features

RemoveNonASCIIChars

//using Aqua.StringHelpers;

string input;
string output;

input = null;
output = input.RemoveNonASCIIChars();  // output = null

input = "";
output = input.RemoveNonASCIIChars();  // output = ""

input = " ";
output = input.RemoveNonASCIIChars();  // output = " "

input = "lorem ipsum";
output = input.RemoveNonASCIIChars();  // output = "lorem ipsum"

input = "lorem ΰ€­ΰ€Ύΰ€°ΰ€€ ipsum";
output = input.RemoveNonASCIIChars();  // output = "lorem  ipsum"

πŸ”™Back to the Full List of Features

RemoveNumberOfCharsAtBegining

//using Aqua.StringHelpers;

string input;
int n; //number of characters
string output;

input = null;
n = 3;
output = input.RemoveNumberOfCharsAtBegining(n);  // output = null

input = "";
n = 3;
output = input.RemoveNumberOfCharsAtBegining(n);  // output = ""

input = " ";
n = 3;
output = input.RemoveNumberOfCharsAtBegining(n);  // output = ""

input = "lorem ipsum";
n = 3;
output = input.RemoveNumberOfCharsAtBegining(n);  // output = "em ipsum"

input = "  lorem ipsum";
n = 3;
output = input.RemoveNumberOfCharsAtBegining(n);  // output = "orem  ipsum"

πŸ”™Back to the Full List of Features

RemoveNumberOfCharsAtEnd

//using Aqua.StringHelpers;

string input;
int n; //number of characters
string output;

input = null;
n = 3;
output = input.RemoveNumberOfCharsAtEnd(n);  // output = null

input = "";
n = 3;
output = input.RemoveNumberOfCharsAtEnd(n);  // output = ""

input = " ";
n = 3;
output = input.RemoveNumberOfCharsAtEnd(n);  // output = ""

input = "lorem ipsum";
n = 3;
output = input.RemoveNumberOfCharsAtEnd(n);  // output = "lorem ip"

input = "lorem ipsum  ";
n = 3;
output = input.RemoveNumberOfCharsAtEnd(n);  // output = "lorem  ipsu"

πŸ”™Back to the Full List of Features

ReplaceTabsWithSpaces

//using Aqua.StringHelpers;

string input;
string output;

input = null;
output = input.ReplaceTabsWithSpaces();  // output = null

input = "";
output = input.ReplaceTabsWithSpaces();  // output = ""

input = " ";
output = input.ReplaceTabsWithSpaces();  // output = ""

input = "lorem              ipsum";      //4 tabs were here
output = input.ReplaceTabsWithSpaces();  // output = "lorem ipsum"

input = "   lorem               ipsum "; //6 tabs were here
output = input.ReplaceTabsWithSpaces();  // output = "lorem ipsum"

πŸ”™Back to the Full List of Features

ReplaceNewLinesWithSpaces

//using Aqua.StringHelpers;

string input;
string output;

input = null;
output = input.ReplaceNewLinesWithSpaces();  // output = null

input = "";
output = input.ReplaceNewLinesWithSpaces();  // output = ""

input = " ";
output = input.ReplaceNewLinesWithSpaces();  // output = ""

input = "lorem\nipsum";
output = input.ReplaceNewLinesWithSpaces();  // output = "lorem ipsum"

input = "\nlorem\n\n      ipsum\ndolor";
output = input.ReplaceNewLinesWithSpaces();  // output = "lorem ipsum dolor"

πŸ”™Back to the Full List of Features

ReplaceDoubleQuotesWithSingle

//using Aqua.StringHelpers;

string input;
string output;

input = null;
output = input.ReplaceDoubleQuotesWithSingle();  // output = null

input = "";
output = input.ReplaceDoubleQuotesWithSingle();  // output = ""

input = " ";
output = input.ReplaceDoubleQuotesWithSingle();  // output = " "

input = "lorem \"ipsum\"";
output = input.ReplaceDoubleQuotesWithSingle();  // output = "lorem 'ipsum'"

input = "lorem\"              ipsum dolor";
output = input.ReplaceDoubleQuotesWithSingle();  // output = "lorem'              ipsum dolor"

πŸ”™Back to the Full List of Features

ReplaceSingleQuotesWithDouble

//using Aqua.StringHelpers;

string input;
string output;

input = null;
output = input.ReplaceSingleQuotesWithDouble();  // output = null

input = "";
output = input.ReplaceSingleQuotesWithDouble();  // output = ""

input = " ";
output = input.ReplaceSingleQuotesWithDouble();  // output = " "

input = "lorem 'ipsum'";
output = input.ReplaceSingleQuotesWithDouble();  // output = "lorem \"ipsum\""

input = "lorem'              ipsum dolor";
output = input.ReplaceSingleQuotesWithDouble();  // output = "lorem\"              ipsum dolor"

πŸ”™Back to the Full List of Features

ReplaceNonASCIICharsWith

//using Aqua.StringHelpers;

string input;
char r;         // Replacement Character
string output;

input = null;
r = '*';
output = input.ReplaceNonASCIICharsWith(r);  // output = null

input = "";
r = '*';
output = input.ReplaceNonASCIICharsWith(r);  // output = ""

input = " ";
r = '*';
output = input.ReplaceNonASCIICharsWith(r);  // output = " "

input = "lorem ipsum";
r = '*';
output = input.ReplaceNonASCIICharsWith(r);  // output = "lorem ipsum"

input = "lorem ΰ€­ΰ€Ύΰ€°ΰ€€ ipsum";
r = '*';
output = input.ReplaceNonASCIICharsWith(r);  // output = "lorem **** ipsum"

πŸ”™Back to the Full List of Features

ReplaceFirstOccurrence

//using Aqua.StringHelpers;

string input;
string s;         // Search string
string r;         // Replacement string
string output;

input = null;
s = "ip";
r = "**";
output = input.ReplaceFirstOccurrence(s,r);  // output = null

input = "";
s = "ip";
r = "**";
output = input.ReplaceFirstOccurrence(s, r);  // output = ""

input = " ";
s = "ip";
r = "**";
output = input.ReplaceFirstOccurrence(s, r);  // output = " "

input = "lorem ipsum ipsum";
s = "ip";
r = "**";
output = input.ReplaceFirstOccurrence(s, r);  // output = "lorem **sum ipsum"

input = "lorem ipsum dolor";
s = "ip";
r = "**";
output = input.ReplaceFirstOccurrence(s, r);  // output = "lorem **sum dolor"

πŸ”™Back to the Full List of Features

ToCleanString

//using Aqua.StringHelpers;

string input;
string output;

input = null;
output = input.ToCleanString();  // output = null

input = "";
output = input.ToCleanString();  // output = ""

input = " ";
output = input.ToCleanString();  // output = ""

input = "   lorem     ipsum      ";
output = input.ToCleanString();  // output = "lorem ipsum"

input = " lorem\n     ipsum\n";  // there is mix of \n \t and spaces
output = input.ToCleanString();  // output = "lorem ipsum"

πŸ”™Back to the Full List of Features

ToAlphaNumericString

//using Aqua.StringHelpers;

string input;
string output;

input = null;
output = input.ToAlphaNumericString();  // output = null

input = "";
output = input.ToAlphaNumericString();  // output = ""

input = " ";
output = input.ToAlphaNumericString();  // output = ""

input = "lorem12345^^^&&**ipsum22$$";
output = input.ToAlphaNumericString();  // output = "lorem12345ipsum22"

input = " lorem\n 55 **   ipsum\n";
output = input.ToAlphaNumericString();  // output = "lorem55ipsum"

πŸ”™Back to the Full List of Features

ToHtml

//using Aqua.StringHelpers;

string input;
string output;

input = null;
output = input.ToHtml();  // output = null

input = "";
output = input.ToHtml();  // output = ""

input = " ";
output = input.ToHtml();  // output = ""

input = "lorem ipsum lorem\n ipsum\n";
output = input.ToHtml();  // output = "lorem ipsum lorem<br/> ipsum<br/>"

input = " lorem\n ipsum\n";
output = input.ToHtml();  // output = " lorem<br/> ipsum<br/>"

πŸ”™Back to the Full List of Features

ToAbbreviation

//using Aqua.StringHelpers;

string input;
string output;

input = null;
output = input.ToAbbreviation();  // output = null

input = "";
output = input.ToAbbreviation();  // output = ""

input = " ";
output = input.ToAbbreviation();  // output = " "

input = "lorem ipsum dolor lorem ipsum";
output = input.ToAbbreviation();  // output = "LIDLI"

input = "   lorem    ipsum   dolor lorem ipsum";
output = input.ToAbbreviation();  // output = "LIDLI"

πŸ”™Back to the Full List of Features

ToNcharAbbreviation

string input;
int n;          //Length of Abbreviation
string output;

input = null;
n = 3;
output = input.ToNcharAbbreviation(n);  // output = null

input = "";
n = 3;
output = input.ToNcharAbbreviation(n);  // output = ""

input = " ";
n = 3;
output = input.ToNcharAbbreviation(n);  // output = " "

input = "lorem ipsum dolor lorem ipsum";
n = 3;
output = input.ToNcharAbbreviation(n);  // output = "LID"

input = "   lorem    ipsum   dolor lorem ipsum";
n = 3;
output = input.ToNcharAbbreviation(n);  // output = "LID"

πŸ”™Back to the Full List of Features

ToHyperlink

//using Aqua.StringHelpers;

string input;
string output;

input = null;
output = input.ToHyperlink();  // output = null

input = "";
output = input.ToHyperlink();  // output = ""

input = " ";
output = input.ToHyperlink();  // output = ""

input = "www.wideitsolutions.co.uk";
output = input.ToHyperlink();  // output = "www.wideitsolutions.co.uk"

input = "http://www.wideitsolutions.co.uk";
output = input.ToHyperlink();  // output = "<a href=\"http://www.wideitsolutions.co.uk" target=\"_blank\">http://www.wideitsolutions.co.uk</a>"

πŸ”™Back to the Full List of Features

ToSentenceCase

//using Aqua.StringHelpers;

string input;
char s;         //Sentence seperator
string output;

input = null;
s = '.';
output = input.ToSentenceCase(s);  // output = null

input = "";
s = '.';
output = input.ToSentenceCase(s);  // output = ""

input = " ";
s = '.';
output = input.ToSentenceCase(s);  // output = ""

input = "lorem ipsum dolor";
s = '.';
output = input.ToSentenceCase(s);  // output = "Lorem ipsum dolor"

input = "lorem ipsum dolor. lorem. ipsum dolor";
s = '.';
output = input.ToSentenceCase(s);  // output = "Lorem ipsum dolor. Lorem. Ipsum dolor."

πŸ”™Back to the Full List of Features

ToBase64

//using Aqua.StringHelpers;

string input;
string output;

input = null;
output = input.ToBase64();  // output = null

input = "";
output = input.ToBase64();  // output = ""

input = " ";
output = input.ToBase64();  // output = "IA=="

input = "abc";
output = input.ToBase64();  // output = "YWJj"

input = "lorem ipsum dolor. lorem. ipsum dolor";
output = input.ToBase64();  // output = "bG9yZW0gaXBzdW0gZG9sb3IuIGxvcmVtLiBpcHN1bSBkb2xvcg=="

πŸ”™Back to the Full List of Features

ToSummarisedText

//using Aqua.StringHelpers;

string input;
int n;          //Length of Summary
bool d;         //Dots to be used at the end of summary text?
                //This is optional parameter , default is assigned false
string output;

input = null;
n = 15;
output = input.ToSummarisedText(n);    // output = null

input = "";
n = 15;
d = true;
output = input.ToSummarisedText(n,d);  // output = ""

input = " ";
n = 15;
d = true;
output = input.ToSummarisedText(n,d);  // output = " "

input = "abc";
n = 15;
d = true;
output = input.ToSummarisedText(n,d);  // output = "abc"

input = "lorem ipsum dolor. lorem. ipsum dolor";
n = 15;
d = true;
output = input.ToSummarisedText(n,d);  // output = "lorem ipsum dol..."

πŸ”™Back to the Full List of Features

ToSummarisedTextRight

//using Aqua.StringHelpers;

string input;
int n;          //Length of Summary
bool d;         //Dots to be used at the end of summary text?
                //This is optional parameter , default is assigned false
string output;

input = null;
n = 15;
output = input.ToSummarisedTextRight(n);  // output = null

input = "";
n = 15;
d = true;
output = input.ToSummarisedTextRight(n,d);  // output = ""

input = " ";
n = 15;
d = true;
output = input.ToSummarisedTextRight(n,d);  // output = " "

input = "abc";
n = 15;
d = true;
output = input.ToSummarisedTextRight(n,d);  // output = "abc"

input = "lorem ipsum dolor. lorem. ipsum dolor";
n = 15;
d = true;
output = input.ToSummarisedTextRight(n,d);  // output = "...em. ipsum dolor"

πŸ”™Back to the Full List of Features

ToCsvCompatible

//using Aqua.StringHelpers;

string input;
string output;

input = null;
output = input.ToCsvCompatible();  // output = null

input = "";
output = input.ToCsvCompatible();  // output = ""

input = " ";
output = input.ToCsvCompatible();  // output = "\" \""

input = "abc\n";
output = input.ToCsvCompatible();  // output = "\"abc\n\""

input = " lorem ipsum dolor, lorem; ipsum dolor";
output = input.ToCsvCompatible();  // output = "\" lorem ipsum dolor, lorem; ipsum dolor\""

πŸ”™Back to the Full List of Features

ToUkTelephoneFormat

//using Aqua.StringHelpers;

string input;
string output;

input = null;
output = input.ToUkTelephoneFormat();  // output = null

input = "";
output = input.ToUkTelephoneFormat();  // output = ""

input = " ";
output = input.ToUkTelephoneFormat();  // output = " "

input = "07777777777";
output = input.ToUkTelephoneFormat();  // output = "07777 777777"

input = "0111111111";
output = input.ToUkTelephoneFormat();  // output = "01111 11111"

πŸ”™Back to the Full List of Features

ToUpperCaseCanonicalGuid

//using Aqua.StringHelpers;

Guid input;
string output;

input = Guid.Empty;
output = input.ToUpperCaseCanonicalGuid();  // output = "00000000000000000000000000000000"

input = new Guid("{4A6B75A8-F2A3-4F8F-AAE6-224B5CBFE44E}");
output = input.ToUpperCaseCanonicalGuid();  // output = "4A6B75A8F2A34F8FAAE6224B5CBFE44E"

input = new Guid("{4a6b75a8-f2a3-4f8f-aae6-224b5cbfe44e}");
output = input.ToUpperCaseCanonicalGuid();  // output = "4A6B75A8F2A34F8FAAE6224B5CBFE44E"

input = Guid.NewGuid();
output = input.ToUpperCaseCanonicalGuid();  // output = "4A6B75A8F2A34F8FAAE6224B5CBFE44E"

πŸ”™Back to the Full List of Features

ToDoubleQuotedString

//using Aqua.StringHelpers;

string input;
string output;

input = null;
output = input.ToDoubleQuotedString();  // output = null

input = "";
output = input.ToDoubleQuotedString();  // output = ""

input = " ";
output = input.ToDoubleQuotedString();  // output = " "

input = "lorem ipsum dolor";
output = input.ToDoubleQuotedString();  // output = "\"lorem ipsum dolor\""

input = "\"lorem ipsum dolor\"";
output = input.ToDoubleQuotedString();  // output = "\"\"lorem ipsum dolor\"\""

πŸ”™Back to the Full List of Features

ToStringArrayFromDelimitedString

//using Aqua.StringHelpers;

string input;
char d;           // delimiter
string[] output;

input = null;
d = ',';
output = input.ToStringArrayFromDelimitedString(d);  // output = {string[0]}

input = "";
d = ',';
output = input.ToStringArrayFromDelimitedString(d);  // output = {string[0]}

input = " ";
d = ',';
output = input.ToStringArrayFromDelimitedString(d);  // output = {string[0]}

input = "lorem; ipsum; dolor";
d = ';';
output = input.ToStringArrayFromDelimitedString(d);  // output = string[3]{"lorem", "ipsum", "dolor"}

input = "lorem, ipsum, dolor";
d = ',';
output = input.ToStringArrayFromDelimitedString(d);  // output = string[3]{"lorem", "ipsum", "dolor"}

πŸ”™Back to the Full List of Features

ToUrlFriendly

//using Aqua.StringHelpers;

string input;
string output;

input = null;
output = input.ToUrlFriendly();  // output = null

input = "";
output = input.ToUrlFriendly();  // output = ""

input = " ";
output = input.ToUrlFriendly();  // output = " "

input = "lorem ipsum dolor";
output = input.ToUrlFriendly();  // output = "loremipsumdolor"

input = "\"lorem ipsum dolor";
output = input.ToUrlFriendly();  // output = "loremipsumdolor"

πŸ”™Back to the Full List of Features

ToCanonicalGuid

//using Aqua.StringHelpers;

Guid input;
string output;

input = Guid.Empty;
output = input.ToCanonicalGuid();  // output = "00000000000000000000000000000000"

input = new Guid("{4A6B75A8-F2A3-4F8F-AAE6-224B5CBFE44E}");
output = input.ToCanonicalGuid();  // output = "4a6b75a8f2a34f8faae6224b5cbfe44e"

input = new Guid("{4a6b75a8-f2a3-4f8f-aae6-224b5cbfe44e}");
output = input.ToCanonicalGuid();  // output = "4a6b75a8f2a34f8faae6224b5cbfe44e"

input = Guid.NewGuid();
output = input.ToCanonicalGuid();  // output = "4a6b75a8f2a34f8faae6224b5cbfe44e"

πŸ”™Back to the Full List of Features

ToDistinctListOfWords

//using Aqua.StringHelpers;

string input;
List<string> output;

input = null;
output = input.ToDistinctListOfWords();  // output = List<string>{}

input = "";
output = input.ToDistinctListOfWords();  // output = List<string>{}

input = " ";
output = input.ToDistinctListOfWords();  // output = List<string>{}

input = "lorem ipsum dolor ipsum dolor";
output = input.ToDistinctListOfWords();  // output = List<string>{"dolor", "ipsum", "lorem"}

input = "\"lorem ipsum dolor ipsum dolor";
output = input.ToDistinctListOfWords();  // output = List<string>{"dolor", "ipsum", "lorem"}

πŸ”™Back to the Full List of Features

To16ByteSaltedHash

//using Aqua.StringHelpers;

string input;
string output;

input = "";
output = input.To16ByteSaltedHash();  // output = "XptBgEyQ8rVKKYnO+0MzWTV2oQHybB3yqpvRbZzSxAkmcV5e"

input = " ";
output = input.To16ByteSaltedHash();  // output = "wbasNJXqc6dcZrEtjIw31aSKg0A1dvab25lRKOqhDHnk9wAz"

input = "abcd";
output = input.To16ByteSaltedHash();  // output = "i6H3KFHsCR/OYni4EG57FCrUX/r3swloE16Ma0lUerdOYrsW"

input = "abcd12345";
output = input.To16ByteSaltedHash();  // output = "ILUxWoR6iWnBxkqs+E38sWJZtU02J42HQ1gtAMcOIIP3p90u"

πŸ”™Back to the Full List of Features

CapitaliseEachWord

//using Aqua.StringHelpers;

string input;
string output;

input = null;
output = input.CapitaliseEachWord();  // output = null

input = "";
output = input.CapitaliseEachWord();  // output = ""

input = " ";
output = input.CapitaliseEachWord();  // output = " "

input = "lorem ipsum dolor";
output = input.CapitaliseEachWord();  // output = "Lorem Ipsum Dolor"

input = "lorem ipsum dolor.";
output = input.CapitaliseEachWord();  // output = "Lorem Ipsum Dolor."

πŸ”™Back to the Full List of Features

AddToBeginingIfMissed

//using Aqua.StringHelpers;

string input;
string a;        //The value to be added
string output;

input = null;
a = "The ";
output = input.AddToBeginingIfMissed(a);  // output = "The "

input = "";
a = "The ";
output = input.AddToBeginingIfMissed(a);  // output = "The "

input = " ";
a = "The ";
output = input.AddToBeginingIfMissed(a);  // output = "The "

input = "The lorem ipsum dolor.";
a = "The ";
output = input.AddToBeginingIfMissed(a);  // output = "The lorem ipsum dolor."

input = "lorem ipsum dolor.";
a = "The ";
output = input.AddToBeginingIfMissed(a);  // output = "The Lorem Ipsum Dolor."

πŸ”™Back to the Full List of Features

DecodeBase64

//using Aqua.StringHelpers;

string input;
string output;

input = null;
output = input.DecodeBase64();  // output = null

input = "";
output = input.DecodeBase64();  // output = ""

input = "IA==";
output = input.DecodeBase64();  // output = " "

input = "YWJj";
output = input.DecodeBase64();  // output = "abc"

input = "bG9yZW0gaXBzdW0gZG9sb3IuIGxvcmVtLiBpcHN1bSBkb2xvcg==";
output = input.DecodeBase64();  // output = "lorem ipsum dolor. lorem. ipsum dolor"

πŸ”™Back to the Full List of Features

CountStringOccurrences

//using Aqua.StringHelpers;

string input;
string s;       //Search string
bool c;         //Is Case Sensitive Search? - Default is true
int output;

input = null;
s = "em";
output = input.CountStringOccurrences(s);  // output = 0

input = "";
s = "em";
output = input.CountStringOccurrences(s);  // output = 0

input = " ";
s = "em";
output = input.CountStringOccurrences(s);  // output = 0

input = "lorEM ipsum dolor. lorem ipsum dolor. lorem ipsum dolor.";
s = "em";
output = input.CountStringOccurrences(s);  // output = 2

input = "LorEM ipsum dolor. lorEm ipsum dolor. loreM ipsum dolor.";
s = "em";
c = false;
output = input.CountStringOccurrences(s, c);  // output = 3

πŸ”™Back to the Full List of Features

FindAllDigits

//using Aqua.StringHelpers;

string input;
string output;

input = null;
output = input.FindAllDigits();  // output = null

input = "";
output = input.FindAllDigits();  // output = ""

input = " ";
output = input.FindAllDigits();  // output = ""

input = "6lorem65";
output = input.FindAllDigits();  // output = "665"

input = "lorem5 6 7 % 9 ipsum dolor.";
output = input.FindAllDigits();  // output = "5679"

πŸ”™Back to the Full List of Features

FindNumberOfDigits

//using Aqua.StringHelpers;

string input;
int output;

input = null;
output = input.FindNumberOfDigits();  // output = 0

input = "";
output = input.FindNumberOfDigits();  // output = 0

input = " ";
output = input.FindNumberOfDigits();  // output = 0

input = "6lorem65";
output = input.FindNumberOfDigits();  // output = 3

input = "lorem5 6 7 % 9 ipsum dolor.";
output = input.FindNumberOfDigits();  // output = 4

πŸ”™Back to the Full List of Features

CorrectPathSlashes

//using Aqua.StringHelpers;

string input;
string output;

input = null;
output = input.CorrectPathSlashes();  // output = null

input = "";
output = input.CorrectPathSlashes();  // output = ""

input = " ";
output = input.CorrectPathSlashes();  // output = " "

input = "c:/test";
output = input.CorrectPathSlashes();  // output = "c:\\test"

input = "c:/test/test.pdf";
output = input.CorrectPathSlashes();  // output = "c:\\test\\test.pdf"

πŸ”™Back to the Full List of Features

CenterAligned

//using Aqua.StringHelpers;

string input;
int b;          //Block size
string output;

input = null;
b = 20;
output = input.CenterAligned(b);  // output = null

input = "";
b = 20;
output = input.CenterAligned(b);  // output = ""

input = " ";
b = 20;
output = input.CenterAligned(b);  // output = "                    "

input = "lorem";
b = 20;
output = input.CenterAligned(b);  // output = "        lorem       "

input = "lorem ipsum dolor";
b = 10;
output = input.CenterAligned(b);  // output = "lorem ipsum dolor"

πŸ”™Back to the Full List of Features

HowManyOccurrences

//using Aqua.StringHelpers;

string input;
char c;          //Search character
string s;          //Search string
int output;

input = null;
c = 'A';
s = "AA";
output = input.HowManyOccurrences(c);  // output = 0
output = input.HowManyOccurrences(s);  // output = 0

input = "";
c = 'A';
s = "AA";
output = input.HowManyOccurrences(c);  // output = 0
output = input.HowManyOccurrences(c);  // output = 0

input = " ";
c = 'A';
s = "AA";
output = input.HowManyOccurrences(c);  // output = 0   
output = input.HowManyOccurrences(c);  // output = 0

input = "lorem";
c = 'l';
s = "lo";
output = input.HowManyOccurrences(c);  // output = 1
output = input.HowManyOccurrences(c);  // output = 1

input = "lorem ipsum dolor";
c = 'l';
s = "lo";
output = input.HowManyOccurrences(c);  // output = 2
output = input.HowManyOccurrences(c);  // output = 2

πŸ”™Back to the Full List of Features

CleanNonNumericChars

//using Aqua.StringHelpers;

string input;
string output;

input = null;
output = input.CleanNonNumericChars();  // output = null

input = "";
output = input.CleanNonNumericChars();  // output = ""

input = " ";
output = input.CleanNonNumericChars();  // output = ""

input = "lorem";
output = input.CleanNonNumericChars();  // output = ""

input = "lorem 4 ipsum 567 8dolor";
output = input.CleanNonNumericChars();  // output = "45678"

πŸ”™Back to the Full List of Features

NullIfEqualTo

//using Aqua.StringHelpers;

string input;
string s;       //Search string
string output;

input = null;
s = "lorem";
output = input.NullIfEqualTo(s);  // output = null

input = "";
s = "lorem";
output = input.NullIfEqualTo(s);  // output = ""

input = " ";
s = "lorem";
output = input.NullIfEqualTo(s);  // output = " "

input = "lorem";
s = "lorem";
output = input.NullIfEqualTo(s);  // output = null

input = "lorem ipsum dolor";
s = "lorem";
output = input.NullIfEqualTo(s);  // output = "lorem ipsum dolor"

πŸ”™Back to the Full List of Features

GetTotalNumberOfWords

//using Aqua.StringHelpers;

string input;
int output;

input = null;
output = input.GetTotalNumberOfWords();  // output = 0

input = "";
output = input.GetTotalNumberOfWords();  // output = 0

input = " ";
output = input.GetTotalNumberOfWords();  // output = 0

input = "lorem";
output = input.GetTotalNumberOfWords();  // output = 1

input = "lorem ipsum dolor";
output = input.GetTotalNumberOfWords();  // output = 3

πŸ”™Back to the Full List of Features

GetTotalNumberOfCharachters

//using Aqua.StringHelpers;

string input;
bool c;         //Clean the string before counting the characters? default is false
int output;

input = null;
c = false;
output = input.GetTotalNumberOfCharachters();  // output = 0

input = "";
c = false;
output = input.GetTotalNumberOfCharachters();  // output = 0

input = " ";
c = false;
output = input.GetTotalNumberOfCharachters();  // output = 1

input = "lorem  ";
c = true;
output = input.GetTotalNumberOfCharachters(c);  // output = 5

input = "lorem ipsum       dolor";
c = true;
output = input.GetTotalNumberOfCharachters(c);  // output = 17

πŸ”™Back to the Full List of Features

GetFirstLongestWord

//using Aqua.StringHelpers;

string input;
string output;

input = null;
output = input.GetFirstLongestWord();  // output = null

input = "";
output = input.GetFirstLongestWord();  // output = ""

input = " ";
output = input.GetFirstLongestWord();  // output = " "

input = "lorem";
output = input.GetFirstLongestWord();  // output = "lorem"

input = "lorem ipsum dolor";
output = input.GetFirstLongestWord();  // output = "lorem"

πŸ”™Back to the Full List of Features

GetFirstShortestWord

//using Aqua.StringHelpers;

string input;
string output;

input = null;
output = input.GetFirstShortestWord();  // output = null

input = "";
output = input.GetFirstShortestWord();  // output = ""

input = " ";
output = input.GetFirstShortestWord();  // output = " "

input = "lorem";
output = input.GetFirstShortestWord();  // output = "lorem"

input = "lorem ipsum dolor";
output = input.GetFirstShortestWord();  // output = "lorem"

πŸ”™Back to the Full List of Features

GetTotalNumberOfLines

//using Aqua.StringHelpers;

string input;
int output;

input = null;
output = input.GetTotalNumberOfLines();  // output = 0

input = "";
output = input.GetTotalNumberOfLines();  // output = 0

input = " ";
output = input.GetTotalNumberOfLines();  // output = 0

input = "lorem\n";
output = input.GetTotalNumberOfLines();  // output = 2

input = "\nlorem \n\nipsum\n dolor";
output = input.GetTotalNumberOfLines();  // output = 5

πŸ”™Back to the Full List of Features

GetUrlDomain

//using Aqua.StringHelpers;

string input;
string output;

input = null;
output = input.GetUrlDomain();  // output = null

input = "";
output = input.GetUrlDomain();  // output = ""

input = " ";
output = input.GetUrlDomain();  // output = ""

input = "http://www.wideitsolutions.co.uk/test/test";
output = input.GetUrlDomain();  // output = "http://www.wideitsolutions.co.uk"

input = "http://dev.wideitsolutions.co.uk/test/test";
output = input.GetUrlDomain();  // output = "http://dev.wideitsolutions.co.uk"

πŸ”™Back to the Full List of Features

GetFileExtension

//using Aqua.StringHelpers;

string input;
string output;

input = null;
output = input.GetFileExtension();  // output = null

input = "";
output = input.GetFileExtension();  // output = ""

input = " ";
output = input.GetFileExtension();  // output = ""

input = "c:\\test.pdf";
output = input.GetFileExtension();  // output = "pdf"

input = "http://dev.wideitsolutions.co.uk/test/test/test.pdf";
output = input.GetFileExtension();  // output = "pdf"

πŸ”™Back to the Full List of Features

AddToEndIfMissed

//using Aqua.StringHelpers;

string input;
string a;        //The value to be added
string output;

input = null;
a = "...";
output = input.AddToEndIfMissed(a);  // output = "..."

input = "";
a = "...";
output = input.AddToEndIfMissed(a);  // output = "..."

input = " ";
a = "...";
output = input.AddToEndIfMissed(a);  // output = "..."

input = "The lorem ipsum dolor";
a = "...";
output = input.AddToEndIfMissed(a);  // output = "The lorem ipsum dolor..."

input = "lorem ipsum dolor";
a = "...";
output = input.AddToEndIfMissed(a);  // output = "lorem Ipsum Dolor..."

πŸ”™Back to the Full List of Features

GenerateLoremIpsumString

//using Aqua.StringHelpers;

string output;
int minWords;       //Minumum number of words in output
int maxWords;       //Maximum number of words in the output
int minSentences;   //Minumum number of sentences in the output
int maxSentences;   //Maximum number of sentences in the output
int numParagraphs;  //The number of paragraphs to be in the output

minWords = 1;
maxWords = 100;
minSentences = 1;
maxSentences = 10;
numParagraphs = 1;
output = StringHelpers.GenerateLoremIpsumString(minWords, maxWords, minSentences, maxSentences, numParagraphs);
// output = "tincidunt tincidunt diam amet diam sit. aliquam euismod diam adipiscing aliquam aliquam."
            
minWords = 1;
maxWords = 100;
minSentences = 1;
maxSentences = 10;
numParagraphs = 2;
output = StringHelpers.GenerateLoremIpsumString(minWords, maxWords, minSentences, maxSentences, numParagraphs);
// output =
//"consectetuer nibh magna euismod dolor ut amet aliquam diam consectetuer magna dolor 
// ipsum sed. aliquam dolor dolore ipsum nibh nibh nonummy nibh aliquam nonummy ut laoreet 
// dolore sed. adipiscing sed dolore sed elit magna euismod lorem magna magna consectetuer tincidunt 
// dolore dolor. dolore euismod tincidunt diam diam nonummy ut laoreet nonummy diam tincidunt lorem euismod ut. 
// tincidunt adipiscing aliquam elit magna dolore euismod ipsum diam sed ut amet laoreet aliquam. 
// consectetuer erat dolore aliquam laoreet elit ut adipiscing magna consectetuer consectetuer adipiscing 
// tincidunt nonummy. magna adipiscing laoreet elit amet aliquam adipiscing nonummy erat magna dolore lorem 
// diam ut. sit amet laoreet amet laoreet dolore nonummy nibh tincidunt ut amet amet erat elit. diam tincidunt 
// ipsum nonummy dolor ipsum sit dolor tincidunt adipiscing erat dolore euismod laoreet. lorem aliquam dolor 
// laoreet magna erat dolor tincidunt diam lorem nibh magna lorem adipiscing. tincidunt ipsum dolor lorem 
// aliquam erat ipsum adipiscing laoreet consectetuer magna sed nibh lorem. nibh sed consectetuer aliquam amet 
// laoreet nibh ut nibh diam adipiscing erat amet laoreet. sit ipsum erat amet lorem magna sed nibh sit erat 
// aliquam euismod tincidunt ut. dolor magna magna diam sed dolor dolor lorem laoreet euismod tincidunt 
// consectetuer laoreet aliquam. "

πŸ”™Back to the Full List of Features

GenerateLoremIpsumHtmlSafe

//using Aqua.StringHelpers;

string output;
int minWords;       //Minumum number of words in output
int maxWords;       //Maximum number of words in the output
int minSentences;   //Minumum number of sentences in the output
int maxSentences;   //Maximum number of sentences in the output
int numParagraphs;  //The number of paragraphs to be in the output

minWords = 1;
maxWords = 100;
minSentences = 1;
maxSentences = 10;
numParagraphs = 1;
output = StringHelpers.GenerateLoremIpsumHtmlSafe(minWords, maxWords, minSentences, maxSentences, numParagraphs);
// output = "<p>tincidunt tincidunt diam amet diam sit. aliquam euismod diam adipiscing aliquam aliquam.</p>"
            
minWords = 1;
maxWords = 100;
minSentences = 1;
maxSentences = 10;
numParagraphs = 2;
output = StringHelpers.GenerateLoremIpsumHtmlSafe(minWords, maxWords, minSentences, maxSentences, numParagraphs);
// output =
// "<p>
// consectetuer nibh magna euismod dolor ut amet aliquam diam consectetuer magna dolor 
// ipsum sed. aliquam dolor dolore ipsum nibh nibh nonummy nibh aliquam nonummy ut laoreet 
// dolore sed. adipiscing sed dolore sed elit magna euismod lorem magna magna consectetuer tincidunt 
// dolore dolor. dolore euismod tincidunt diam diam nonummy ut laoreet nonummy diam tincidunt lorem euismod ut. 
// tincidunt adipiscing aliquam elit magna dolore euismod ipsum diam sed ut amet laoreet aliquam.
// <p>
// </p>
// consectetuer erat dolore aliquam laoreet elit ut adipiscing magna consectetuer consectetuer adipiscing 
// tincidunt nonummy. magna adipiscing laoreet elit amet aliquam adipiscing nonummy erat magna dolore lorem 
// diam ut. sit amet laoreet amet laoreet dolore nonummy nibh tincidunt ut amet amet erat elit. diam tincidunt 
// ipsum nonummy dolor ipsum sit dolor tincidunt adipiscing erat dolore euismod laoreet. lorem aliquam dolor 
// laoreet magna erat dolor tincidunt diam lorem nibh magna lorem adipiscing. tincidunt ipsum dolor lorem 
// aliquam erat ipsum adipiscing laoreet consectetuer magna sed nibh lorem. nibh sed consectetuer aliquam amet 
// laoreet nibh ut nibh diam adipiscing erat amet laoreet. sit ipsum erat amet lorem magna sed nibh sit erat 
// aliquam euismod tincidunt ut. dolor magna magna diam sed dolor dolor lorem laoreet euismod tincidunt 
// consectetuer laoreet aliquam. 
// </p>"

πŸ”™Back to the Full List of Features

Coalesce

//using Aqua.StringHelpers;
string[] input;
string output;

input = new[] { null, "", "lorem", "lorem ipsum dolor", "dolor" };
output = StringHelpers.Coalesce(input); // output = ""

input = new[] { null, "lorem", "lorem ipsum dolor", "dolor" };
output = StringHelpers.Coalesce(input); // output = "lorem"

input = new[] { "lorem", null, "", "lorem ipsum dolor", "dolor" };
output = StringHelpers.Coalesce(input); // output = "lorem"

πŸ”™Back to the Full List of Features

GetFirstNullOrEmpty

//using Aqua.StringHelpers;
string[] input;
string output;

input = new[] { "lorem", "", "lorem", "lorem ipsum dolor", "dolor" };
output = StringHelpers.GetFirstNullOrEmpty(input); // output = ""

input = new[] { null, "lorem", "lorem ipsum dolor", "dolor" };
output = StringHelpers.GetFirstNullOrEmpty(input); // output = "null"

input = new[] { "lorem", null, "", "lorem ipsum dolor", "dolor" };
output = StringHelpers.GetFirstNullOrEmpty(input); // output = "null"

πŸ”™Back to the Full List of Features

Build and Test

TODO: Describe and show how to build your code and run the tests.

Contribute

TODO: Explain how other users and developers can contribute to make your code better.

If you want to learn more about creating good readme files then refer the following guidelines. You can also seek inspiration from the below readme files:

About

Aqua String Helpers is an Open Source and Free Software package consists of a set of utilities that facilitate the job of the developer and save his time while dealing with a string. Please feel free to fork and contribute

Resources

Readme

License

MIT, MIT licenses found

Licenses found

MIT
License
MIT
License.md
Activity

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

1 tags

Packages

No packages published

Languages

  • C# 100.0%