// ReSharper disable UnusedMember.Global
// ReSharper disable MemberCanBePrivate.Global
#pragma warning disable CA1720
using System.Security.Cryptography;
using System.Text.Json;
using System.Web;
using NSExt.Constant;
namespace NSExt.Extensions;
///
/// StringExtensions
///
#pragma warning disable CodeLinesAnalyzer
public static class StringExtensions
{
///
/// aes加密
///
/// me
/// 密钥
public static string Aes(this string me, string key)
{
using var aes = System.Security.Cryptography.Aes.Create();
aes.Padding = PaddingMode.PKCS7;
aes.Mode = CipherMode.ECB;
aes.Key = key.Hex();
using var encryptor = aes.CreateEncryptor();
var bytes = me.Hex();
var decrypted = encryptor.TransformFinalBlock(bytes, 0, bytes.Length);
return decrypted.Base64();
}
///
/// aes解密
///
/// me
/// 密钥
public static string AesDe(this string me, string key)
{
using var aes = System.Security.Cryptography.Aes.Create();
aes.Padding = PaddingMode.PKCS7;
aes.Mode = CipherMode.ECB;
aes.Key = key.Hex();
using var encryptor = aes.CreateDecryptor();
var bytes = me.Base64De();
var decrypted = encryptor.TransformFinalBlock(bytes, 0, bytes.Length);
return decrypted.HexDe();
}
///
/// base64编码
///
/// me
/// 字符串的编码方式
/// 编码后的base64字符串
public static string Base64(this string me, Encoding e)
{
return e.GetBytes(me).Base64();
}
///
/// base64解码
///
/// me
/// 解码后的原始字节数组
public static byte[] Base64De(this string me)
{
return Convert.FromBase64String(me);
}
///
/// base64解码
///
/// me
/// 字符串的编码方式
/// 解码后的原始字符串
public static string Base64De(this string me, Encoding e)
{
return e.GetString(me.Base64De());
}
///
/// 将易于web传输的base64web字符串转换为原生base64
///
/// 原生base64
public static string Base64Sys(this string me)
{
return me.Replace("-", "+").Replace("_", "/").Replace(".", "=");
}
///
/// 将原生base64字符串转换成易于web传输的字符串
///
/// 易于web传输的字符串
public static string Base64Web(this string me)
{
return me.Replace("+", "-").Replace("/", "_").Replace("=", ".");
}
///
/// 将字符串转换成日期对象
///
/// me
/// 转换后的日期对象
public static DateTime DateTime(this string me)
{
return System.DateTime.Parse(me, CultureInfo.CurrentCulture);
}
///
/// 将字符串转换成日期对象
///
/// me
/// 日期格式
/// 转换后的日期对象
public static DateTime DateTimeExact(this string me, string format)
{
return System.DateTime.ParseExact(me, format, CultureInfo.CurrentCulture);
}
///
/// 将字符串转换成日期对象
///
/// me
/// 日期格式
/// 转换失败时返回的日期对象
/// 转换后的日期对象
public static DateTime DateTimeExactTry(this string me, string format, DateTime def)
{
return !System.DateTime.TryParseExact(me, format, CultureInfo.CurrentCulture, DateTimeStyles.None, out var ret)
? def
: ret;
}
///
/// 将字符串转换成日期对象
///
/// me
/// 转换失败时返回的日期对象
/// 转换后的日期对象
public static DateTime DateTimeTry(this string me, DateTime def)
{
return !System.DateTime.TryParse(me, CultureInfo.InvariantCulture, DateTimeStyles.None, out var ret)
? def
: ret;
}
///
/// string to decimal
///
/// me
/// decimal
public static decimal Dec(this string me)
{
return decimal.Parse(me, CultureInfo.CurrentCulture);
}
///
/// 尝试将字符串转为decimal
///
/// me
/// 转换失败后返回的默认值
/// 转换后的decimal
public static decimal DecTry(this string me, decimal def)
{
return !decimal.TryParse(me, out var ret) ? def : ret;
}
///
/// string to double
///
/// me
/// Int32
public static double Double(this string me)
{
return double.Parse(me, CultureInfo.CurrentCulture);
}
///
/// 将字符串转换成枚举对象
///
public static T Enum(this string name)
where T : Enum
{
return (T)System.Enum.Parse(typeof(T), name, true);
}
///
/// 将字符串转换成枚举对象
///
public static T EnumTry(this string name, T def)
where T : Enum
{
return !System.Enum.TryParse(typeof(T), name, out var ret) ? def : (T)ret;
}
///
/// string to float
///
/// me
/// Int32
public static float Float(this string me)
{
return float.Parse(me, CultureInfo.CurrentCulture);
}
///
/// 将字符串转为guid
///
/// me
public static Guid Guid(this string me)
{
return System.Guid.Parse(me);
}
///
/// 将字符串转换成guid
///
/// me
/// 转换失败的返回值
public static Guid Guid(this string me, Guid def)
{
return System.Guid.TryParse(me, out var ret) ? ret : def;
}
///
/// 将字符串转换成字节数组形式
///
/// me
/// 字符串使用的编码
/// 字节数组
public static byte[] Hex(this string me, Encoding e)
{
return e.GetBytes(me);
}
///
/// 将字符串转换成字节数组形式
///
/// me
/// 字节数组
public static byte[] Hex(this string me)
{
return me.Hex(Encoding.UTF8);
}
///
/// 对一个字符串进行sha1 hash运算
///
/// me
/// 密钥
/// 使用的编码
/// hash摘要的16进制文本形式(无连字符小写)
public static string HmacSha1(this string me, string secret, Encoding e)
{
#pragma warning disable CA5350
using var hmacSha1 = new HMACSHA1(e.GetBytes(secret));
#pragma warning restore CA5350
#if NET9_0_OR_GREATER
return Convert.ToHexStringLower(hmacSha1.ComputeHash(e.GetBytes(me)));
#else
return BitConverter.ToString(hmacSha1.ComputeHash(e.GetBytes(me)))
.Replace("-", string.Empty)
.ToLower(CultureInfo.CurrentCulture);
#endif
}
///
/// html编码
///
public static string Html(this string me)
{
return HttpUtility.HtmlEncode(me);
}
///
/// 解码html编码
///
/// me
/// 解码后的原始字符串
public static string HtmlDe(this string me)
{
return HttpUtility.HtmlDecode(me);
}
///
/// string to Int32
///
/// me
/// Int32
public static int Int32(this string me)
{
return int.Parse(me, CultureInfo.CurrentCulture);
}
///
/// 尝试将字符串转为int32
///
/// me
/// 转换失败后返回的默认值
/// 转换后的int32
public static int Int32Try(this string me, int def)
{
return !int.TryParse(me, out var ret) ? def : ret;
}
///
/// string to Int64
///
/// me
/// Int64
public static long Int64(this string me)
{
return long.Parse(me, CultureInfo.CurrentCulture);
}
///
/// 尝试将字符串转为int64
///
/// me
/// 转换失败后返回的默认值
/// 转换后的int64
public static long Int64Try(this string me, long def)
{
return !long.TryParse(me, out var ret) ? def : ret;
}
///
/// ipv4格式转int32格式
///
public static int IpV4ToInt32(this string me)
{
return BitConverter.ToInt32(me.Split('.').Select(byte.Parse).Reverse().ToArray(), 0);
}
///
/// 是否base64字符串
///
/// me
public static bool IsBase64String(this string me)
{
// 一个合法的Base64,有着以下特征:
// 字符串的长度为4的整数倍。
// 字符串的符号取值只能在A -Z, a -z, 0 -9, +, /, =共计65个字符中,且 = 如果出现就必须在结尾出现。
if (!me.All(x => x.IsBase64Character())) {
return false;
}
if (me.Length % 4 != 0) {
return false;
}
var firstEqualSignPos = me.IndexOf('=');
if (firstEqualSignPos < 0) {
return true;
}
var lastEqualSignPos = me.LastIndexOf('=');
return lastEqualSignPos == me.Length - 1 && me[firstEqualSignPos..lastEqualSignPos].All(x => x == '=');
}
///
/// 是否json字符串
///
/// me
public static bool IsJsonString(this string me)
{
if (me.NullOrEmpty()) {
return false;
}
try {
_ = JsonDocument.Parse(me);
}
catch {
return false;
}
return true;
}
///
/// 中文姓名打马赛克
///
public static string MaskChineseName(this string me)
{
return me.Length == 2 ? "*" + me[1..] : me[..1] + "*" + me[^1..];
}
///
/// 对一个手机号进行掩码处理
///
/// me
/// 掩码后的手机号
public static string MaskMobile(this string me)
{
return Regexes.RegexMobile.Replace(me, "$1****$2");
}
///
/// 对一个字符串进行md5hash运算
///
/// me
/// 字符串使用的编码
/// hash摘要的16进制文本形式(无连字符小写)
public static string Md5(this string me, Encoding e)
{
#pragma warning disable CA5351
#if NET9_0_OR_GREATER
return Convert.ToHexStringLower(MD5.HashData(e.GetBytes(me)));
#else
return BitConverter.ToString(MD5.HashData(e.GetBytes(me)))
#pragma warning restore CA5351
.Replace("-", string.Empty)
.ToLower(CultureInfo.CurrentCulture);
#endif
}
///
/// 判断字符串是否为null或不存在子元素(如果为集合对象);如果为空,返回指定的默认值,否则返回字符串本身
///
/// me
/// 指定的默认值
/// 如果为空,返回指定的默认值,否则返回字符串本身
public static string NullOrEmpty(this string me, string defVal)
{
return me.AsEnumerable().NullOrEmpty() ? defVal : me;
}
///
/// null或空白字符
///
public static bool NullOrWhiteSpace(this string me)
{
return string.IsNullOrWhiteSpace(me);
}
///
/// 反序列化一个文件获得指定类型的数据对象
///
/// me
/// 序列化选项
/// 反序列化后生成的对象
public static T Object(this string me, JsonSerializerOptions options = null)
{
return JsonSerializer.Deserialize(me, options);
}
///
/// 反序列化一个文件获得指定类型的数据对象
///
/// me
/// 实际类型
/// 序列化选项
/// 反序列化后生成的对象
public static object Object(this string me, Type type, JsonSerializerOptions options = null)
{
return JsonSerializer.Deserialize(me, type, options);
}
///
/// 生成密码
///
/// me
/// 密文
public static string Pwd(this string me)
{
return me.Md5Hmac(me.Md5(Encoding.UTF8), Encoding.UTF8);
}
///
/// 移除字符串中的html标签
///
/// me
/// 处理之后的字符串
public static string RemoveHtmlTag(this string me)
{
return Regexes.RegexHtmlTag.Replace(me, string.Empty);
}
///
/// 删除换行符
///
public static string RemoveWrapped(this string me)
{
return me.Replace("\r", string.Empty).Replace("\n", string.Empty);
}
///
/// 对一个字符串进行sha1 hash运算
///
/// me
/// 字符串使用的编码
/// hash摘要的16进制文本形式(无连字符小写)
public static string Sha1(this string me, Encoding e)
{
#pragma warning disable CA5350
#if NET9_0_OR_GREATER
return Convert.ToHexStringLower(SHA1.HashData(e.GetBytes(me)));
#else
return BitConverter.ToString(SHA1.HashData(e.GetBytes(me)))
#pragma warning restore CA5350
.Replace("-", string.Empty)
.ToLower(CultureInfo.CurrentCulture);
#endif
}
///
/// 蛇形命名
///
public static string SnakeCase(this string me)
{
return Regexes.RegexUpLetter.Replace(me, "-$1").ToLower(CultureInfo.InvariantCulture).TrimStart('-');
}
///
/// 截取指定长度的字符串,代替substring
///
public static string Sub(this string me, int startIndex, int length)
{
if (startIndex + length > me.Length) {
length = me.Length - startIndex;
}
return me.Substring(startIndex, length);
}
///
/// 纯文本字符串转html
///
public static string Text2Html(this string me)
{
return $"{me}
";
}
///
/// 首字母小写
///
public static string ToLowerCamelCase(this string me)
{
return string.IsNullOrWhiteSpace(me)
? me
: string.Concat( //
me[0].ToString(CultureInfo.InvariantCulture).ToLowerInvariant(), me.AsSpan(1));
}
///
/// 首字母大写
///
public static string ToUpperCamelCase(this string me)
{
return string.IsNullOrWhiteSpace(me) ? me : string.Concat(me[0].ToString().ToUpperInvariant(), me.AsSpan(1));
}
///
/// 将连续多个空格替换成一个空格
///
public static string TrimSpaces(this string me)
{
var ret = me.Replace(" ", " ");
// ReSharper disable once TailRecursiveCall
return ret == me ? ret : ret.TrimSpaces();
}
///
/// 将\ux0000 、 %u0000 、 � 编码转换成可读字符串
///
public static string UnicodeDe(this string me)
{
const string replacement = "$1;";
if (me.Contains(@"\u")) {
return Regexes.RegexBacksLantUnicode.Replace(me, replacement).HtmlDe();
}
// ReSharper disable once ConvertIfStatementToReturnStatement
#pragma warning disable IDE0046
if (me.Contains("%u")) {
#pragma warning restore IDE0046
return Regexes.RegexPercentUnicode.Replace(me, replacement).HtmlDe();
}
return me.HtmlDe();
}
///
/// url编码
///
/// me
/// url编码后的字符串
public static string Url(this string me)
{
return Uri.EscapeDataString(me);
}
///
/// 解码url编码
///
/// me
/// 解码后的原始字符串
public static string UrlDe(this string me)
{
return Uri.UnescapeDataString(me);
}
///
/// MD5 hmac编码
///
/// me
/// 密钥
/// 字符串使用的编码
/// hash摘要的16进制文本形式(无连字符小写)
private static string Md5Hmac(this string me, string key, Encoding e)
{
#pragma warning disable CA5351
using var md5Hmac = new HMACMD5(e.GetBytes(key));
#pragma warning restore CA5351
#if NET9_0_OR_GREATER
return Convert.ToHexStringLower(md5Hmac.ComputeHash(e.GetBytes(me)));
#else
return BitConverter.ToString(md5Hmac.ComputeHash(e.GetBytes(me)))
.Replace("-", string.Empty)
.ToLower(CultureInfo.CurrentCulture);
#endif
}
}
#pragma warning restore CodeLinesAnalyzer