using System.Text.RegularExpressions;
namespace MeloongCore.Extensions;
public static class StringExtensions {
#region 区域性 / 大小写 简化
///
/// 高速的 StartsWith。
///
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static bool StartsWithF(this string? value, string prefix, bool ignoreCase = false) {
if (value is null) return false;
return value.StartsWith(prefix, ignoreCase ? StringComparison.OrdinalIgnoreCase : StringComparison.Ordinal);
}
///
/// 高速的 EndsWith。
///
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static bool EndsWithF(this string? value, string suffix, bool ignoreCase = false) {
if (value is null) return false;
return value.EndsWith(suffix, ignoreCase ? StringComparison.OrdinalIgnoreCase : StringComparison.Ordinal);
}
///
/// 忽略大小写的 Contains。
///
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static bool ContainsIgnoreCase(this string value, string subString) {
return value.IndexOf(subString, StringComparison.OrdinalIgnoreCase) >= 0;
}
///
/// 高速的 IndexOf。
///
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static int IndexOfF(this string value, string subString, bool ignoreCase = false) {
return value.IndexOf(subString, ignoreCase ? StringComparison.OrdinalIgnoreCase : StringComparison.Ordinal);
}
///
/// 高速的 IndexOf。
///
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static int IndexOfF(this string value, string subString, int startIndex, bool ignoreCase = false) {
return value.IndexOf(subString, startIndex, ignoreCase ? StringComparison.OrdinalIgnoreCase : StringComparison.Ordinal);
}
///
/// 高速的 LastIndexOf。
///
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static int LastIndexOfF(this string value, string subString, bool ignoreCase = false) {
return value.LastIndexOf(subString, ignoreCase ? StringComparison.OrdinalIgnoreCase : StringComparison.Ordinal);
}
///
/// 高速的 LastIndexOf。
///
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static int LastIndexOfF(this string value, string subString, int startIndex, bool ignoreCase = false) {
return value.LastIndexOf(subString, startIndex, ignoreCase ? StringComparison.OrdinalIgnoreCase : StringComparison.Ordinal);
}
///
/// ToLowerInvariant 的简略写法。
///
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static string Lower(this string str) => str.ToLowerInvariant();
///
/// ToUpperInvariant 的简略写法。
///
[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 拆切 / 会得到 2024。
/// 如果未找到子字符串则不裁切。
///
public static string BeforeFirst(this string str, [AllowNull] string text, bool ignoreCase = false) {
int pos = string.IsNullOrEmpty(text) ? -1 : str.IndexOfF(text!, ignoreCase);
if (pos >= 0)
return str.Substring(0, pos);
else
return str;
}
///
/// 获取在子字符串最后一次出现之前的部分,例如对 2024/11/08 拆切 / 会得到 2024/11。
/// 如果未找到子字符串则不裁切。
///
public static string BeforeLast(this string str, [AllowNull] string text, bool ignoreCase = false) {
int pos = string.IsNullOrEmpty(text) ? -1 : str.LastIndexOfF(text!, ignoreCase);
if (pos >= 0)
return str.Substring(0, pos);
else
return str;
}
///
/// 获取在子字符串第一次出现之后的部分,例如对 2024/11/08 拆切 / 会得到 11/08。
/// 如果未找到子字符串则不裁切。
///
public static string AfterFirst(this string str, [AllowNull] string text, bool ignoreCase = false) {
int pos = string.IsNullOrEmpty(text) ? -1 : str.IndexOfF(text!, ignoreCase);
if (pos >= 0)
return str.Substring(pos + text!.Length);
else
return str;
}
///
/// 获取在子字符串最后一次出现之后的部分,例如对 2024/11/08 拆切 / 会得到 08。
/// 如果未找到子字符串则不裁切。
///
public static string AfterLast(this string str, [AllowNull] string text, bool ignoreCase = false) {
int pos = string.IsNullOrEmpty(text) ? -1 : str.LastIndexOfF(text!, ignoreCase);
if (pos >= 0)
return str.Substring(pos + text!.Length);
else
return str;
}
///
/// 获取处于两个子字符串之间的部分,裁切尽可能多的内容。
/// 等效于 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 ReplaceOnDemand(this string str, string oldValue, Func newValue) =>
str.Contains(oldValue) ? str.Replace(oldValue, newValue()) : str;
///
/// 将字符串中的换行符统一替换为指定字符。
/// 若指定了 ,会将多个连续换行符仅替换为一个目标内容。
///
public static string ReplaceLineEndings(this string input, string newValue, bool mergeMultiple = false) =>
Regex.Replace(input,
mergeMultiple ? @"(?:\r\n|[\n\r\f\u0085\u2028\u2029])+" : @"\r\n|[\n\r\f\u0085\u2028\u2029]",
newValue.Replace("$", "$$"), // 避免识别成捕获组
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) {
if (str == null) 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);
}