CommonNetFuncs.Core v4.0.15 — nugetz

//Fill the Name and Address property using async tasks
Person person = new();

//AsyncIntString helper class is used for int and string types since they can't otherwise be gotten asynchronously like this
AsyncIntString personPhotoLocation = new();

person.Id = 1;
List<Task> tasks =
[
    person.ObjectUpdate(nameof(Person.Name), GetPersonNameByIdAsync(person.Id)), //Fills person.Name with results of GetPersonNameByIdAsync(person.Id)

    person.ObjectUpdate(nameof(Person.Address), GetPersonAddressByIdAsync(person.Id)), //Fills person.Address with results of GetPersonAddressByIdAsync(person.Id)

    personPhotoLocation.ObjectUpdate(nameof(AsyncIntString.AsyncString), GetPersonPhotoLocationById(person.Id)) //Fills personPhotoLocation.AsyncString with the results of GetPersonPhotoLocationById(person.Id)
]
await Task.WhenAll(tasks);

Usage Examples

AnyFast

Used to address issue CA1860 where it suggests using .Count for performance in an easier to type extension method

bool x = collection?.Any() == true;
//Or
collection?.Count > 0;
//Becomes
bool x = collection.AnyFast();

AddDictionaryItem & AddDictionaryItems

Used to directly TryAdd a KeyValuePair object(s) to a dictionary. Does nothing if add fails

KeyValuePair<string, string> JsonContentHeader = new("Content-Type", "application/json");

//Single addition
ConcurrentDictionary<string, string>? httpHeaders = [];
httpHeaders.AddDictionaryItem(JsonContentHeader);

//Add multiples
List<KeyValuePair<string, string>> keyValuePairs = [new("Accept-Encoding", "br"), new("Accept-Encoding", "gzip")];
httpHeaders.AddDictionaryItems(keyValuePairs);

AddRange & AddRangeParallel

Add multiple items to a collection at once, optionally in parallel.

List<int> numbers = [1, 2, 3];
numbers.AddRange([4, 5, 6]); // [1, 2, 3, 4, 5, 6]
//Or
numbers.AddRangeParallel([4, 5, 6]); // [1, 2, 3, 4, 5, 6]

SetValue & SetValueParallel

Set all items in a collection to a specific value, optionally in parallel.

int[,] array = new int[,] { { 1, 2 }, { 3, 4 } };
array.SetValue((arr, indices) => arr.SetValue(((int)arr.GetValue(indices)!) * 2, indices)); //  { 2, 4 }, { 6, 8 }

var people = new List<Person> { new() { Name = "Nick", Age = 32, NameAge = null }, new() { Name = "John", Age = 40, NameAge = null } };
names.SetValue(x => {
    x.Age++;
    NameAge = x.Name + x.Age.ToString();
}); // NameAge will be Nick33 and John41

SelectNonEmpty

Select only non-empty + non-null strings from a collection.

var nonEmpty = new[] { "a", "", "b", null }.SelectNonEmpty(); // ["a", "b"]

SelectNonNull

Select only non-null items from a collection.

var nonNull = new string?[] { "a", "", "b", null }.SelectNonNull(); // ["a", "", "b"]

SingleToList

Wrap a single object in a list.

var list = 42.SingleToList(); // [42]

GetObjectByPartial

Find an object in a collection by matching non-null properties.

var people = new List<Person> { new() { Name = "Nick", Age = 32 }, new() { Name = "John", Age = 40 } };
var result = people.GetObjectByPartial(new Person() { Name = "Nick" ); // Person with Name "Nick"

ToList

Convert DataTable to a List.

using DataTable dataTable = new();
dataTable.Columns.Add(nameof(TestClass.Id), typeof(int));
dataTable.Columns.Add(nameof(TestClass.Name), typeof(string));

dataTable.Rows.Add(1, "test1");
dataTable.Rows.Add(2, "test2");

List<TestClass?> result = dataTable.ToList<TestClass>(); // [{ Id = 1, Name = "test1"}, { Id = 2, Name = "test2"}]

ToListParallel

Convert a DataTable to a List in parallel.

using DataTable dataTable = new();
dataTable.Columns.Add(nameof(TestClass.Id), typeof(int));
dataTable.Columns.Add(nameof(TestClass.Name), typeof(string));

dataTable.Rows.Add(1, "test1");
dataTable.Rows.Add(2, "test2");
List<TestClass?> result = dataTable.ToListParallel<TestClass>(); // [{ Id = 1, Name = "test1"}, { Id = 2, Name = "test2"}]

ToDataTable

Convert a collection to a DataTable.

List<Person> people = [new() { Name = "Nick" }];
using DataTable table = people.ToDataTable(); // DataTable object containing People

ToDataTableReflection (Obsolete)

Convert a collection to a DataTable using reflection.

List<Person> people = [new() { Name = "Nick" }];
using DataTable table = people.ToDataTableReflection(); // DataTable object containing People

CombineExpressions

Combine multiple expressions into one.

Expression<Func<Person, bool>>[] expressions = [x => x.Age > 18, x => x.Name.StartsWith("N")];
var combinedExpression = CombineExpressions(expressions); // combinedExpression will do both > 18 and Name starts with "N"

StringAggProps

Aggregate string properties of objects.

List<Person> collection = new()
{
    new Person { Id = 1, Name = "Nick", Description = "desc1" },
    new Person { Id = 1, Name = "John", Description = "desc2" },
    new Person { Id = 1, Name = "Chris", Description = "Desc1" }
};
List<Person> aggregatedCollection = people.StringAggProps("Name", "Description"); // [{ Id = 1, Name = Nick;John;Chris, Description = "desc1;desc2" }]

IndexOf

Get the index of an item in a collection.

List<string> list = ["a", "b", "c"];
int idx = list.IndexOf("b"); // 1

IsIn

Check if a given value is valid for an enum.

public enum TestEnum
{
    Monday = DayOfWeek.Monday,
    Tuesday = DayOfWeek.Tuesday,
    Wednesday = DayOfWeek.Wednesday,
    Thursday = DayOfWeek.Thursday,
    Friday = DayOfWeek.Friday
}

bool result = "Monday".IsIn<TestEnum>(); // True
bool result = "Not A Day".IsIn<TestEnum>(); // False

GetCombinations

Get all unique combinations of items from 2+ collections, or optionally, limit to the first # of combinations with the maxCombinations parameter. Can use custom separator between items as well as replace null values with a custom value.

List<List<string>> sources = new() { new List<string> { "A", "B", "C" }, new List<string> { "1", "2", "3" } };
HashSet<string> result = sources.GetCombinations(maxCombinations: 5); // ["A|1", "A|2", "A|3", "B|1", "B|2"] - First 5 combinations

GetRandomCombinations

Get all or a limited quantity of all possible combinations from 2+ collections in a randomized order. Can use custom separator between items as well as replace null values with a custom value.

List<List<string>> sources = new() { new List<string> { "A", "B", "C" }, new List<string> { "1", "2", "3" } };
HashSet<string> result = sources.GetRandomCombinations(maxCombinations: 5); // ["B|3", "C|1", "C|3", "B|1", "A|3"] - Random 5 combinations

GetEnumeratedCombinations

Get an enumerable of all unique combinations of items from 2+ collections, or optionally, limit to the first # of combinations with the maxCombinations parameter. Can use custom separator between items as well as replace null values with a custom value. Useful for scenarios where a large quantity of values will be generated and consumed since values aren't all collected into one object before being returned.

List<List<string>> sources = new() { new List<string> { "A", "B", "C" }, new List<string> { "1", "2", "3" } };
IEnumerable<string> result = sources.GetCombinations(maxCombinations: 5); // ["A|1", "A|2", "A|3", "B|1", "B|2"] - First 5 combinations

Usage Examples

GetSafeSaveName

Get a unique file name if the file already exists.

string fileName = "test.txt";
string safeName = fileName.GetSafeSaveName(); // If "test.txt" exists, returns "test0.txt"

ValidateFileExtension

Validates file extension based on list of valid extensions

string fileName1 = "/some/file/path/test.txt";
string fileName2 = "/some/other/file/path.pdf";
string[] validExtensions = [".txt", ".doc", ".docx"];
bool fileName1Valid = fileName1.ValidateFileExtension(validExtensions); // True
bool fileName2Valid = fileName2.ValidateFileExtension(validExtensions); // false

GetHashFromFile

Gets the hash of a file's contents using the specified hashing algorithm.

string filePath = "document.txt";
string hash = await filePath.GetHashFromFile(EHashAlgorithm.SHA512); // Gets SHA512 hash of file

GetHashFromStream

Generates a hash based on the contents of a stream using the designated algorithm.

using FileStream stream = File.OpenRead("document.txt");
string hash = await stream.GetHashFromStream(EHashAlgorithm.SHA256); // Gets SHA256 hash of stream contents

GetAllFilesRecursive

Returns the full file path of all files contained under the specified directory.

string directory = @"C:\Documents"; // Get all files in directory and subdirectories
List<string> allFiles = FileHelpers.GetAllFilesRecursive(directory); // Returns all files
List<string> textFiles = FileHelpers.GetAllFilesRecursive(directory, "*.txt"); // Returns only .txt files

CleanFileName

Cleans a filename by removing or replacing invalid characters with safe alternatives.

string unsafeName = "file:with*invalid/chars?.txt";
string safeName = FileHelpers.CleanFileName(unsafeName); // Returns "file.with_invalid-chars_.txt"

ReadFileFromPipe

Reads data from a PipeReader and writes it to a stream, with optional file size limit and error handling. Designed for efficiently handling file uploads without unnecessary memory allocations. Returns a tuple with a success flag and an optional return value. Automatically resets stream position to 0 after reading. Handles both single-segment and multi-segment pipe data.

With Size Limit:

using System.IO.Pipelines;

// Example with size limit (e.g., for file uploads)
PipeReader pipeReader = GetPipeReader(); // From your source
MemoryStream fileStream = new();
const long maxFileSize = 5 * 1024 * 1024; // 5 MB limit

string? ErrorHandler(Exception ex)
{
    logger.Error(ex, "Failed to read file");
    return "Upload failed";
}

(bool success, string? result) = await pipeReader.ReadFileFromPipe(
    fileStream,
    maxFileSize,
    successReturn: "File uploaded successfully",
    fileTooLargeReturn: "File exceeds 5 MB limit",
    errorReturn: ErrorHandler,
    cancellationToken: cancellationToken);

if (success)
{
    // File successfully read, stream is at position 0 and ready to use
    await SaveFile(fileStream);
}
else
{
    // Handle error using the result message
    return BadRequest(result);
}

Without Size Limit:

using System.IO.Pipelines;

// Example without size limit
PipeReader pipeReader = GetPipeReader();
MemoryStream fileStream = new();

(bool success, int? statusCode) = await pipeReader.ReadFileFromPipe(
    fileStream,
    successReturn: 200,
    errorReturn: (ex) => 500,
    cancellationToken: cancellationToken);

if (success)
{
    // Process file stream (stream is at position 0)
    ProcessFile(fileStream);
}

Usage Examples

GetDefaultValue

Get the default value for a type.

object? def = typeof(int).GetDefaultValue(); // 0
object? defDate = typeof(DateTime).GetDefaultValue(); // 01/01/0001 00:00:00

CountDefaultProps

Count the number of properties with default values.

public class MyClass
{
    public int IntProp { get; set; }
    public string? StringProp { get; set; }
}

MyClass obj1 = new MyClass(); // IntProp = 0, StringProp = null int count1 = obj1.CountDefaultProps(); // 2
MyClass obj2 = new MyClass { IntProp = 1, StringProp = "not default" }; int count2 = obj2.CountDefaultProps(); // 0

ObjectHasAttribute

Check if a type has a specific attribute by name.

[Description("desc")]
public class ClassWithDescription { }
bool hasDescription = typeof(ClassWithDescription).ObjectHasAttribute("DescriptionAttribute"); // True
bool hasDescription2 = typeof(MyClass).ObjectHasAttribute("DescriptionAttribute"); // False

IsEqualR

Compares two objects for value equality using reflection, optionally exempting certain properties. Nested classes are not compared

public class MyClass
{
    public int IntProp { get; set; }
    public string? StringProp { get; set; }
}

MyClass a = new MyClass { IntProp = 5, StringProp = "abc" };
MyClass b = new MyClass { IntProp = 5, StringProp = "abc" };
bool eq = a.IsEqualR(b); // True
MyClass c = new MyClass { IntProp = 6, StringProp = "abc" };
bool eq2 = a.IsEqualR(c); // False

// Exempt IntProp from comparison
bool eq3 = a.IsEqualR(c, new[] { "IntProp" }); // True

IsEqual

Compares two objects for value equality, with options for exempting properties, ignoring string case, and recursive comparison.

public class MyClass
{
    public int IntProp { get; set; }
    public string? StringProp { get; set; }
}

MyClass a = new MyClass { IntProp = 1, StringProp = "abc" };
MyClass b = new MyClass { IntProp = 1, StringProp = "ABC" };
bool isAEqualToBNoCase = a.IsEqual(b, ignoreStringCase: true); // True
bool isAEqualToB = a.IsEqual(b, ignoreStringCase: false); // False
// Exempt IntProp from comparison
MyClass c = new MyClass { IntProp = 2, StringProp = "abc" };
bool isAEqualToC = a.IsEqual(c, exemptProps: new[] { "IntProp" }); // True

// Recursive comparison for nested objects
public class MyClass
{
    public int IntProp { get; set; }
    public string? StringProp { get; set; }
}

public class Nested
{
    public int Id { get; set; }
    public MyClass? Child { get; set; }
}

Nested nested1 = new Nested { Id = 1, Child = new MyClass { IntProp = 2, StringProp = "x" } };
Nested nested2 = new Nested { Id = 1, Child = new MyClass { IntProp = 2, StringProp = "x" } };
bool is1EqualTo2 = nested1.IsEqual(nested2); // True

GetHashForObject

Gets a hash string representing the object's value, using the specified algorithm (default MD5). Order of collection elements does not affect the hash.

public class MyClass
{
    public int IntProp { get; set; }
    public string? StringProp { get; set; }
}

MyClass a = new MyClass { IntProp = 1, StringProp = "abc" };
MyClass b = new MyClass { IntProp = 1, StringProp = "abc" };
string hashA = a.GetHashForObject(); // e.g. "e99a18c428cb38d5f260853678922e03"
string hashB = b.GetHashForObject(); // same as hashA

MyClass c = new MyClass { IntProp = 2, StringProp = "abc" };
string hashC = c.GetHashForObject(); // different from hashA/hashB

// For null objects
string hashNull = ((MyClass?)null).GetHashForObject(); // "null"

GetHashForObjectAsync

Asynchronously gets a hash string representing the object's value, using the specified algorithm (default MD5).

public class MyClass
{
    public int IntProp { get; set; }
    public string? StringProp { get; set; }
}

MyClass a = new MyClass { IntProp = 1, StringProp = "abc" };
MyClass b = new MyClass { IntProp = 1, StringProp = "abc" };
string hashA = a.GetHashForObjectAsync(); // e.g. "e99a18c428cb38d5f260853678922e03"
string hashB = b.GetHashForObjectAsync(); // same as hashA

MyClass c = new MyClass { IntProp = 2, StringProp = "abc" };
string hashC = c.GetHashForObjectAsync(); // different from hashA/hashB

// For null objects
string hashNull = ((MyClass?)null).GetHashForObjectAsync(); // "null"

Usage Examples

Ceiling

Rounds a value up to the next multiple of the specified significance.

double? d1 = 10.5;
double up1 = d1.Ceiling(5.0); // 15.0
decimal? d2 = 4.1m;
decimal up2 = d2.Ceiling(2.0m); // 6.0
double? d3 = null;
double up3 = d3.Ceiling(5.0); // 0.0

// If significance is 0, rounds up to the next integer
double up4 = 10.5.Ceiling(0.0); // 11.0

Floor

Rounds a value down to the previous multiple of the specified significance.

double? d1 = 12.0; double down1 = d1.Floor(5.0); // 10.0
decimal? d2 = 4.1m; decimal down2 = d2.Floor(2.0m); // 4.0
double? d3 = null; double down3 = d3.Floor(5.0); // 0.0

// If significance is 0, rounds down to the previous integer
double down4 = 10.5.Floor(0.0); // 10.0

GetPrecision

Gets the number of decimal places in a double or decimal value.

double? d1 = 123.12; int p1 = d1.GetPrecision(); // 2
decimal? d2 = 123.123m; int p2 = d2.GetPrecision(); // 3
double? d3 = 123.0; int p3 = d3.GetPrecision(); // 0
decimal? d4 = null; int p4 = d4.GetPrecision(); // 0

// Respects current culture's decimal separator
System.Globalization.CultureInfo.CurrentCulture = new System.Globalization.CultureInfo("fr-FR");
double d5 = 123.45;
int p5 = d5.GetPrecision(); // 2

GenerateRange

Generates a continuous range of integers between start and end (inclusive).

var range1 = MathHelpers.GenerateRange(1, 5); // [1, 2, 3, 4, 5]
var range2 = MathHelpers.GenerateRange(-2, 2); // [-2, -1, 0, 1, 2]
var range3 = MathHelpers.GenerateRange(0, 0); // [0]

GreatestCommonDenominator

Reduces a fraction to its lowest terms and returns the greatest common denominator.

long num = 12, den = 8;
MathHelpers.GreatestCommonDenominator(ref num, ref den, out long gcd); // num == 3, den == 2, gcd == 4
num = 25; den = 15;
MathHelpers.GreatestCommonDenominator(ref num, ref den, out gcd); // num == 5, den == 3, gcd == 5
num = 7; den = 13;
MathHelpers.GreatestCommonDenominator(ref num, ref den, out gcd); // num == 7, den == 13, gcd == 1
num = 0; den = 5;
MathHelpers.GreatestCommonDenominator(ref num, ref den, out gcd); // num == 0, den == 1, gcd == 5

Usage Examples

GetRandomInt

Generates a random integer within a specified range.

int n1 = Random.GetRandomInt(); // 0 <= n1 < int.MaxValue
int n2 = Random.GetRandomInt(100); // 0 <= n2 < 100
int n3 = Random.GetRandomInt(-5, 5); // -5 <= n3 < 5

GetRandomInts

Generates a number of random integers within a specified range.

IEnumerable<int> values = Random.GetRandomInts(5, 0, 100); // 5 random ints, each 0 <= x < 100
IEnumerable<int> values2 = Random.GetRandomInts(10, -50, 50); // 10 random ints, -50 <= x < 50

GetRandomDouble

Generates a random double in the range [0, 1), optionally with a specified number of decimal places.

double d1 = Random.GetRandomDouble(); // 0 <= d1 < 1, with 15 decimal places
double d2 = Random.GetRandomDouble(3); // 0 <= d2 < 1, with 3 decimal places

GetRandomDoubles

Generates a number of random doubles in the range [0, 1), each with the specified number of decimal places.

IEnumerable<double> doubles = Random.GetRandomDoubles(5, 3); // 5 random doubles, with 3 decimal places

GetRandomDecimal

Generates a random decimal in the range [0, 1), optionally with a specified number of decimal places.

decimal dec1 = Random.GetRandomDecimal(); // 0 <= dec1 < 1, with 28 decimal places
decimal dec2 = Random.GetRandomDecimal(5); // 0 <= dec2 < 1, with 5 decimal places

GetRandomDecimals

Generates a number of random decimals in the range [0, 1), each with the specified number of decimal places.

IEnumerable<decimal> decimals = Random.GetRandomDecimals(5, 3); // 5 random decimals, with 3 decimal places

ShuffleListInPlace

Randomly shuffles a list in place.

List<int> list = Enumerable.Range(1, 10).ToList();
list.ShuffleListInPlace(); // list is now shuffled in place eg. [4, 6, 1, 9, 7, 8, 3, 2, 10, 5]

Shuffle

Randomly shuffles a collection and returns a new collection.

int[] arr = Enumerable.Range(1, 10).ToArray();
int[] shuffledArr = arr.Shuffle(); // returns a new shuffled IEnumerable<int> eg. [4, 6, 1, 9, 7, 8, 3, 2, 10, 5]
arr.Shuffle(); // shuffles the array in place
List<int> list = Enumerable.Range(1, 10).ToList();
List<int> shuffledList = list.Shuffle(); // returns a new shuffled List<int> eg. [4, 6, 1, 9, 7, 8, 3, 2, 10, 5]

ShuffleLinq

Randomly shuffles a collection using LINQ.

IEnumerable<int> shuffled = Enumerable.Range(1, 10).ShuffleLinq(); // returns a new shuffled IEnumerable<int> eg. [4, 6, 1, 9, 7, 8, 3, 2, 10, 5]

GetRandomElement

Selects a single random element from a collection.

List<int> items = Enumerable.Range(1, 100).ToList();
int? randomItem = items.GetRandomElement(); // randomItem is one of the items in the list eg. 42

GetRandomElements

Selects a specified number of random elements from a collection.

List<int> items = Enumerable.Range(1, 100).ToList();
IEnumerable<int> randomItems = items.GetRandomElements(5); // 5 random elements from the list eg. [11, 97, 47, 38, 3]

GenerateRandomString

Generates a random string of the specified length and ASCII range, with optional blacklist.

string s1 = Random.GenerateRandomString(10); // Up to 10 random printable ASCII characters eg. "d5FimP2aL"
string s2 = Random.GenerateRandomString(10, 5); // Between 5 and 10 random printable ASCII characters characters eg. "d5Fm"
string s3 = Random.GenerateRandomString(10, -1, 65, 90); // Up to 10 uppercase letters only eg. "ARLDFKGNV"
string s4 = Random.GenerateRandomString(10, blacklistedCharacters: new[] { 'a', 'e', 'i', 'o', 'u' }); // Up to 10 random characters with no vowels eg. "d5FmP2L"

GenerateRandomStrings

Generates multiple random strings of the specified length and ASCII range.

IEnumerable<string> strings = Random.GenerateRandomStrings(3, 10); // 3 random strings, each up to 10 characters long eg. ["d5FimP2aL", "jk3n452l3s", "P3c"]

GenerateRandomStringByCharSet

Generates a random string of the specified length using a custom character set.

char[] charset = { 'A', 'B', 'C', '1', '2', '3' };
string s = Random.GenerateRandomStringByCharSet(10, charset); // 10 characters, only from charset eg. 3BCA11CA23

Usage Examples

RunBatchedProcessAsync

Processes a collection in batches asynchronously using the provided batch processor delegate. Supports breaking on failure, custom batch sizes, and works with both IEnumerable<T> and List<T> batch processors.

// Process a list of items in batches of 30 asynchronously
List<int> items = Enumerable.Range(1, 100).ToList();
List<int> processed = [];
async Task<bool> BatchProcessor(IEnumerable<int> batch)
{
    foreach (int item in batch)
    {
        // Simulate async work
        await Task.Delay(1);
        processed.Add(item);
    }
    return true; // Return false here to indicate failure and optionally break
}
bool result = await items.RunBatchedProcessAsync(BatchProcessor, batchSize: 30); // result == true, processed contains all items

//Using a List<T> batch processor
async Task<bool> BatchProcessorList(List<int> batch)
{
    processed.AddRange(batch);
    await Task.Yield();
    return true;
}
bool result2 = await items.RunBatchedProcessAsync(BatchProcessorList, batchSize: 20); // result2 == true, processed contains all items
// Break on first failed batch
int failAfter = 1;
async Task<bool> FailingBatchProcessor(IEnumerable<int> batch)
{
    return failAfter-- > 0;
}
bool result3 = await items.RunBatchedProcessAsync(FailingBatchProcessor, batchSize: 30, breakOnFail: true); // result3 == false, only first batch processed

RunBatchedProcess

Processes a collection in batches synchronously using the provided batch processor delegate. Supports breaking on failure, custom batch sizes, and works with both IEnumerable<T> and List<T> batch processors.

// Process a list of items in batches of 30 synchronously
List<int> items = Enumerable.Range(1, 100).ToList(); List<int> processed = [];
bool BatchProcessor(IEnumerable<int> batch)
{
    processed.AddRange(batch);
    return true; // Return false here to indicate failure and optionally break
}
bool result = items.RunBatchedProcess(BatchProcessor, batchSize: 30); // result == true, processed contains all items

// Using a List<T> batch processor
bool BatchProcessorList(List<int> batch)
{
    processed.AddRange(batch);
    return true;
}
bool result2 = items.RunBatchedProcess(BatchProcessorList, batchSize: 20); // result2 == true, processed contains all items

// Break on first failed batch
int failAfter = 1;
bool FailingBatchProcessor(IEnumerable<int> batch)
{
    return failAfter-- > 0;
}
bool result3 = items.RunBatchedProcess(FailingBatchProcessor, batchSize: 30, breakOnFail: true); // result3 == false, only first batch processed

Usage Examples

Left

Returns the leftmost n characters of a string (like VBA's Left).

"Hello".Left(3); // "Hel"
"Test".Left(5);  // "Test"
((string?)null).Left(3); // null

Right

Returns the rightmost n characters of a string (like VBA's Right).

"Hello".Right(3); // "llo"
"Test".Right(5);  // "Test"
((string?)null).Right(3); // null

ExtractBetween

Extracts the substring between two delimiters.

"Start[Middle]End".ExtractBetween("[", "]"); // "Middle"
"Hello World".ExtractBetween("Hello", "World"); // " "
"NoDelimiters".ExtractBetween("[", "]"); // null

MakeNullNull

Converts the string "null" (case-insensitive, with or without whitespace) to null.

"null".MakeNullNull(); // null
" not null ".MakeNullNull(); // " not null "

ParsePascalCase

Inserts spaces before each uppercase letter in PascalCase or camelCase strings.

"HelloWorld".ParsePascalCase(); // "Hello World"
"camelCase".ParsePascalCase();  // "camel Case"

ToTitleCase

Converts a string to title case, with options for handling all-uppercase words.

"THE QUICK BROWN FOX".ToTitleCase(uppercaseHandling: TitleCaseUppercaseWordHandling.ConvertAllUppercase); // "The Quick Brown Fox"
"THE QUICK BROWN FOX".ToTitleCase(uppercaseHandling: TitleCaseUppercaseWordHandling.IgnoreUppercase); // "THE QUICK BROWN FOX"

TrimFull

Removes leading/trailing whitespace and reduces multiple spaces to a single space.

"   extra   spaces   ".TrimFull(); // "extra spaces"
"hello  world   test".TrimFull();  // "hello world test"

IsNullOrWhiteSpace

Checks if a string is null, empty, or whitespace.

null.IsNullOrWhiteSpace(); // true
"".IsNullOrWhiteSpace(); // true
"   ".IsNullOrWhiteSpace(); // true
"Test".IsNullOrWhiteSpace(); // false

IsNullOrEmpty

Checks if a string is null or empty.

null.IsNullOrWhiteSpace(); // true
"".IsNullOrWhiteSpace(); // true
"   ".IsNullOrWhiteSpace(); // false
"Test".IsNullOrWhiteSpace(); // false

ContainsInvariant

Case-insensitive, culture-invariant substring search, or checks if the given string contains at least one or all of the strings in a collection of strings, regardless of culture or case.

"Hello WORLD".ContainsInvariant("world"); // true
"Test".ContainsInvariant("no match"); // false

"Hello WORLD".ContainsInvariant(["world", "Not Present"], true); // true
"Hello WORLD".ContainsInvariant(["world", "Not Present"], false); // false
"Hello WORLD".ContainsInvariant(["hello", "world"], false); // true
"Test".ContainsInvariant("no match"); // false

StartsWithInvariant

Checks if the given string begins with a specific string regardless of culture or case

"Hello WORLD".StartsWithInvariant("hello w"); // true
"Test".StartsWithInvariant("no match"); // false

EndsWithInvariant

Checks if the given string ends with a specific string regardless of culture or case

"Hello WORLD".EndsWithInvariant(" world"); // true
"Test".EndsWithInvariant("no match"); // false

IndexOfInvariant

Gets the index of a character in a string, ignoring culture and case

"Hello WORLD".IndexOfInvariant('w'); // 6

Contains

Checks if the given string contains at least one or all of the strings in a collection of strings (case sensitive).

"Hello WORLD".Contains(["Hello", "Not Present"], true); // true
"Hello WORLD".Contains(["Hello", "Not Present"], false); // false
"Hello WORLD".Contains(["Hello", "WORLD"], false); // true
"Test".Contains("no match"); // false

ReplaceInvariant

Case-insensitive, culture-invariant string replacement.

"Hello WORLD".ReplaceInvariant("hello", "Test"); // "Test WORLD"

StrEq

Case-insensitive, culture-invariant string equality.

"string1".StrEq("STRING1"); // true
"string1".StrEq("string2"); // false

StrComp

Compare two strings with optional stringComparison parameter

"string1".StrComp("STRING1"); // false
"string1".StrComp("string1"); // false
"string1".StrComp("string2"); // false
"string1".StrComp("STRING1", StringComparison.InvariantCultureIgnoreCase); // true
"string1".StrComp("string2", StringComparison.InvariantCultureIgnoreCase); // false

IsAlphanumeric

Checks if a string contains only letters and numbers (optionally spaces).

"abc123".IsAlphanumeric(); // true
"abc 123".IsAlphanumeric(true); // true
"abc 123".IsAlphanumeric(false); // false
"abc@123".IsAlphanumeric(); // false

IsAlphaOnly

Checks if a string contains only letters (optionally spaces).

"abcDEF".IsAlphaOnly(); // true
"abc DEF".IsAlphaOnly(true); // true
"abc DEF".IsAlphaOnly(false); // false
"abc@DEF".IsAlphaOnly(); // false
"abc123".IsAlphaOnly(); // false

IsNumericOnly

Checks if a string contains only numbers (optionally spaces).

"123456".IsNumericOnly(); // true
"123 456".IsNumericOnly(true); // true
"123 456".IsNumericOnly(false); // false
"123@456".IsNumericOnly(); // false
"abc123".IsNumericOnly(); // false

ExtractToLastInstance

Gets string up until before the last instance of a character (exclusive)

"Hello World Hello World".ExtractToLastInstance('W') // "Hello World Hello "

ExtractFromLastInstance

Gets string remaining after the last instance of a character (exclusive)

"Hello World Hello World".ExtractFromLastInstance('W') // "orld"

TrimObjectStringsR

Trims top level string property values retrieved with reflection in an object using TrimFull.

public class MyClass
{
    public int IntProp { get; set; }
    public string? StringProp { get; set; }
    public NestedClass? NestedClass { get; set; }
}

public class NestedClass
{
    public int NestedIntProp { get; set; }
    public string? NestedStringProp { get; set; }
}

MyClass myClass = new()
{
    IntProp = 1,
    StringProp = " Test    string ",
    NestedClass = new()
    {
        NestedIntProp = 1,
        NestedStringProp = " Test    string "
    }
};

myClass = myClass.TrimObjectStringsR();
// myClass =
// {
//     IntProp = 1,
//     StringProp = "Test string",
//     NestedClass =
//     {
//         NestedIntProp = 1,
//         NestedStringProp = " Test    string "
//     }
// };

TrimObjectStrings

Trims top level string property values in a class, and optionally nested class properties using expression trees in an object using TrimFull.

public class MyClass
{
    public int IntProp { get; set; }
    public string? StringProp { get; set; }
    public NestedClass? NestedClass { get; set; }
}

public class NestedClass
{
    public int NestedIntProp { get; set; }
    public string? NestedStringProp { get; set; }
}

MyClass myClass = new()
{
    IntProp = 1,
    StringProp = " Test    string ",
    NestedClass = new()
    {
        NestedIntProp = 1,
        NestedStringProp = " Test    string "
    }
};

myClass = myClass.TrimObjectStrings(true);
// myClass =
// {
//     IntProp = 1,
//     StringProp = "Test string",
//     NestedClass =
//     {
//         NestedIntProp = 1,
//         NestedStringProp = "Test string" <== Nested string is trimmed as well here>
//     }
// };

NormalizeObjectStringsR

Apply normalization form and optionally TrimFull to all top level string properties in a class using reflection.

public class TestObject
{
    public string? StringProp { get; set; }
    public NestedObject NestedObject { get; set; } = new();
    public string? StringPropWithSpaces { get; set; }
    public NestedObject NestedStringPropWithSpaces { get; set; } = new();
}

TestObject testObject = new()
{
    StringProp = "test\u0300", // Combining grave accent
    NestedObject = new() { InnerString = "e\u0301" }, // Combining acute accent
    StringPropWithSpaces = "  test  ",
    NestedStringPropWithSpaces = new() { InnerString = "  test  " }
};

testObject = testObject.NormalizeObjectStringsR(true, NormalizationForm.FormD);
// testObject =
{
    StringProp = "test̀", // Combining grave accent
    NestedObject = new() { InnerString = "e\u0301" }, // Combining acute accent
    StringPropWithSpaces = "test",
    NestedStringPropWithSpaces = new() { InnerString = "  test  " }
};

NormalizeObjectStrings

Apply normalization form and optionally TrimFull to all top level string properties in a class and optionally string properties of nested classes using expression trees.

public class TestObject
{
    public string? StringProp { get; set; }
    public NestedObject NestedObject { get; set; } = new();
    public string? StringPropWithSpaces { get; set; }
    public NestedObject NestedStringPropWithSpaces { get; set; } = new();
}

TestObject testObject = new()
{
    StringProp = "test\u0300", // Combining grave accent
    NestedObject = new() { InnerString = "e\u0301" }, // Combining acute accent
    StringPropWithSpaces = "  test  ",
    NestedStringPropWithSpaces = new() { InnerString = "  test  " }
};

testObject = testObject.NormalizeObjectStrings(true, NormalizationForm.FormD, true);
// testObject =
{
    StringProp = "test̀",
    NestedObject = new() { InnerString = "é" },
    StringPropWithSpaces = "test",
    NestedStringPropWithSpaces = new() { InnerString = "test" }
};

MakeObjectNullNullR

Apply MakeNullNull to all top level string properties in a class.

public class MyClass
{
    public int IntProp { get; set; }
    public string? StringProp { get; set; }
    public NestedClass? NestedClass { get; set; }
}

public class NestedClass
{
    public int NestedIntProp { get; set; }
    public string? NestedStringProp { get; set; }
}

MyClass myClass = new()
{
    IntProp = 1,
    StringProp = "null",
    NestedClass = new()
    {
        NestedIntProp = 1,
        NestedStringProp = "null"
    }
};

myClass = myClass.MakeObjectNullNullR();
// myClass =
// {
//     IntProp = 1,
//     StringProp = null,
//     NestedClass =
//     {
//         NestedIntProp = 1,
//         NestedStringProp = "null"
//     }
// };

MakeObjectNullNull

Apply MakeNullNull to all top level string properties in a class, optionally applying to nested classes as well.

public class MyClass
{
    public int IntProp { get; set; }
    public string? StringProp { get; set; }
    public NestedClass? NestedClass { get; set; }
}

public class NestedClass
{
    public int NestedIntProp { get; set; }
    public string? NestedStringProp { get; set; }
}

MyClass myClass = new()
{
    IntProp = 1,
    StringProp = "null",
    NestedClass = new()
    {
        NestedIntProp = 1,
        NestedStringProp = "null"
    }
};

myClass = myClass.MakeObjectNullNullR();
// myClass =
// {
//     IntProp = 1,
//     StringProp = null,
//     NestedClass =
//     {
//         NestedIntProp = 1,
//         NestedStringProp = null
//     }
// };

ToNString

Convert nullable value into a nullable string, retaining null value if the source was null. Works with DateTime?, DateOnly?, TimeSpan?, int?, long?, double?, decimal?, bool?, object?

string? test = (int)null.ToNString(); // null
string? test = 1.ToNString(); // "1"

ToListInt

Converts list of string representations of integers into list of integers.

List<int> numbers = ["1", "2", "3"].ToListInt(); // [1, 2, 3]

ToNInt

Parses nullable string into a nullable integer where null string results in a returned null value.

"1".ToNInt(); // 1
"invalid".ToNInt(); // null
null.ToNInt(); // null

ToNDouble

Parses nullable string into a nullable double where null string results in a returned null value.

"1".ToNDouble(); // 1.0d
"invalid".ToNDouble(); // null
null.ToNDouble(); // null

ToNDecimal

Parses nullable string into a nullable decimal where null string results in a returned null value.

"1".ToNDecimal(); // 1.0m
"invalid".ToNDecimal(); // null
null.ToNDecimal(); // null

ToNDateTime

Parses nullable string into a nullable DateTime where null string results in a returned null value.

"2024-05-12".ToNDateTime(); // {5/12/2024 12:00:00 AM}
"invalid".ToNDateTime(); // null
null.ToNDateTime(); // null

ToNDateOnly

Parses nullable string into a nullable DateOnly where null string results in a returned null value.

"2024-05-12".ToNDateOnly(); // {5/12/2024}
"invalid".ToNDateOnly(); // null
null.ToNDateOnly(); // null

YesNoToBool

Converts string "Yes" and "No" values into true and false using invariant text comparison on trimmed version of the original string.

"YES".YesNoToBool(); // true
"YES   ".YesNoToBool(); // true
"yes".YesNoToBool(); // true
"No".YesNoToBool(); // false
"SomeRandomText".YesNoToBool(); // false

YNToBool

Converts string "Y" and "N" values into true and false using invariant text comparison on trimmed version of the original string.

"Y".YNToBool(); // true
"Y   ".YNToBool(); // true
"y".YNToBool(); // true
"N".YNToBool(); // false
"SomeRandomText".YNToBool(); // false

BoolToYesNo

Converts a boolean into a "Yes" or "No" string value

true.BoolToYesNo(); // "Yes"
false.BoolToYesNo(); // "No"

BoolToYN

Converts a boolean into a "Y" or "N" string value

true.BoolToYN(); // "Y"
false.BoolToYN(); // "N"

BoolToInt

Convert bool to 1 or 0

true.BoolToInt(); // 1
false.BoolToInt(); // 0

GetSafeDate

Get file name safe date in the chosen format

"5/12/2025".GetSafeDate("yyyy/MM/dd"); //2025-05-12
Strings.GetSafeDate("yyyy/MM/dd"); // Current date in yyyy-MM-dd format

MakeExportNameUnique

Adds number in () at the end of a file name if it would create a duplicate in the savePath

string safeFileName = Strings.MakeExportNameUnique(@"C:\Some\Test\Path", "test", "txt"); // "test (0).txt" -- Assuming test.txt is already in C:\Some\Test\Path

TimespanToShortForm

"Description"

<Example Code>

GetHash

Gets a hash of a string using the specified algorithm.

string hashValue = "test string".GetHash(EHashAlgorithm.SHA256); // 64-char SHA256 hex string

NormalizeWhiteSpace

Removes excess whitespace, preserving single spaces and line breaks.

"Hello World\t\nTest".NormalizeWhiteSpace(); // "Hello World\nTest"

FormatDateString

Take any format of a date time string and convert it to a different format.

string formattedDateString = "2023-01-01".FormatDateString("yyyy-MM-dd", "yyyy.MM.dd"); // "2023.01.01"

ReplaceInverse

Replaces any characters that don't match the provided regexPattern with specified replacement string.

string result = "Example_Test_Text".ReplaceInverse("Test_Text", ""); // "Test_Text"

UrlEncodeReadable

URL Encodes a string but then replaces specific escape sequences with their decoded character.

string urlEncode = UrlEncode("Hello World"); // "Hello%20World"
string urlEncode = UrlEncodeReadable("Hello World"); // "Hello World"

FormatPhoneNumber

Formats a string as a phone number.

"1234567890".FormatPhoneNumber(); // "123-456-7890"
"11234567890".FormatPhoneNumber(); // "+1 123-456-7890"
"1234567890".FormatPhoneNumber("-", true); // "(123)-456-7890"

SplitLines

Splits a string into lines.

"hello\nworld\ntest".SplitLines(); // ["hello", "world", "test"]

ToFractionString

Converts decimals to fraction strings.

2.5m.ToFractionString(3); // "2 1/2"

FractionToDecimal

Parses fraction strings to decimals

"2 1/2".FractionToDecimal(); // 2.5m
"2.5".FractionToDecimal(); // 2.5m

TryFractionToDecimal

Attempts to convert a fraction represented as a string into its decimal equivalent

if("3 1/4".TryStringToDecimal(out decimal result))
{
    Console.WriteLine(result); // 3.25m
}
if("3.25".TryStringToDecimal(out decimal result))
{
    Console.WriteLine(result); // 3.25m
}

TryStringToDecimal

Attempts to convert a decimal or fraction represented as a string into its decimal equivalent

if("3 1/4".TryStringToDecimal(out decimal result))
{
    Console.WriteLine(result); // 3.25m
}

if("3.25".TryStringToDecimal(out decimal result))
{
    Console.WriteLine(result); // 3.25m
}

// Will ignore any text that does not fit the regex [0-9]*\.?[0-9]+
if("3.25 Some other text".TryStringToDecimal(out decimal result))
{
    Console.WriteLine(result); // 3.25m
}

FractionToDouble

Parses fraction strings to doubles

"2 1/2".FractionToDecimal(); // 2.5d
"2.5".FractionToDecimal(); // 2.5d

TryFractionToDouble

Attempts to convert a fraction represented as a string into its double equivalent

if("3 1/4".TryStringToDouble(out double result))
{
    Console.WriteLine(result); // 3.25d
}
if("3.25".TryStringToDouble(out double result))
{
    Console.WriteLine(result); // 3.25d
}

TryStringToDouble

Attempts to convert a decimal or fraction represented as a string into its double equivalent

if("3 1/4".TryStringToDouble(out double result))
{
    Console.WriteLine(result); // 3.25d
}

if("3.25".TryStringToDouble(out double result))
{
    Console.WriteLine(result); // 3.25d
}

// Will ignore any text that does not fit the regex [0-9]*\.?[0-9]+
if("3.25 Some other text".TryStringToDouble(out double result))
{
    Console.WriteLine(result); // 3.25d
}

RemoveLetters

Removes all letters from a string.

"123hello123".RemoveLetters(); // "123123"

RemoveNumbers

Removes all numbers from a string.

"123hello123".RemoveNumbers(); // "hello"

GetOnlyLetters

Extracts only the letters from a string.

"hello123".GetOnlyLetters(); // "hello"

GetOnlyNumbers

Extracts only the numbers from a string.

"hello123".GetOnlyNumbers(); // "123"
"123 1/2".GetOnlyNumbers(true); // "123 1/2"

RemoveLeadingNonAlphanumeric

Removes non-alphanumeric characters from the start of a string.

"!@#abc123".RemoveLeadingNonAlphanumeric(); // "abc123"

RemoveTrailingNonAlphanumeric

Removes non-alphanumeric characters from the end of a string.

"abc123!@#".RemoveTrailingNonAlphanumeric(); // "abc123"

TrimOuterNonAlphanumeric

Chains RemoveLeadingNonAlphanumeric and RemoveTrailingNonAlphanumeric calls

"!@#abc123!@#".TrimOuterNonAlphanumeric(); // "abc123"

CountChars

Counts the number of times a character appears in a string.

"hello".CountChars('l'); // 2

HasNoMoreThanNumberOfChars

Checks if a string contains no more than a specified number of a given character.

"hello".HasNoMoreThanNumberOfChars('l', 2); // true
"hello".HasNoMoreThanNumberOfChars('l', 1); // false

HasNoLessThanNumberOfChars

Checks if a string contains at least a specified number of a given character.

"hello".HasNoLessThanNumberOfChars('l', 2); // true
"hello".HasNoLessThanNumberOfChars('l', 3); // false

Usage Examples

IsDelegate

Checks if a type is a delegate.

typeof(Action).IsDelegate(); // true
typeof(Func<int>).IsDelegate(); // true
typeof(string).IsDelegate(); // false
typeof(int).IsDelegate(); // false

IsArray

Checks if a type is an array.

typeof(int[]).IsArray(); // true
typeof(string[]).IsArray(); // true
typeof(List<int>).IsArray(); // false
typeof(int).IsArray(); // false

IsDictionary

Checks if a type implements IDictionary.

typeof(Dictionary<int, string>).IsDictionary(); // true
typeof(System.Collections.Hashtable).IsDictionary(); // true
typeof(List<int>).IsDictionary(); // false
typeof(int).IsDictionary(); // false

IsEnumerable

Checks if a type implements IEnumerable and is not a string.

typeof(List<int>).IsEnumerable(); // true
typeof(int[]).IsEnumerable(); // true
typeof(string).IsEnumerable(); // false
typeof(int).IsEnumerable(); // false

IsClassOtherThanString

Checks if a type is a class other than string. Returns true for null.

typeof(List<int>).IsClassOtherThanString(); // true
typeof(string).IsClassOtherThanString(); // false
typeof(int).IsClassOtherThanString(); // false
((Type?)null).IsClassOtherThanString(); // true

IsNumeric

Checks if an object is a numeric type.

123.IsNumeric(); // true
123.45.IsNumeric(); // true
"string".IsNumeric(); // false
((object?)null).IsNumeric(); // false

IsNumericType

Checks if a type is a numeric type (including nullable numeric types).

typeof(int).IsNumericType(); // true
typeof(double).IsNumericType(); // true
typeof(string).IsNumericType(); // false
typeof(int?).IsNumericType(); // true
((Type?)null).IsNumericType(); // false

IsSimpleType

Returns true if the type is a primitive, enum, string, decimal, DateTime, DateTimeOffset, TimeSpan, or Guid.

typeof(int).IsSimpleType(); // true
typeof(string).IsSimpleType(); // true
typeof(decimal).IsSimpleType(); // true
typeof(DateTime).IsSimpleType(); // true
typeof(Guid).IsSimpleType(); // true
typeof(List<int>).IsSimpleType(); // false

IsReadOnlyCollectionType

Checks if the type is a read-only collection type, such as IReadOnlyCollection<T>, IReadOnlyList<T>, or ReadOnlyCollection<T>.

typeof(IReadOnlyCollection<int>).IsReadOnlyCollectionType(); // true .
typeof(IReadOnlyList<string>).IsReadOnlyCollectionType(); // true
typeof(System.Collections.ObjectModel.ReadOnlyCollection<int>).IsReadOnlyCollectionType(); // true
typeof(List<int>).IsReadOnlyCollectionType(); // false
typeof(int[]).IsReadOnlyCollectionType(); // false
typeof(System.Collections.Immutable.ImmutableArray<int>).IsReadOnlyCollectionType(); // true
typeof(Dictionary<int, string>).IsReadOnlyCollectionType(); // false
typeof(IReadOnlyDictionary<int, string>).IsReadOnlyCollectionType(); // true
typeof(object).IsReadOnlyCollectionType(); // false

Usage Examples

LbsToKg

Converts pounds (lbs) to kilograms (kg).

decimal kg = 10m.LbsToKg(); // 4.53592
decimal kg2 = ((decimal?)10.0).LbsToKg(); // 4.53592
decimal kg3 = ((decimal?)null).LbsToKg(); // 0

KgToLbs

Converts kilograms (kg) to pounds (lbs).

decimal lbs = 10m.KgToLbs(); // 22.0462
decimal lbs2 = ((decimal?)10.0).KgToLbs(); // 22.0462
decimal lbs3 = ((decimal?)null).KgToLbs(); // 0

InsToFt

Converts inches to feet.

decimal feet = 12m.InsToFt(); // 1.0
decimal feet2 = ((decimal?)12.0).InsToFt(); // 1.0
decimal feet3 = ((decimal?)null).InsToFt(); // 0

InsToMm

Converts inches to millimeters.

decimal mm = 1m.InsToMm(); // 25.4
decimal mm2 = ((decimal?)1.0).InsToMm(1); // 25.4
decimal mm3 = ((decimal?)null).InsToMm(1); // 0

MmToIns

Converts millimeters to inches.

decimal inches = 25.4m.MmToIns(1); // 1.0
decimal inches2 = ((decimal?)25.4).MmToIns(1); // 1.0
decimal inches3 = ((decimal?)null).MmToIns(1); // 0

FtToIns

Converts feet to inches.

decimal inches = 1m.FtToIns(); // 12.0
decimal inches2 = ((decimal?)1.0).FtToIns(); // 12.0
decimal inches3 = ((decimal?)null).FtToIns(); // 0

BytesToKb

Converts bytes to kilobytes (KB).

decimal kb = 1024.BytesToKb(1); // 1.0
decimal kb2 = 1024L.BytesToKb(1); // 1.0

KbToBytes

Converts kilobytes (KB) to bytes.

long bytes = 1m.KbToBytes(); // 1024

BytesToMb

Converts bytes to megabytes (MB).

decimal mb = 1048576.BytesToMb(1); // 1.0
decimal mb2 = 1048576L.BytesToMb(1); // 1.0

MbToBytes

Converts megabytes (MB) to bytes.

long bytes = 1m.MbToBytes(); // 1048576

BytesToGb

Converts bytes to gigabytes (GB).

decimal gb = 1073741824.BytesToGb(1); // 1.0
decimal gb2 = 1073741824L.BytesToGb(1); // 1.0

GbToBytes

Converts gigabytes (GB) to bytes.

long bytes = 1m.GbToBytes(); // 1073741824

BytesToTb

Converts bytes to terabytes (TB).

decimal tb = 1099511627776.BytesToTb(1); // 1.0
decimal tb2 = 1099511627776L.BytesToTb(1); // 1.0

TbToBytes

Converts terabytes (TB) to bytes.

long bytes = 1m.TbToBytes(); // 1099511627776

KbToMb

Converts kilobytes (KB) to megabytes (MB).

decimal mb = 1024m.KbToMb(1); // 1.0

MbToKb

Converts megabytes (MB) to kilobytes (KB).

decimal mb = 1024m.KbToMb(1); // 1.0

KbToGb

Converts kilobytes (KB) to gigabytes (GB).

decimal gb = 1048576m.KbToGb(1); // 1.0

GbToKb

Converts gigabytes (GB) to kilobytes (KB).

decimal kb = 1m.GbToKb(1); // 1048576.0

KbToTb

Converts kilobytes (KB) to terabytes (TB).

decimal tb = 1073741824m.KbToTb(1); // 1.0

TbToKb

Converts terabytes (TB) to kilobytes (KB).

decimal kb = 1m.TbToKb(1); // 1073741824.0

MbToGb

Converts megabytes (MB) to gigabytes (GB).

decimal gb = 1024m.MbToGb(1); // 1.0

GbToMb

Converts gigabytes (GB) to megabytes (MB).

decimal mb = 1m.GbToMb(1); // 1024.0

MbToTb

Converts megabytes (MB) to terabytes (TB).

decimal tb = 1048576m.MbToTb(1); // 1.0

TbToMb

Converts terabytes (TB) to megabytes (MB).

decimal mb = 1m.TbToMb(1); // 1048576.0

GbToTb

Converts gigabytes (GB) to terabytes (TB).

decimal tb = 1024m.GbToTb(1); // 1.0

TbToGb

Converts terabytes (TB) to gigabytes (GB).

decimal gb = 1m.TbToGb(1); // 1024.0

GetFileSizeFromBytesWithUnits

Returns a human-readable string representation of the number of bytes, with units.

string size1 = 1024L.GetFileSizeFromBytesWithUnits(); // "1 KB"
string size2 = 1048576L.GetFileSizeFromBytesWithUnits(); // "1 MB"
string size3 = 1073741824L.GetFileSizeFromBytesWithUnits(); // "1 GB"
string size4 = 1099511627776L.GetFileSizeFromBytesWithUnits(); // "1 TB"
string size5 = 0L.GetFileSizeFromBytesWithUnits(); // "0 B"
string size6 = ((long?)null).GetFileSizeFromBytesWithUnits(); // "-0"
string size7 = 1024.GetFileSizeFromBytesWithUnits(); // "1 KB"
string size8 = ((int?)null).GetFileSizeFromBytesWithUnits(); // "-0"

MetersToMiles

Converts meters to miles. Overloads support decimal, double, int, and nullable types.

decimal miles = 1609.34m.MetersToMiles(); // 1.0
decimal miles2 = ((decimal?)1609.34).MetersToMiles(); // 1.0
decimal miles3 = 1609.34.MetersToMiles(); // 1.0 (double overload)
decimal miles4 = ((double?)1609.34).MetersToMiles(); // 1.0
decimal miles5 = 1609.MetersToMiles(); // 1.0 (int overload)
decimal miles6 = ((int?)1609).MetersToMiles(); // 1.0

MilesToMeters

Converts miles to meters. Overloads support decimal and nullable types.

decimal meters = 1m.MilesToMeters(); // 1609.34
decimal meters2 = ((decimal?)1.0).MilesToMeters(); // 1609.34
decimal meters3 = 1.MilesToMeters(); // 1609.34 (int overload)
decimal meters4 = ((int?)1).MilesToMeters(); // 1609.34

dotnet add package CommonNetFuncs.Core

Nick_Scarpitti/CommonNetFuncs.Corev4.0.15

Get Started

Readme

CommonNetFuncs.Core

Contents

Async

Async Usage Examples

Usage Examples

ObjectFill

ObjectUpdate

Collections

Collections Usage Examples

Usage Examples

AnyFast

AddDictionaryItem & AddDictionaryItems

AddRange & AddRangeParallel

SetValue & SetValueParallel

SelectNonEmpty

SelectNonNull

SingleToList

GetObjectByPartial

ToList

ToListParallel

ToDataTable

ToDataTableReflection (Obsolete)

CombineExpressions

StringAggProps

IndexOf

IsIn

GetCombinations

GetRandomCombinations

GetEnumeratedCombinations

Copy

Copy Usage Examples

Usage Examples

CopyPropertiesTo

CopyPropertiesToNew

CopyPropertiesToNew<T, U>

CopyPropertiesToNewRecursive

MergeInstances

DateOnlyHelpers

DateHelpers Usage Examples

Usage Examples

GetBusinessDays (DateOnly)

GetDayOfWeek (DateOnly)

GetMonthBoundaries (DateOnly)

GetFirstDayOfMonth (DateOnly)

GetLastDayOfMonth (DateOnly)

GetToday (DateOnly)

DateTimeHelpers

DateTimeHelpers Usage Examples

Usage Examples

GetBusinessDays (DateTime)

GetDayOfWeek (DateTime)

GetMonthBoundaries (DateTime)

GetFirstDayOfMonth (DateTime)

GetLastDayOfMonth (DateTime)

IsValidOaDate

DimensionScale

DimensionScale Usage Examples

Usage Examples

ScaleDimensionsToConstraint

ExceptionLocation

ExceptionLocation Usage Examples

Usage Examples

GetLocationOfException

FileHelpers

FileHelpers Usage Examples

Usage Examples

GetSafeSaveName

ValidateFileExtension

GetHashFromFile

GetHashFromStream

GetAllFilesRecursive

CleanFileName

ReadFileFromPipe

Inspect

Inspect Usage Examples

Usage Examples

GetDefaultValue