Oakrey.Strings 2.3.0

Oakrey.Strings

Utilities for string parsing, numeral-system conversion, binary/hex encoding, text/code naming helpers and small string guard exceptions.

Installation

dotnet add package Oakrey.Strings

Package Manager Console:

Install-Package Oakrey.Strings

Binary And Hex

byte[] bytes = "0b1010_0101".FromBinaryStringToByteArray();
string binary = bytes.ToBinaryString(" ");

byte[] hexBytes = "0xA5-FF".FromHexadecimalStringToByteArray();
string hex = hexBytes.ToHexadecimalString(" ");

For user input, prefer the non-throwing helpers:

if (input.TryFromHexadecimalStringToByteArray(out byte[] parsed))
{
    // use parsed bytes
}

Numeric Parsing

The package supports binary, decimal and hexadecimal parsing for common numeric types.

int value = IntParser.Parse("0xFF", NumericParserOption.Hexadecimal);
bool parsed = NumericParser.NumericTryParse<byte>("0b1010", NumericParserOption.Binary, [ByteParser.TryBin], out byte byteValue);

Multiple-numeral-system helpers parse lists with configurable separators and ignore empty parts between repeated separators.

int[] values = "1,, 2;;;0x03".ParseInts([',', ';']);

Text Helpers

string pascal = "hello world".FromTextToPascalCase();
string camel = "hello world".FromTextToCamelCase();
string snake = "Hello World".FromTextToSnakeCase();
string kebab = "Hello World".FromTextToKebabCase();
string slug = "Příliš žluťoučký kůň".FromTextToSlug();

FromTextToSlug removes diacritics and lower-cases words using invariant culture.

Code-to-text helpers convert common identifier shapes back to readable text:

string text = "HttpServerError".FromPascalAndCamelCaseToText();
string name = "hello-world".FromKebabCaseToText();

The older FromKebebCaseToText spelling remains available for compatibility.

StringBuilder And Guards

StringBuilder builder = new();
builder.AppendLines(["first", "second"]);

value.ThrowIfEmpty(nameof(value));
value.ThrowIfWhiteSpace(nameof(value));

Safety Notes

• Binary and hexadecimal converters validate allowed characters before conversion and expose non-throwing variants.
• Numeric try-parse helpers catch expected parse failures and return false instead of leaking conversion exceptions.
• Text casing uses invariant culture where casing is part of formatting behavior.
• StringBuilder extension methods validate null receivers and arguments explicitly.

Project Information

• Author: Oakrey
• Company: Oakrey (Website)
• License: MIT
• Repository: Common
• NuGet: Oakrey.Strings