ByteDev.Strings 4.1.0

ByteDev.Strings

Set of string related extension methods and classes.

Installation

ByteDev.Strings has been written as a .NET Standard 2.0 library, so you can consume it from a .NET Core or .NET Framework 4.6.1 (or greater) application.

ByteDev.Strings is hosted as a package on nuget.org. To install from the Package Manager Console in Visual Studio run:

Install-Package ByteDev.Strings

Further details can be found on the nuget page.

Release Notes

Releases follow semantic versioning.

Full details of the release notes can be viewed on GitHub.

Usage

String Extensions

To use any extension methods simply reference the ByteDev.Strings namespace.

Assembly contains string extension methods:

• AddPrefix
• AddSuffix
• ContainsIgnoreCase
• CountOccurrences
• FormatWith
• IsDigit
• IsDigits
• IsEmpty
• IsEmailAddress
• IsFalse
• IsGuid
• IsHttpUrl
• IsIpAddress
• IsLengthBetween
• IsLetters
• IsLowerCase
• IsNullOrEmpty
• IsNullOrWhitespace
• IsNotNullOrEmpty
• IsNumeric
• IsUpperCase
• IsTime
• IsTrue
• IsXml
• Left
• LeftWithEllipsis
• LeftWithInnerEllipsis
• Mask
• Pluralize
• Remove
• RemoveStartsWith
• RemoveEndsWith
• RemoveBracketedText
• RemoveWhiteSpace
• Repeat
• ReplaceFirst
• ReplaceLast
• ReplaceToken
• Reverse
• Right
• SafeLength
• SafeSubstring
• ToBool
• ToBoolOrDefault
• ToByteArray
• ToCsv
• ToDateTime
• ToDateTimeOrDefault
• ToEnum
• ToLines
• ToInt
• ToIntOrDefault
• ToLong
• ToLongOrDefault
• ToUri
• ToTitleCase

CaseConverter

To use CaseConverter reference the ByteDev.Strings.Case namespace.

CaseConverter has the following methods:

• ToCamelCase
• ToKebabCase
• ToPascalCase
• ToSnakeCase
• ToSnakeUpperCase

string s1 = CaseConverter.ToCamelCase("snake_case", CaseType.SnakeCase);   // "snakeCase"

string s2 = CaseConverter.ToPascalCase("kebab-case", CaseType.KebabCase);  // "KebabCase"

bool isPascalCase = s2.IsPascalCase();   // true

There are also a number of case related string extension methods:

• IsCamelCase
• IsKebabCase
• IsPascalCase
• IsSnakeCase
• IsSnakeUpperCase
• IsCaseType

StringCommands

To use the various string commands reference the ByteDev.Strings.StringCommands namespace.

var c1 = new CaseToLowerCommand().SetValue("John Smith");
var c2 = new CopyPasteCommand(0, 4, 0).SetValue("John Smith");

IStringCommandInvoker invoker = new StringCommandInvoker();

invoker.SetCommands(c1, c2);
invoker.Invoke();

// c1.Result == "john smith" 
// c2.Result == "JohnJohn Smith"

Commands can also be chained together using the StringChainedCommand:

// Note: we don't have to call SetValue on each command just on StringChainedCommand
// as this will provide the initial value.

var commands = new List<StringCommand>
{
    new CaseToLowerCommand(),
    new InsertCommand(100, " lives in England."),
    new CutPasteCommand(5, 5, 0)
};

var c1 = new StringChainedCommand(commands).SetValue("John Smith");

IStringCommandInvoker invoker = new StringCommandInvoker();

invoker.SetCommands(c1);
invoker.Invoke();

// command.Result == "smithjohn  lives in England."

ToStringBuilder

The assembly also contains the type ToStringBuilder to help return string representations of an object when overriding it's ToString method.

public class MyClass
{
    public string Name => "John";

    public string Age => null;

    public IEnumerable<string> Address => new List<string>
    {
        "123 Highstreet",
        "London",
        "UK"
    };

    public override string ToString()
    {
        return new ToStringBuilder()
            .WithNullValue("<null>")
            .WithStringQuoteChar('\'')
            .With(nameof(Name), Name)
            .With(nameof(Age), Age)
            .With(nameof(Address), Address)
            .Build();
    }
}

// ...
string s = new MyClass().ToString();

// s == "Name: 'John', Age: <null>, Address: { '123 Highstreet', 'London', 'UK' }"