using System.Text.RegularExpressions;
namespace MeloongCore.Extensions;
public static class StringExtensions {
#region 区域性 / 大小写 简化
///
/// 非区域性的 。
///
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static bool StartsWithF(this string? value, string prefix, bool ignoreCase = false)
=> value?.StartsWith(prefix, ignoreCase ? StringComparison.OrdinalIgnoreCase : StringComparison.Ordinal) ?? false;
///
/// 判断字符串是否以 开头。
///
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static bool StartsWithF(this string? value, char prefix, bool ignoreCase = false)
=> value?.StartsWith(prefix.ToString(), ignoreCase ? StringComparison.OrdinalIgnoreCase : StringComparison.Ordinal) ?? false;
///
/// 非区域性的 。
///
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static bool EndsWithF(this string? value, string suffix, bool ignoreCase = false)
=> value?.EndsWith(suffix, ignoreCase ? StringComparison.OrdinalIgnoreCase : StringComparison.Ordinal) ?? false;
///
/// 判断字符串是否以 结尾。
///
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static bool EndsWithF(this string? value, char suffix, bool ignoreCase = false)
=> value?.EndsWith(suffix.ToString(), ignoreCase ? StringComparison.OrdinalIgnoreCase : StringComparison.Ordinal) ?? false;
///
/// 忽略大小写的 。
///
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static bool ContainsIgnoreCase(this string value, string subString)
=> value.IndexOf(subString, StringComparison.OrdinalIgnoreCase) >= 0;
///
/// 非区域性的 。
///
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static int IndexOfF(this string value, string subString, bool ignoreCase = false)
=> value.IndexOf(subString, ignoreCase ? StringComparison.OrdinalIgnoreCase : StringComparison.Ordinal);
///
/// 非区域性的 。
///
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static int IndexOfF(this string value, string subString, int startIndex, bool ignoreCase = false)
=> value.IndexOf(subString, startIndex, ignoreCase ? StringComparison.OrdinalIgnoreCase : StringComparison.Ordinal);
///
/// 非区域性的 。
///
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static int LastIndexOfF(this string value, string subString, bool ignoreCase = false)
=> value.LastIndexOf(subString, ignoreCase ? StringComparison.OrdinalIgnoreCase : StringComparison.Ordinal);
///
/// 非区域性的 。
///
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static int LastIndexOfF(this string value, string subString, int startIndex, bool ignoreCase = false)
=> value.LastIndexOf(subString, startIndex, ignoreCase ? StringComparison.OrdinalIgnoreCase : StringComparison.Ordinal);
///
/// 的简略写法。
///
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static string Lower(this string str)
=> str.ToLowerInvariant();
///
/// 的简略写法。
///
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static string Upper(this string str)
=> str.ToUpperInvariant();
#endregion
#region 分割与裁切
///
/// 分割字符串。
/// 若原始字符串为空,则返回 {""}。
///
public static string[] Split(this string fullStr, string splitStr) {
if (splitStr.IsSingle()) {
return fullStr.Split(splitStr[0]);
} else {
return fullStr.Split([splitStr], StringSplitOptions.None);
}
}
///
/// 获取在子字符串第一次出现之前的部分,如果未找到子字符串则不裁切。
/// "2024/11/08".BeforeFirst("/") => "2024"
///
public static string BeforeFirst(this string str, string text, bool ignoreCase = false) {
int pos = string.IsNullOrEmpty(text) ? -1 : str.IndexOfF(text!, ignoreCase);
if (pos < 0) return str;
return str.Substring(0, pos);
}
///
/// 获取在子字符串最后一次出现之前的部分,如果未找到子字符串则不裁切。
/// "2024/11/08".BeforeLast("/") => "2024/11"
///
public static string BeforeLast(this string str, string text, bool ignoreCase = false) {
int pos = string.IsNullOrEmpty(text) ? -1 : str.LastIndexOfF(text!, ignoreCase);
if (pos < 0) return str;
return str.Substring(0, pos);
}
///
/// 获取在子字符串第一次出现之后的部分,如果未找到子字符串则不裁切。
/// "2024/11/08".AfterFirst("/") => "11/08"
///
public static string AfterFirst(this string str, string text, bool ignoreCase = false) {
int pos = string.IsNullOrEmpty(text) ? -1 : str.IndexOfF(text!, ignoreCase);
if (pos < 0) return str;
return str.Substring(pos + text!.Length);
}
///
/// 获取在子字符串最后一次出现之后的部分,如果未找到子字符串则不裁切。
/// "2024/11/08".AfterLast("/") => "08"
///
public static string AfterLast(this string str, string text, bool ignoreCase = false) {
int pos = string.IsNullOrEmpty(text) ? -1 : str.LastIndexOfF(text!, ignoreCase);
if (pos < 0) return str;
return str.Substring(pos + text!.Length);
}
///
/// 获取处于两个子字符串之间的部分,裁切尽可能多的内容。
/// 等效于 AfterLast 后接 BeforeFirst。
/// 如果未找到子字符串则不裁切。
///
public static string Between(this string str, string after, string before, bool ignoreCase = false) {
int startPos = string.IsNullOrEmpty(after) ? -1 : str.LastIndexOfF(after, ignoreCase);
if (startPos >= 0) {
startPos += after.Length;
} else {
startPos = 0;
}
int endPos = string.IsNullOrEmpty(before) ? -1 : str.IndexOfF(before, startPos, ignoreCase);
if (endPos >= 0) {
return str.Substring(startPos, endPos - startPos);
} else if (startPos > 0) {
return str.Substring(startPos);
} else {
return str;
}
}
#endregion
#region 替换
///
/// 替换字符串中的内容。
/// 仅当需要替换时,才调用 获取结果字符串。
///
public static string Replace(this string str, string oldValue, Func newValueGetter)
=> str.Contains(oldValue) ? str.Replace(oldValue, newValueGetter()) : str;
///
/// 将字符串中的换行符统一替换为指定字符。
/// 若指定了 ,会将多个连续换行符仅替换为一个目标内容。
///
public static string ReplaceLineEndings(this string input, string newValue, bool mergeMultiple = false)
=> (mergeMultiple ? regexLineEndingAndMerge : regexLineEnding).Replace(input, newValue.Replace("$", "$$")); // 避免识别成捕获组
private static readonly Regex regexLineEndingAndMerge = new(@"(?:\r\n|[\n\r\f\u0085\u2028\u2029])+", RegexOptions.Compiled);
private static readonly Regex regexLineEnding = new(@"\r\n|[\n\r\f\u0085\u2028\u2029]", RegexOptions.Compiled);
#endregion
///
/// 将第一个字符转换为大写,其余字符转换为小写。
///
public static string Capitalize(this string word) {
if (string.IsNullOrEmpty(word)) return word;
return $"{word.Substring(0, 1).Upper()}{word.Substring(1).Lower()}";
}
///
/// 将字符串统一至某个长度。
/// 过短则用 将其左侧填充,过长则截取靠左的指定长度。
///
public static string EnsureLength(this string? str, char code, int length) {
str ??= "";
return str.Length > length ? str.Substring(0, length) : str.PadLeft(length, code);
}
///
/// 该字符串中的字符是否均为 ASCII 字符。
///
public static bool IsAsciiOnly(this string input)
=> input.All(c => c < 128);
}