String Helpers

Namespace: ZhonTai.Common.Helpers / ZhonTai

Provides common string operations including null checking, random string generation, Base64 conversion, and string formatting.

StringHelper

Class: StringHelper

Use Cases

• Generating random tokens/invitation codes
• Generating verification codes
• Generating temporary keys

Examples

using ZhonTai.Common.Helpers;

// Generate a 32-character random string (letters + digits)
var token = StringHelper.GenerateRandom();
// "aB3kX9mP2qR7tY1wL5nJ8cF4hG6dS0v"

// Specify length
var token16 = StringHelper.GenerateRandom(16);

// Generate random digits (default 6 digits)
var code = StringHelper.GenerateRandomNumber();
// "385726"

// Specify digit length
var code4 = StringHelper.GenerateRandomNumber(4);

StringExtension

Namespace: ZhonTai (global namespace, available directly in the project)

Use Cases

• Null checking (replaces string.IsNullOrWhiteSpace)
• Case-insensitive string comparison
• Base64 encoding/decoding
• First character case conversion
• Template string formatting

Examples

using ZhonTai; // Import global extensions

// Null checking
string name = null;
name.IsNull();   // true
name.NotNull();  // false

"".IsNull();     // true
" ".IsNull();    // true
"abc".IsNull();  // false

// Case-insensitive comparison
"ABC".EqualsIgnoreCase("abc");  // true

// First character case conversion
"hello".FirstCharToUpper();  // "Hello"
"Hello".FirstCharToLower();  // "hello"

// Base64 encoding
var encoded = "hello".ToBase64();
// "aGVsbG8="
var decoded = System.Convert.FromBase64String(encoded);

// Path conversion (backslash to forward slash)
var path = @"C:\Users\admin".ToPath();
// "C:/Users/admin"

// Template string formatting
var template = "Name: {Name}, Age: {Age}";
var result = template.Format(new { Name = "John", Age = 25 });
// "Name: John, Age: 25"