MutableStringLibrary 1.1.23

MutableStringLibrary

A simple wrapper around the .NET String class that allows for easy value comparison and modification, with or without case sensitivity.

NuGet: Install-Package MutableStringLibrary

Read the source code here.

For analyzing a string:

• Has checks for a substring in a string.
• Is compares the string value with the value of another string.
• IsLimitedToCharacters checks if the characters of a string are limited to a given set of characters.

For modifying a string:

• CutAt removes a given section from the string and returns the removed part.
• CutBeginningAt returns the characters until the given position and keeps the remainder.
• CutEntAt returns the characters efter the given position and keeps the beginning.
• LimitToCharacters removes any character that is not represented in a given set of characters.
• MiddleTrim changes any whitespaces to a single space.
• Reset sets the value to the default value, depending on the DefaultsToNull flag.

Flags:

• AutoTrim
• DefaultsToNull
• IgnoreCase

For modifying a string list:

• CutAt removes a given section from the string and returns the removed part.
• CutBeginningAt returns the characters until the given position and keeps the remainder.
• CutEntAt returns the characters efter the given position and keeps the beginning.

Examples: Functions for modifying a string

These functions modify the string object and returns the difference.

CutBeginningAt

The function CutBeginningAt removes the beginning of a string and returns the removed part as a mutable string with the same flags as the original.

Basic example:

var s1 = new MutableString("Paul Stanley");
var s2 = s1.CutBeginningAt(5);
Console.WriteLine(s2.Value); // Paul
Console.WriteLine(s1.Value); // Stanley

Advanced example:

class PositionFinder : IPositionFinder
{
    public int Find(MutableString value) =>
        5;
}

var s1 = new MutableString("Paul Stanley");
var s2 = s1.CutBeginningAt(new PositionFinder());
Console.WriteLine(s2.Value); // Paul
Console.WriteLine(s1.Value); // Stanley

CutEndAt

The function CutEndAt removes the end of a string and returns the removed part as a mutable string with the same flags as the original.

Basic example:

var s1 = new MutableString("Paul Stanley");
var s2 = s1.CutEndAt(5);
Console.WriteLine(s2.Value); // Stanley
Console.WriteLine(s1.Value); // Paul

Advanced example:

class PositionFinder : IPositionFinder
{
    public int Find(MutableString value) =>
        5;
}

var s1 = new MutableString("Paul Stanley");
var s2 = s1.CutEndAt(new PositionFinder());
Console.WriteLine(s2.Value); // Stanley
Console.WriteLine(s1.Value); // Paul

MiddleTrim

Replaces any whitespaces with a single space.

Example:

var x = new MutableString("abc   123");
Assert.True(s.MiddleTrim()); // Returns true if string is affected
Assert.True("abc 123");