ByteDev.Strings 3.0.0

ByteDev.Strings

Set of string extension methods.

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.

Code

The repo can be cloned from git bash:

git clone https://github.com/ByteDev/ByteDev.Strings

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
• ToTitleCase
• ToLines
• ToByteArray
• ToIntOrDefault
• ToLongOrDefault
• ToDateTimeOrDefault
• ToEnum

CaseConverter

CaseConverter has the following methods:

• ToCamelCase
• ToKebabCase
• ToPascalCase
• ToSnakeCase
• ToSnakeUpperCase

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

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

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

ToStringHelper

The assembly also contains the type ToStringHelper 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()
    {
        var helper = new ToStringHelper("<null>");

        return helper.ToString(nameof(Name), Name) + ", " +
                helper.ToString(nameof(Age), Age) + ", " +
                helper.ToString(nameof(Address), Address);
    }
}

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

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