Numeric and String Extensions

Numeric and String Extensions

Clamp, remap, saturating int math, clock strings, and culture-invariant parsing.

Numeric

using Mane.DotNet;

int hp = damage.Clamp(0, 100);
float t = x.Clamp01();
float ui = health.Remap(0f, maxHp, 0f, 1f); // does not clamp the result
int sum = a.SafePlus(b);                    // saturates on overflow
bool even = n.IsEven();

• Clamp(min, max) — generic IComparable<T>; min > max throws.
• ClampMin / ClampMax — one-sided.
• Clamp01 — float, double, decimal.
• Remap — linear map. Zero-width source range returns destFrom. Result is not clamped to the destination.
• SafePlus / SafeMinus / SafeMultiply — saturating int arithmetic.

TimeSpan

Hours/minutes are total duration, not wrapped mod 24/60. Negative and zero format as zeros.

TimeSpan.FromHours(26).ToHHMMSS(); // 26:00:00
TimeSpan.FromMinutes(90).ToMMSS(); // 90:00
TimeSpan.Zero.ToHHMM();            // 00:00

Strings

Invariant number parsers trim whitespace and apostrophes. The last . or , is the decimal separator; extra marks of the same kind are thousands separators. Null/empty/invalid → defaultValue (no throw). Integers also accept a whole number with a zero fractional part (1.000).

int n = "1.000".ParseIntInvariant();       // 1 — zero fractional part is allowed
float f = "1.234,5".ParseFloatInvariant(); // last comma is decimal → 1234.5
"hello".ToUpperFirst();                    // Hello

int apples = 21;
string label = apples.GetCountedString("яблоко", "яблока", "яблок");

GetCountedString is Slavic-style (count % 100 / % 10): 1, 21 → one; 2–4, 22–24 → many; everything else (0, 5–20, 25, 11–19, …) → more. Null templates throw.