JiShe.CollectBus/shared/JiShe.CollectBus.Common/Extensions/StringExtensions.cs

using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Drawing;
using System.Globalization;
using System.IO;
using System.Linq;
using System.Security;
using System.Security.Cryptography;
using System.Text;
using System.Text.RegularExpressions;
using JiShe.CollectBus.Common.Consts;
using JiShe.CollectBus.Common.Enums;
using Newtonsoft.Json;

namespace JiShe.CollectBus.Common.Extensions
{
    public static class StringExtensions
    {
        private const string IPV4_REGEX = @"^((25[0-5]|2[0-4]\d|[01]?\d\d?)\.){3}(25[0-5]|2[0-4]\d|[01]?\d\d?)$";
        // 正则表达式用于验证端口号格式（1到65535）
        private const string PORT_REGEX = @"^([1-9]\d{0,4}|[1-5]\d{4}|6[0-4]\d{3}|65[0-4]\d{2}|655[0-2]\d|6553[0-5])$";

        /// <summary>Determines whether [is null or empty].</summary>
        /// <param name="str">The string.</param>
        /// <returns>
        ///   <c>true</c> if [is null or empty] [the specified string]; otherwise, <c>false</c>.</returns>
        [Description("检查是否为NULL或空")]
        public static bool IsNullOrEmpty(this string str)
        {
            return string.IsNullOrEmpty(str);
        }

        /// <summary>Copies the specified string.</summary>
        /// <param name="str">The string.</param>
        /// <returns>
        ///   <br />
        /// </returns>
        [Description("复制")]
        public static string Copy(this string str)
        {
            return string.Copy(str);
        }

        /// <summary>Regex Match the specified pattern.</summary>
        /// <param name="str">The string.</param>
        /// <param name="pattern">The pattern.</param>
        /// <returns>
        ///   <br />
        /// </returns>
        [Description("正则匹配单个")]
        public static string? RegexMatch(this string str, string pattern)
        {
            var reg = new Regex(pattern);
            var match = reg.Match(str);
            if (match.Success)
            {
                return match.Value;
            }
            return null;
        }

        /// <summary>Regex Matches the specified pattern.</summary>
        /// <param name="str">The string.</param>
        /// <param name="pattern">The pattern.</param>
        /// <returns>
        ///   <br />
        /// </returns>
        [Description("正则匹配多个")]
        public static List<string> RegexMatches(this string str, string pattern)
        {
            var reg = new Regex(pattern);
            var matches = reg.Matches(str);
            return (from Match item in matches select item.Value).ToList();
        }

        /// <summary>Converts the string representation of a number to an integer.</summary>
        /// <param name="str">The string.</param>
        /// <returns>
        ///   <br />
        /// </returns>
        [Description("String转换Int")]
        public static int ToInt(this string str)
        {
            return int.Parse(str);
        }

        /// <summary>Converts to decimal.</summary>
        /// <param name="str">The string.</param>
        /// <returns>
        ///   <br />
        /// </returns>
        [Description("String转换Decimal")]
        public static decimal ToDecimal(this string str)
        {
            return decimal.Parse(str);
        }

        /// <summary>Determines whether this instance is numeric.</summary>
        /// <param name="str">The string.</param>
        /// <returns>
        ///   <c>true</c> if the specified string is numeric; otherwise, <c>false</c>.</returns>
        [Description("是否为数字")]
        public static bool IsNumeric(this string str)
        {
            var regex = new Regex(RegexConst.IsNumeric);
            return regex.IsMatch(str);
        }

        /// <summary>Determines whether the specified value is contains.</summary>
        /// <param name="str">The string.</param>
        /// <param name="value">The value.</param>
        /// <returns>
        ///   <c>true</c> if the specified value is contains; otherwise, <c>false</c>.</returns>
        [Description("是否包含")]
        public static bool IsContains(this string str, string value)
        {
            return str.IndexOf(value, StringComparison.Ordinal) >= 0;
        }

        /// <summary>Ins the specified string values.</summary>
        /// <param name="str">The string.</param>
        /// <param name="stringValues">The string values.</param>
        /// <returns>
        ///   <br />
        /// </returns>
        [Description("是否存在数组中")]
        public static bool In(this string str, params string[] stringValues)
        {
            foreach (string otherValue in stringValues)
                if (string.CompareOrdinal(str, otherValue) == 0)
                    return true;

            return false;
        }

        /// <summary>Formats the specified arg0.</summary>
        /// <param name="str">The string.</param>
        /// <param name="arg0">The arg0.</param>
        /// <returns>
        ///   <br />
        /// </returns>
        [Description("格式化")]
        public static string Format(this string str, object arg0)
        {
            return string.Format(str, arg0);
        }

        /// <summary>Formats the specified arguments.</summary>
        /// <param name="str">The string.</param>
        /// <param name="args">The arguments.</param>
        /// <returns>
        ///   <br />
        /// </returns>
        public static string Format(this string str, params object[] args)
        {
            return string.Format(str, args);
        }

        /// <summary>Encrypts the specified key.</summary>
        /// <param name="str">The string.</param>
        /// <param name="key">The key.</param>
        /// <returns>
        ///   <br />
        /// </returns>
        /// <exception cref="ArgumentException">An empty string value cannot be encrypted.
        /// or
        /// Cannot encrypt using an empty key. Please supply an encryption key.</exception>
        [Description("RSA加密")]
        public static string Encrypt(this string str, string key)
        {
            if (string.IsNullOrEmpty(str))
            {
                throw new ArgumentException("An empty string value cannot be encrypted.");
            }
            if (string.IsNullOrEmpty(key))
            {
                throw new ArgumentException("Cannot encrypt using an empty key. Please supply an encryption key.");
            }
            var cspParameters = new CspParameters { KeyContainerName = key };
            var rsa = new RSACryptoServiceProvider(cspParameters) { PersistKeyInCsp = true };
            var bytes = rsa.Encrypt(Encoding.UTF8.GetBytes(str), true);
            return BitConverter.ToString(bytes);
        }

        /// <summary>Decrypts the specified key.</summary>
        /// <param name="str">The string.</param>
        /// <param name="key">The key.</param>
        /// <returns>
        ///   <br />
        /// </returns>
        /// <exception cref="ArgumentException">An empty string value cannot be encrypted.
        /// or
        /// Cannot decrypt using an empty key. Please supply a decryption key.</exception>
        [Description("RSA解密")]
        public static string Decrypt(this string str, string key)
        {
            string result = null;
            if (string.IsNullOrEmpty(str))
            {
                throw new ArgumentException("An empty string value cannot be encrypted.");
            }
            if (string.IsNullOrEmpty(key))
            {
                throw new ArgumentException("Cannot decrypt using an empty key. Please supply a decryption key.");
            }
            var cspParameters = new CspParameters { KeyContainerName = key };
            var rsa = new RSACryptoServiceProvider(cspParameters) { PersistKeyInCsp = true };
            var decryptArray = str.Split(new string[] { "-" }, StringSplitOptions.None);
            var decryptByteArray = Array.ConvertAll<string, byte>(decryptArray, (s => Convert.ToByte(byte.Parse(s, System.Globalization.NumberStyles.HexNumber))));
            var bytes = rsa.Decrypt(decryptByteArray, true);
            result = Encoding.UTF8.GetString(bytes);
            return result;
        }

        /// <summary>Firsts to upper.</summary>
        /// <param name="str">The string.</param>
        /// <returns>
        ///   <br />
        /// </returns>
        [Description("首字母大写")]
        public static string FirstToUpper(this string str)
        {
            if (string.IsNullOrEmpty(str))
            {
                return string.Empty;
            }

            var theChars = str.ToCharArray();
            theChars[0] = char.ToUpper(theChars[0]);
            return new string(theChars);
        }

        /// <summary>Converts to securestring.</summary>
        /// <param name="str">The string.</param>
        /// <returns>
        ///   <br />
        /// </returns>
        [Description("转换为安全字符串")]
        public static SecureString ToSecureString(this string str)
        {
            var secureString = new SecureString();
            foreach (var c in str)
                secureString.AppendChar(c);

            return secureString;
        }

        /// <summary>Determines whether this instance is date.</summary>
        /// <param name="str">The string.</param>
        /// <returns>
        ///   <c>true</c> if the specified string is date; otherwise, <c>false</c>.</returns>
        [Description("转换为日期")]
        public static bool IsDate(this string str)
        {
            return !string.IsNullOrEmpty(str) && DateTime.TryParse(str, out _);
        }

        /// <summary>Determines whether [is email address].</summary>
        /// <param name="str">The string.</param>
        /// <returns>
        ///   <c>true</c> if [is email address] [the specified string]; otherwise, <c>false</c>.</returns>
        [Description("是否为邮箱地址")]
        public static bool IsEmailAddress(this string str)
        {
            var regex = new Regex(RegexConst.Email);
            return regex.IsMatch(str);
        }

        /// <summary>Parses the specified string.</summary>
        /// <typeparam name="T"></typeparam>
        /// <param name="str">The string.</param>
        /// <returns>
        ///   <br />
        /// </returns>
        [Description("转换为任何格式")]
        public static T Parse<T>(this string str)
        {
            var result = default(T);
            if (!string.IsNullOrEmpty(str))
            {
                var tc = TypeDescriptor.GetConverter(typeof(T));
                result = (T)tc.ConvertFrom(str);
            }
            return result;
        }

        /// <summary>Determines whether this instance is unique identifier.</summary>
        /// <param name="str">The string.</param>
        /// <returns>
        ///   <c>true</c> if the specified string is unique identifier; otherwise, <c>false</c>.</returns>
        /// <exception cref="ArgumentNullException"></exception>
        [Description("是否为Guid")]
        public static bool IsGuid(this string str)
        {
            if (str == null)
                throw new ArgumentNullException();

            var format = new Regex(
                "^[A-Fa-f0-9]{32}$|" +
                "^({|\\()?[A-Fa-f0-9]{8}-([A-Fa-f0-9]{4}-){3}[A-Fa-f0-9]{12}(}|\\))?$|" +
                "^({)?[0xA-Fa-f0-9]{3,10}(, {0,1}[0xA-Fa-f0-9]{3,6}){2}, {0,1}({)([0xA-Fa-f0-9]{3,4}, {0,1}){7}[0xA-Fa-f0-9]{3,4}(}})$");
            var match = format.Match(str);
            return match.Success;
        }

        /// <summary>Determines whether this instance is URL.</summary>
        /// <param name="str">The string.</param>
        /// <returns>
        ///   <c>true</c> if the specified string is URL; otherwise, <c>false</c>.</returns>
        [Description("是否为地址")]
        public static bool IsUrl(this string str)
        {
            var regex = new Regex(RegexConst.Url);
            return regex.IsMatch(str);
        }

        /// <summary>Masks the specified number exposed.</summary>
        /// <param name="str">The string.</param>
        /// <param name="numExposed">The number exposed.</param>
        /// <param name="maskChar">The mask character.</param>
        /// <param name="type">The type.</param>
        /// <returns>
        ///   <br />
        /// </returns>
        [Description("屏蔽字符，如：123***789")]
        public static string Mask(this string str, int numExposed, char maskChar = '*', MaskTypeEnum type = MaskTypeEnum.All)
        {
            var maskedString = str;

            if (str.IsLengthAtLeast(numExposed))
            {
                var builder = new StringBuilder(str.Length);
                int index = maskedString.Length - numExposed;

                if (type == MaskTypeEnum.AlphaNumericOnly)
                {
                    CreateAlphaNumMask(builder, str, maskChar, index);
                }
                else
                {
                    builder.Append(maskChar, index);
                }

                builder.Append(str.Substring(index));
                maskedString = builder.ToString();
            }

            return maskedString;
        }

        /// <summary>
        /// Masks the mobile.
        /// </summary>
        /// <param name="mobile">The mobile.</param>
        /// <returns></returns>
        [Description("屏蔽手机号")]
        public static string MaskMobile(this string mobile)
        {
            if (!mobile.IsNullOrEmpty() && mobile.Length > 7)
            {
                var regex = new Regex(@"(?<=\d{3}).+(?=\d{4})", RegexOptions.IgnoreCase);
                mobile = regex.Replace(mobile, "****");
            }

            return mobile;
        }

        /// <summary>
        /// Masks the identifier card.
        /// </summary>
        /// <param name="idCard">The identifier card.</param>
        /// <returns></returns>
        [Description("屏蔽身份证")]
        public static string MaskIdCard(this string idCard)
        {
            if (!idCard.IsNullOrEmpty() && idCard.Length > 10)
            {
                var regex = new Regex(@"(?<=\w{6}).+(?=\w{4})", RegexOptions.IgnoreCase);
                idCard = regex.Replace(idCard, "********");
            }

            return idCard;
        }

        /// <summary>
        /// Masks the bank card.
        /// </summary>
        /// <param name="bankCard">The bank card.</param>
        /// <returns></returns>
        [Description("屏蔽银行卡")]
        public static string MaskBankCard(this string bankCard)
        {
            if (!bankCard.IsNullOrEmpty() && bankCard.Length > 4)
            {
                var regex = new Regex(@"(?<=\d{4})\d+(?=\d{4})", RegexOptions.IgnoreCase);
                bankCard = regex.Replace(bankCard, " **** **** ");
            }

            return bankCard;
        }

        /// <summary>Determines whether [is length at least] [the specified length].</summary>
        /// <param name="str">The string.</param>
        /// <param name="length">The length.</param>
        /// <returns>
        ///   <c>true</c> if [is length at least] [the specified length]; otherwise, <c>false</c>.</returns>
        /// <exception cref="ArgumentOutOfRangeException">length - The length must be a non-negative number.</exception>
        [Description("判断是否为最后一位字符")]
        public static bool IsLengthAtLeast(this string str, int length)
        {
            if (length < 0)
            {
                throw new ArgumentOutOfRangeException(nameof(length), length,
                    "The length must be a non-negative number.");
            }

            return str != null && str.Length >= length;
        }

        /// <summary>Determines whether [is strong password].</summary>
        /// <param name="str">The string.</param>
        /// <returns>
        ///   <c>true</c> if [is strong password] [the specified string]; otherwise, <c>false</c>.</returns>
        [Description("判断是否为强壮密码")]
        public static bool IsStrongPassword(this string str)
        {
            var isStrong = Regex.IsMatch(str, @"[\d]");
            if (isStrong) isStrong = Regex.IsMatch(str, @"[a-z]");
            if (isStrong) isStrong = Regex.IsMatch(str, @"[A-Z]");
            if (isStrong) isStrong = Regex.IsMatch(str, @"[\s~!@#\$%\^&\*\(\)\{\}\|\[\]\\:;'?,.`+=<>\/]");
            if (isStrong) isStrong = str.Length > 7;
            return isStrong;
        }

        /// <summary>Determines whether [is match regex] [the specified pattern].</summary>
        /// <param name="str">The string.</param>
        /// <param name="pattern">The pattern.</param>
        /// <returns>
        ///   <c>true</c> if [is match regex] [the specified pattern]; otherwise, <c>false</c>.</returns>
        [Description("是否正则匹配通过")]
        public static bool IsMatchRegex(this string str, string pattern)
        {
            var regex = new Regex(pattern);
            return regex.IsMatch(str);
        }

        /// <summary>Converts to bytes.</summary>
        /// <param name="fileName">Name of the file.</param>
        /// <returns>
        ///   <br />
        /// </returns>
        /// <exception cref="FileNotFoundException"></exception>
        [Description("文件物理地址转换为字节数组")]
        public static byte[] ToBytes(this string fileName)
        {
            if (!File.Exists(fileName))
                throw new FileNotFoundException(fileName);

            return File.ReadAllBytes(fileName);
        }

        /// <summary>Converts to color.</summary>
        /// <param name="rgb">The RGB.</param>
        /// <returns>
        ///   <br />
        /// </returns>
        [Description("转换为Color")]
        public static Color ToColor(this string rgb)
        {
            rgb = rgb.Replace("#", "");
            var a = Convert.ToByte("ff", 16);
            byte pos = 0;
            if (rgb.Length == 8)
            {
                a = Convert.ToByte(rgb.Substring(pos, 2), 16);
                pos = 2;
            }
            var r = Convert.ToByte(rgb.Substring(pos, 2), 16);
            pos += 2;
            var g = Convert.ToByte(rgb.Substring(pos, 2), 16);
            pos += 2;
            var b = Convert.ToByte(rgb.Substring(pos, 2), 16);
            return Color.FromArgb(a, r, g, b);
        }

        /// <summary>
        /// Adds a char to end of given string if it does not ends with the char.
        /// </summary>
        [Description("如果给定字符串不以[char]结尾，则在其结尾添加[char]")]
        public static string EnsureEndsWith(this string str, char c)
        {
            return EnsureEndsWith(str, c, StringComparison.Ordinal);
        }

        /// <summary>
        /// Adds a char to end of given string if it does not ends with the char.
        /// </summary>
        public static string EnsureEndsWith(this string str, char c, StringComparison comparisonType)
        {
            if (str == null)
            {
                throw new ArgumentNullException(nameof(str));
            }

            if (str.EndsWith(c.ToString(), comparisonType))
            {
                return str;
            }

            return str + c;
        }

        /// <summary>
        /// Adds a char to end of given string if it does not ends with the char.
        /// </summary>
        public static string EnsureEndsWith(this string str, char c, bool ignoreCase, CultureInfo culture)
        {
            if (str == null)
            {
                throw new ArgumentNullException(nameof(str));
            }

            if (str.EndsWith(c.ToString(culture), ignoreCase, culture))
            {
                return str;
            }

            return str + c;
        }

        /// <summary>
        /// Adds a char to beginning of given string if it does not starts with the char.
        /// </summary>
        [Description("如果给定字符串不以[char]开头，则在其开头添加[char]")]
        public static string EnsureStartsWith(this string str, char c)
        {
            return EnsureStartsWith(str, c, StringComparison.Ordinal);
        }

        /// <summary>
        /// Adds a char to beginning of given string if it does not starts with the char.
        /// </summary>
        public static string EnsureStartsWith(this string str, char c, StringComparison comparisonType)
        {
            if (str == null)
            {
                throw new ArgumentNullException(nameof(str));
            }

            if (str.StartsWith(c.ToString(), comparisonType))
            {
                return str;
            }

            return c + str;
        }

        /// <summary>
        /// Adds a char to beginning of given string if it does not starts with the char.
        /// </summary>
        public static string EnsureStartsWith(this string str, char c, bool ignoreCase, CultureInfo culture)
        {
            if (str == null)
            {
                throw new ArgumentNullException(nameof(str));
            }

            if (str.StartsWith(c.ToString(culture), ignoreCase, culture))
            {
                return str;
            }

            return c + str;
        }

        /// <summary>
        /// Gets a substring of a string from beginning of the string.
        /// </summary>
        /// <exception cref="ArgumentNullException">Thrown if <paramref name="str"/> is null</exception>
        /// <exception cref="ArgumentException">Thrown if <paramref name="len"/> is bigger that string's length</exception>
        [Description("从字符串的开头获取指定长度字符串")]
        public static string Left(this string str, int len)
        {
            if (str == null)
            {
                throw new ArgumentNullException(nameof(str));
            }

            if (str.Length < len)
            {
                throw new ArgumentException("len argument can not be bigger than given string's length!");
            }

            return str.Substring(0, len);
        }

        /// <summary>
        /// Converts line endings in the string to <see cref="Environment.NewLine"/>.
        /// </summary>
        [Description("将字符串中的行尾转换为Environment.NewLine")]
        public static string NormalizeLineEndings(this string str)
        {
            return str.Replace("\r\n", "\n").Replace("\r", "\n").Replace("\n", Environment.NewLine);
        }

        /// <summary>
        /// Gets index of nth occurence of a char in a string.
        /// </summary>
        /// <param name="str">source string to be searched</param>
        /// <param name="c">Char to search in <paramref name="str"/></param>
        /// <param name="n">Count of the occurence</param>
        [Description("获取字符串中第n个字符的索引")]
        public static int NthIndexOf(this string str, char c, int n)
        {
            if (str == null)
            {
                throw new ArgumentNullException(nameof(str));
            }

            var count = 0;
            for (var i = 0; i < str.Length; i++)
            {
                if (str[i] != c)
                {
                    continue;
                }

                if ((++count) == n)
                {
                    return i;
                }
            }

            return -1;
        }

        /// <summary>
        /// Removes first occurrence of the given postfixes from end of the given string.
        /// Ordering is important. If one of the postFixes is matched, others will not be tested.
        /// </summary>
        /// <param name="str">The string.</param>
        /// <param name="postFixes">one or more postfix.</param>
        /// <returns>Modified string or the same string if it has not any of given postfixes</returns>
        [Description("从给定字符串的末尾删除第一个出现的给定后缀")]
        public static string RemovePostFix(this string str, params string[] postFixes)
        {
            if (str == null)
            {
                return null;
            }

            if (string.IsNullOrEmpty(str))
            {
                return string.Empty;
            }

            if (postFixes.IsNullOrEmpty())
            {
                return str;
            }

            foreach (var postFix in postFixes)
            {
                if (str.EndsWith(postFix))
                {
                    return str.Left(str.Length - postFix.Length);
                }
            }

            return str;
        }

        /// <summary>
        /// Removes first occurrence of the given prefixes from beginning of the given string.
        /// Ordering is important. If one of the preFixes is matched, others will not be tested.
        /// </summary>
        /// <param name="str">The string.</param>
        /// <param name="preFixes">one or more prefix.</param>
        /// <returns>Modified string or the same string if it has not any of given prefixes</returns>
        [Description("从给定字符串的开头移除第一个出现的给定前缀")]
        public static string RemovePreFix(this string str, params string[] preFixes)
        {
            if (str == null)
            {
                return null;
            }

            if (string.IsNullOrEmpty(str))
            {
                return string.Empty;
            }

            if (preFixes.IsNullOrEmpty())
            {
                return str;
            }

            foreach (var preFix in preFixes)
            {
                if (str.StartsWith(preFix))
                {
                    return str.Right(str.Length - preFix.Length);
                }
            }

            return str;
        }

        /// <summary>
        /// Gets a substring of a string from end of the string.
        /// </summary>
        /// <exception cref="ArgumentNullException">Thrown if <paramref name="str"/> is null</exception>
        /// <exception cref="ArgumentException">Thrown if <paramref name="len"/> is bigger that string's length</exception>
        [Description("从字符串的结尾获取指定长度字符串")]
        public static string Right(this string str, int len)
        {
            if (str == null)
            {
                throw new ArgumentNullException(nameof(str));
            }

            if (str.Length < len)
            {
                throw new ArgumentException("len argument can not be bigger than given string's length!");
            }

            return str.Substring(str.Length - len, len);
        }

        /// <summary>
        /// Uses string.Split method to split given string by given separator.
        /// </summary>
        [Description("字符串拆分")]
        public static string[] Split(this string str, string separator)
        {
            return str.Split(new[] { separator }, StringSplitOptions.None);
        }

        /// <summary>
        /// Uses string.Split method to split given string by given separator.
        /// </summary>
        public static string[] Split(this string str, string separator, StringSplitOptions options)
        {
            return str.Split(new[] { separator }, options);
        }

        /// <summary>
        /// Uses string.Split method to split given string by <see cref="Environment.NewLine"/>.
        /// </summary>
        [Description("字符串换行拆分")]
        public static string[] SplitToLines(this string str)
        {
            return str.Split(Environment.NewLine);
        }

        /// <summary>
        /// Uses string.Split method to split given string by <see cref="Environment.NewLine"/>.
        /// </summary>
        public static string[] SplitToLines(this string str, StringSplitOptions options)
        {
            return str.Split(Environment.NewLine, options);
        }

        /// <summary>
        /// Uses string.Split method to split given string by separator.
        /// </summary>
        /// <param name="str">The string.</param>
        /// <param name="separator">The separator.</param>
        /// <returns></returns>
        public static string[] SplitToLines(this string str, string separator)
        {
            return str.Split(separator);
        }

        /// <summary>
        /// Converts PascalCase string to camelCase string.
        /// </summary>
        /// <param name="str">String to convert</param>
        /// <param name="invariantCulture">Invariant culture</param>
        /// <returns>camelCase of the string</returns>
        [Description("将PascalCase字符串转换为camelCase字符串")]
        public static string ToCamelCase(this string str, bool invariantCulture = true)
        {
            if (string.IsNullOrWhiteSpace(str))
            {
                return str;
            }

            if (str.Length == 1)
            {
                return invariantCulture ? str.ToLowerInvariant() : str.ToLower();
            }

            return (invariantCulture ? char.ToLowerInvariant(str[0]) : char.ToLower(str[0])) + str.Substring(1);
        }

        /// <summary>
        /// Converts PascalCase string to camelCase string in specified culture.
        /// </summary>
        /// <param name="str">String to convert</param>
        /// <param name="culture">An object that supplies culture-specific casing rules</param>
        /// <returns>camelCase of the string</returns>
        public static string ToCamelCase(this string str)
        {
            if (string.IsNullOrWhiteSpace(str))
            {
                return str;
            }

            if (str.Length == 1)
            {
                return str.ToLower();
            }

            return char.ToLower(str[0]) + str.Substring(1);
        }

        /// <summary>
        /// Converts given PascalCase/camelCase string to sentence (by splitting words by space).
        /// Example: "ThisIsSampleSentence" is converted to "This is a sample sentence".
        /// </summary>
        /// <param name="str">String to convert.</param>
        /// <param name="invariantCulture">Invariant culture</param>
        [Description("将给定的PascalCase/camelCase字符串转换为句子（通过按空格拆分单词）")]
        public static string ToSentenceCase(this string str, bool invariantCulture = false)
        {
            if (string.IsNullOrWhiteSpace(str))
            {
                return str;
            }

            return Regex.Replace(
                str,
                "[a-z][A-Z]",
                m => m.Value[0] + " " + (invariantCulture ? char.ToLowerInvariant(m.Value[1]) : char.ToLower(m.Value[1]))
            );
        }

        /// <summary>
        /// Converts given PascalCase/camelCase string to sentence (by splitting words by space).
        /// Example: "ThisIsSampleSentence" is converted to "This is a sample sentence".
        /// </summary>
        /// <param name="str">String to convert.</param>
        /// <param name="culture">An object that supplies culture-specific casing rules.</param>
        public static string ToSentenceCase(this string str)
        {
            if (string.IsNullOrWhiteSpace(str))
            {
                return str;
            }

            return Regex.Replace(str, "[a-z][A-Z]", m => m.Value[0] + " " + char.ToLower(m.Value[1]));
        }

        /// <summary>
        /// Converts string to enum value.
        /// </summary>
        /// <typeparam name="T">Type of enum</typeparam>
        /// <param name="value">String value to convert</param>
        /// <returns>Returns enum object</returns>
        [Description("将字符串转换为枚举值")]
        public static T ToEnum<T>(this string value)
            where T : struct
        {
            if (value == null)
            {
                throw new ArgumentNullException(nameof(value));
            }

            return (T)Enum.Parse(typeof(T), value);
        }

        /// <summary>
        /// Converts string to enum value.
        /// </summary>
        /// <typeparam name="T">Type of enum</typeparam>
        /// <param name="value">String value to convert</param>
        /// <param name="ignoreCase">Ignore case</param>
        /// <returns>Returns enum object</returns>
        public static T ToEnum<T>(this string value, bool ignoreCase)
            where T : struct
        {
            if (value == null)
            {
                throw new ArgumentNullException(nameof(value));
            }

            return (T)Enum.Parse(typeof(T), value, ignoreCase);
        }

        /// <summary>
        /// Converts to md5.
        /// </summary>
        /// <param name="str">The string.</param>
        /// <returns></returns>
        [Description("将字符串转换为MD5")]
        public static string ToMd5(this string str)
        {
            using (var md5 = MD5.Create())
            {
                var inputBytes = Encoding.UTF8.GetBytes(str);
                var hashBytes = md5.ComputeHash(inputBytes);

                var sb = new StringBuilder();
                foreach (var hashByte in hashBytes)
                {
                    sb.Append(hashByte.ToString("X2"));
                }

                return sb.ToString();
            }
        }

        /// <summary>
        /// Converts camelCase string to PascalCase string.
        /// </summary>
        /// <param name="str">String to convert</param>
        /// <param name="invariantCulture">Invariant culture</param>
        /// <returns>PascalCase of the string</returns>
        [Description("将camelCase字符串转换为pascalase字符串")]
        public static string ToPascalCase(this string str, bool invariantCulture = true)
        {
            if (string.IsNullOrWhiteSpace(str))
            {
                return str;
            }

            if (str.Length == 1)
            {
                return invariantCulture ? str.ToUpperInvariant() : str.ToUpper();
            }

            return (invariantCulture ? char.ToUpperInvariant(str[0]) : char.ToUpper(str[0])) + str.Substring(1);
        }

        /// <summary>
        /// Converts camelCase string to PascalCase string in specified culture.
        /// </summary>
        /// <param name="str">String to convert</param>
        /// <param name="culture">An object that supplies culture-specific casing rules</param>
        /// <returns>PascalCase of the string</returns>
        public static string ToPascalCase(this string str)
        {
            if (string.IsNullOrWhiteSpace(str))
            {
                return str;
            }

            if (str.Length == 1)
            {
                return str.ToUpper();
            }

            return char.ToUpper(str[0]) + str.Substring(1);
        }

        /// <summary>
        /// Gets a substring of a string from beginning of the string if it exceeds maximum length.
        /// </summary>
        /// <exception cref="ArgumentNullException">Thrown if <paramref name="str"/> is null</exception>
        [Description("如果指定长度超过最大长度，则从该字符串的开头获取指定长度的字符")]
        public static string Truncate(this string str, int maxLength)
        {
            if (str == null)
            {
                return null;
            }

            if (str.Length <= maxLength)
            {
                return str;
            }

            return str.Left(maxLength);
        }

        /// <summary>
        /// Gets a substring of a string from beginning of the string if it exceeds maximum length.
        /// It adds a "..." postfix to end of the string if it's truncated.
        /// Returning string can not be longer than maxLength.
        /// </summary>
        /// <exception cref="ArgumentNullException">Thrown if <paramref name="str"/> is null</exception>
        public static string TruncateWithPostfix(this string str, int maxLength)
        {
            return TruncateWithPostfix(str, maxLength, "...");
        }

        /// <summary>
        /// Gets a substring of a string from beginning of the string if it exceeds maximum length.
        /// It adds given <paramref name="postfix"/> to end of the string if it's truncated.
        /// Returning string can not be longer than maxLength.
        /// </summary>
        /// <exception cref="ArgumentNullException">Thrown if <paramref name="str"/> is null</exception>
        public static string TruncateWithPostfix(this string str, int maxLength, string postfix)
        {
            if (str == null)
            {
                return null;
            }

            if (string.IsNullOrEmpty(str) || maxLength == 0)
            {
                return string.Empty;
            }

            if (str.Length <= maxLength)
            {
                return str;
            }

            if (maxLength <= postfix.Length)
            {
                return postfix.Left(maxLength);
            }

            return str.Left(maxLength - postfix.Length) + postfix;
        }

        /// <summary>
        /// Read file context.
        /// </summary>
        /// <param name="filePath"></param>
        /// <returns></returns>
        [Description("通过文件物理路径获取文件文本")]
        public static string ReadFile(this string filePath)
        {
            string context = string.Empty;
            if (!File.Exists(filePath))
            {
                throw new IOException($"'{filePath}'file not exist");
            }
            using (FileStream fs = new FileStream(filePath, FileMode.Open))
            {
                using (StreamReader sr = new StreamReader(fs, Encoding.UTF8))
                {
                    context = sr.ReadToEnd().ToString();
                }
            }
            return context;
        }

        /// <summary>
        /// Verify number sort
        /// </summary>
        /// <param name="intStr"></param>
        /// <param name="sort"></param>
        /// <returns></returns>
        [Description("验证文本数字，如'1,2,3'；是否按指定排序")]
        public static bool VerifySort(this string intStr, SortEnum sort = SortEnum.Asc)
        {
            var list = intStr.Split(",")
                .Select(int.Parse)
                .ToList();
            switch (sort)
            {
                case SortEnum.Asc:
                    list = list.OrderBy(a => a)
                    .ToList();
                    break;
                case SortEnum.Desc:
                    list = list.OrderByDescending(a => a)
                        .ToList();
                    break;
                default:
                    throw new ArgumentOutOfRangeException(nameof(sort), sort, null);
            }
                
            return string.Join(",", list) == intStr;
        }

        /// <summary>
        /// 字符串倒序
        /// </summary>
        /// <param name="str"></param>
        /// <returns></returns>
        public static string StringReversed(this string str)
        {
            var reversed = new string(str.Reverse().ToArray());
            return reversed;
        }

        /// <summary>
        /// 字符串分割成2个字符一组
        /// </summary>
        /// <param name="str"></param>
        /// <param name="isReverse">是否翻转顺序</param>
        /// <returns></returns>
        public static List<string> StringToPairs(this string str, bool isReverse = false)
        {
            var pairs = str.Select((ch, index) => new { ch, index })
                .GroupBy(x => x.index / 2)
                .Select(g => string.Concat(g.Select(x => x.ch)))
                .ToList();
            if (isReverse)
                pairs.Reverse();
            return pairs;
        }

       
        /// <summary>
        /// 格式化字符串
        /// </summary>
        /// <param name="str"></param>
        /// <returns></returns>
        public static string StrAddSpan(this string str)
        {
            if (str == "")
            {
                return "";
            }
            return Regex.Replace(str.Replace(" ", ""), @"(?<=[0-9A-Za-z]{2})[0-9A-Za-z]{2}", " $0").Trim();
        }

        /// <summary>
        /// 格式化字符串且反转
        /// </summary>
        /// <param name="ste"></param>
        /// <returns></returns>
        public static string StrReverseOrder(this string ste)
        {
            if (ste == "")
            {
                return "";
            }
            string[] strArr = ste.Split(new string[] { " " }, System.StringSplitOptions.RemoveEmptyEntries);

            return string.Join(" ", strArr.Reverse());
        }


        /// <summary>
        /// 高低位反转，并转换成字符串
        /// </summary>
        /// <param name="list">16进制字符集合</param>
        /// <param name="index">16进制字符集合开始索引</param>
        /// <param name="count">取多少个数据</param>
        /// <returns></returns>
        public static string ListReverseToStr(this List<string> list, int index, int count)
        {
            var addrList = list.GetRange(index, count);
            addrList.Reverse();//高低位反转
            return string.Join("", addrList);
        }

        /// <summary>
        /// 二进制转十六进制
        /// </summary>
        /// <param name="binaryString"></param>
        /// <returns></returns>
        public static string BinToHex(this string binaryString)
        {
            var decimalNumber = Convert.ToInt32(binaryString, 2);// 将二进制字符串转换为整数
            var hexString = Convert.ToString(decimalNumber, 16); //decimalNumber.ToString("X"); // 将整数转换为十六进制字符串
            return hexString;
        }


        /// <summary>
        /// 二进制转十进制
        /// </summary>
        /// <param name="binaryString"></param>
        /// <returns></returns>
        public static int BinToDec(this string binaryString)
        {
            var decimalNumber = Convert.ToInt32(binaryString, 2);
            return decimalNumber;
        }

        /// <summary>
        /// 十六进制转十进制
        /// </summary>
        /// <param name="hexString"></param>
        /// <returns></returns>
        public static int HexToDec(this string hexString)
        {
            var decimalNumber = Convert.ToInt32(hexString, 16);
            return decimalNumber;
        }

        /// <summary>
        /// 转十进制字符串
        /// </summary>
        /// <param name="hexString"></param>
        /// <returns></returns>
        public static string HexToDecStr(this int hexString)
        {
            var decimalString = Convert.ToString(hexString, 16);
            return decimalString;
        }

        /// <summary>
        /// 十六进制转二进制
        /// </summary>
        /// <param name="hexString"></param>
        /// <returns></returns>
        public static string HexToBin(this string hexString)
        {
            var binaryValue = Convert.ToString(Convert.ToInt32(hexString, 16), 2);
            return binaryValue;
        }


        /// <summary>
        /// 十六进制转二进制
        /// 不足4位，前面补0
        /// </summary>
        /// <param name="hexString"></param>
        /// <returns></returns>
        public static string HexTo4BinZero(this string hexString)
        {
            string result = string.Empty;
            foreach (char c in hexString)
            {
                int v = Convert.ToInt32(c.ToString(), 16);
                int v2 = int.Parse(Convert.ToString(v, 2));
                result += string.Format("{0:d4}", v2);
            }
            return result;
        }

        /// <summary>
        /// 数据值加33
        /// </summary>
        public static string StrAddHex33(this string str)
        {
            if (str == "")
            {
                return "";
            }
            var strArr = str.Split(new string[] { " " }, System.StringSplitOptions.RemoveEmptyEntries);
            for (int i = 0; i < strArr.Length; i++)
            {
                strArr[i] = (Convert.ToInt32(strArr[i], 16) + Convert.ToInt32("33", 16)).ToString("X2");
                if (strArr[i].Length > 2)
                {
                    strArr[i] = strArr[i].Substring(strArr[i].Length - 2);
                }
            }
            return string.Join(" ", strArr);
        }


        /// <summary>
        /// 16进制字符串转换成byte数组
        /// </summary>
        /// <param name="hexString">16进制字符串</param>
        /// <returns>byte数组</returns>
        public static byte[] HexToByte(this string hexString)
        {
            hexString = hexString.Replace(" ", "");
            string tempStr = "";
            byte by = 0;
            List<byte> bytes = new List<byte>();
            for (int i = 0; i < hexString.Length; i += 2)
            {
                tempStr = hexString.Substring(i, 2);
                by = byte.Parse(tempStr, System.Globalization.NumberStyles.AllowHexSpecifier);
                bytes.Add(by);
            }
            return bytes.ToArray();
        }

        /// <summary>
        /// 判断数据是否有误
        /// </summary>
        /// <param name="str"></param>
        /// <returns></returns>
        public static bool IsErrorData(this string str)
        {
            if (str == "EE")
                return true;
            return false;
        }

        public static List<string> CutStr(this string str, int cutdigit, bool isReverse = false)
        {
            if (string.IsNullOrWhiteSpace(str)) return null;
            if (str.Length % cutdigit != 0) str = "0" + str;
            List<string> rlist = new List<string>();
            for (int i = 0; i < str.Length / cutdigit; i++)
            {
                rlist.Add(str.Substring(i * cutdigit, cutdigit));
            }
            if (isReverse) rlist.Reverse();
            return rlist;
        }

        public static bool IsValidIPv4(this string str)
        {
            return Regex.IsMatch(str, IPV4_REGEX);
        }

        public static bool IsValidPort(this string str)
        {
            return Regex.IsMatch(str, PORT_REGEX);
        }

        private static string AddHex33(this string strGet)
        {
            string result;
            if (string.IsNullOrEmpty(strGet))
            {
                result = "";
            }
            else
            {
                string[] source = StrAddSpan(strGet).Split(new char[]
                {
                    ' '
                }, StringSplitOptions.RemoveEmptyEntries);
                result = string.Join("", from s in source
                    select (Convert.ToInt32(s, 16) + Convert.ToInt32("33", 16)).ToString("X2"));
            }
            return result;
        }

        public static T FromJson<T>(this string strJson)
        {
            if (string.IsNullOrWhiteSpace(strJson))
                return default(T);

            try
            {
                return JsonConvert.DeserializeObject<T>(strJson);
            }
            catch (Exception ex)
            {
                return default(T);
            }
        }

        public static object TakeTimeToInt(this string timeStr)
        {
            var timeArr = timeStr.Split(':');
            int.TryParse(timeArr[0], out int hourInt);
            int.TryParse(timeArr[1], out int minInt);
            return (hourInt * 60 + minInt) / 15;

        }

        private static void CreateAlphaNumMask(StringBuilder buffer, string source, char mask, int length)
        {
            for (int i = 0; i < length; i++)
            {
                buffer.Append(char.IsLetterOrDigit(source[i])
                                ? mask
                                : source[i]);
            }
        }

    }
}