You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

527 lines
23 KiB

using Apewer.Internals;
using System;
using System.Collections.Generic;
using System.Data;
using System.IO;
using System.Runtime.CompilerServices;
using System.Text;
using System.Text.RegularExpressions;
namespace Apewer
{
/// <summary>文本实用工具。</summary>
public class TextUtility
{
/// <summary>UTF-8 BOM。</summary>
public static readonly byte[] Bom = Constant.Bom;
/// <summary>空文本。</summary>
public const string EmptyString = Constant.EmptyString;
/// <summary>合并为字符串。</summary>
public static string Merge(params object[] cells) => Join(null, cells);
/// <summary>合并为字符串。</summary>
public static string Merge(IEnumerable<object> cells) => Join(null, (IEnumerable<object>)cells);
/// <summary>合并为字符串。</summary>
public static string Join(string separator, params object[] cells) => Join(separator, (IEnumerable<object>)cells);
/// <summary>合并为字符串。</summary>
public static string Join(string separator, IEnumerable<object> cells)
{
if (cells == null) return Constant.EmptyString;
var sb = new StringBuilder();
var first = true;
var hasSeparator = !string.IsNullOrEmpty(separator);
foreach (var cell in cells)
{
// if (cell == null) continue;
if (!first && hasSeparator) sb.Append(separator);
first = false;
if (cell == null) continue;
var text = (cell is string) ? (string)cell : cell.ToString();
if (string.IsNullOrEmpty(text)) continue;
sb.Append(cell.ToString());
}
var result = sb.ToString();
return result;
}
/// <summary>重复指定子字符串,直到达到指定长度。</summary>
/// <param name="cell">子字符串。</param>
/// <param name="length">目标字符串的长度。</param>
public static string CopyChar(string cell, int length) => TextGenerator.CopyChar(cell, length);
/// <summary>获取指定长的的空格。</summary>
public static string Space(int length) => TextGenerator.Space(length);
/// <summary>将文本以转换为字节数组。默认 Encoding 为 UTF-8。</summary>
public static byte[] ToBinary(string text, Encoding encoding = null) => TextConverter.ToBinary(text, encoding ?? Encoding.UTF8);
/// <summary>将字节数组转换为文本。默认 Encoding 为 UTF-8。</summary>
public static string FromBinary(byte[] bytes, Encoding encoding = null)
{
if (bytes == null) return Constant.EmptyString;
if (bytes.LongLength < 1L) return Constant.EmptyString;
try
{
if (encoding == null) return FromBinary(bytes, Encoding.UTF8);
return encoding.GetString(bytes);
}
catch { return Constant.EmptyString; }
}
/// <summary>将明文文本以 UTF-8 转换为 Base64 文本。</summary>
public static string ToBase64(string plain) => TextConverter.ToBase64(plain);
/// <summary>将 Base64 文本以 UTF-8 转换为明文文本。</summary>
public static string FromBase64(string cipher) => TextConverter.FromBase64(cipher);
/// <summary>byte -> plain</summary>
public static string EncodeByte(byte @byte) => TextConverter.EncodeByte(@byte);
/// <summary>binary -> hex plain</summary>
public static string EncodeBinary(byte[] bytes)
{
return TextConverter.EncodeBinary(bytes);
}
/// <summary>hex text -> plain</summary>
public static string EncodeText(string text, bool delimiter = false) => TextConverter.EncodeText(text, delimiter);
/// <summary>hex plain -> binary</summary>
public static byte[] DecodeBinary(string plain) => TextConverter.DecodeBinary(plain);
/// <summary>hex plain -> text</summary>
public static string DecodeText(string plain) => TextConverter.DecodeText(plain);
/// <summary>将字节数组格式化为字符串。</summary>
public static string FormatX2(params byte[] bytes) => TextConverter.FormatX2(bytes);
/// <summary>获取单精度浮点对象。</summary>
public static Single GetFloat(char origin) => TextConverter.GetSingle(origin.ToString());
/// <summary>获取单精度浮点对象。</summary>
public static Single GetFloat(string origin) => TextConverter.GetSingle(origin);
/// <summary>获取单精度浮点对象。</summary>
public static Single GetSingle(char origin) => TextConverter.GetSingle(origin.ToString());
/// <summary>获取单精度浮点对象。</summary>
public static Single GetSingle(string origin) => TextConverter.GetSingle(origin);
/// <summary>获取双精度浮点对象。</summary>
public static Double GetDouble(char origin) => TextConverter.GetDouble(origin.ToString());
/// <summary>获取双精度浮点对象。</summary>
public static Double GetDouble(string origin) => TextConverter.GetDouble(origin);
/// <summary>获取 Decimal 对象。</summary>
public static decimal GetDecimal(char origin) => TextConverter.GetDecimal(origin.ToString());
/// <summary>获取 Decimal 对象。</summary>
public static decimal GetDecimal(string origin) => TextConverter.GetDecimal(origin);
/// <summary>获取 Int16 对象。</summary>
public static Int16 GetInt16(char origin) => TextConverter.GetInt16(origin.ToString());
/// <summary>获取 Int16 对象。</summary>
public static Int16 GetInt16(string origin) => TextConverter.GetInt16(origin);
/// <summary>获取 Int32 对象。</summary>
public static Int32 GetInt32(char origin) => TextConverter.GetInt32(origin.ToString());
/// <summary>获取 Int32 对象。</summary>
public static Int32 GetInt32(string origin) => TextConverter.GetInt32(origin);
/// <summary>获取 Int64 对象。</summary>
public static Int64 GetInt64(char origin) => TextConverter.GetInt64(origin.ToString());
/// <summary>获取 Int64 对象。</summary>
public static Int64 GetInt64(string origin) => TextConverter.GetInt64(origin);
/// <summary>为字符串前添加字符“0”。</summary>
/// <param name="origin">原字符串,内容应为整数、小数或十六进制数,若格式不符则返回原字符串。</param>
/// <param name="length">新字符串的长度,若大于原数字长度,则不添加额外的“0”。</param>
public static string PreZero(string origin, int length = 0) => TextModifier.PreZero(origin, length);
/// <summary>删除字符串前额外的字符“0”。</summary>
public static string RemoveZero(string text) => TextModifier.RemoveZero(text);
/// <summary>替换父字符串中的子字符串。</summary>
/// <param name="parent">父字符串。</param>
/// <param name="new">新子字符串,保留大小写。</param>
/// <param name="old">原子字符串。</param>
/// <param name="ignoreCase">查找时是否忽略父字符串和原子字符串大小写。</param>
/// <returns>替换后的父字符串。</returns>
public static string Replace(string parent, string old, string @new, bool ignoreCase = false) => TextModifier.Replace(parent, old, @new, ignoreCase);
/// <summary>修复文本后缀。默认用于修复 Windows 目录路径。</summary>
/// <param name="origin">原文本。</param>
/// <param name="include">True:追加指定后缀;False:去除指定后缀。</param>
/// <param name="foot">后缀文本。</param>
public static string AssureEnds(string origin, bool include = true, string foot = "\\") => TextModifier.AssureEnds(origin, include, foot);
/// <summary>用单字符作为分隔符拆分文本。</summary>
public static string[] Split(string text, char separator)
{
if (text == null) return new string[0];
if (text.Length < 1) return new string[] { "" };
if ((object)separator == null) return new string[] { text };
return text.Split(separator);
}
/// <summary>用字符串作为分隔符拆分文本。</summary>
public static string[] Split(string text, string separator)
{
if (text == null) return new string[0];
if (text.Length < 1) return new string[] { "" };
if (string.IsNullOrEmpty(separator)) return new string[] { text };
if (separator.Length > text.Length) return new string[] { text };
var list = new List<string>();
var position = 0;
var total = text.Length;
var length = separator.Length;
var cell = new StringBuilder();
while (position < total)
{
var read = null as string;
if (position + length < total) read = text.Substring(position, length);
else read = text.Substring(position);
if (read == separator)
{
if (cell.Length > 0)
{
list.Add(cell.ToString());
// cell.Clear();
cell = new StringBuilder();
}
else
{
list.Add("");
}
position += length;
}
else
{
cell.Append((char)text[position]);
position += 1;
}
if (position >= total)
{
list.Add(cell.ToString());
}
}
var array = list.ToArray();
return array;
}
/// <summary>用多个分隔符拆分文本。</summary>
public static string[] Split(string text, params char[] separators)
{
if (text == null) return new string[0];
if (text.Length < 1) return new string[] { "" };
if (separators == null || separators.Length < 1) return new string[] { text };
if (separators.Length == 1) return Split(text, separators[0]);
var list = new List<string>();
var separatorsText = new string(separators);
var sb = new StringBuilder();
foreach (var c in text)
{
if (separatorsText.IndexOf(c) >= 0)
{
list.Add(sb.ToString());
//sb.Clear();
sb = new StringBuilder();
continue;
}
sb.Append(c);
}
list.Add(sb.ToString());
#if !NET20
sb.Clear();
#endif
return list.ToArray();
}
/// <summary>移除字符串前后的空白。</summary>
/// <param name="origin">原始字符串。</param>
public static string Trim(string origin)
{
return TextModifier.Trim(origin);
}
/// <summary>移除字符串前后的空白。</summary>
/// <param name="origin">原始字符串。</param>
/// <param name="allCases">所有情况,全角空格将被去除。</param>
public static string Trim(string origin, bool allCases) => TextModifier.Trim(origin, allCases);
/// <summary>防注入处理,去除会引发代码注入的字符。可限定字符串长度。</summary>
public static string AntiInject(string text, int length, params char[] blacklist) => TextModifier.AntiInject(text, length, blacklist);
/// <summary>防注入处理,去除会引发代码注入的字符。可限定字符串长度。</summary>
public static string AntiInject(string text, int length, IEnumerable<char> blacklist) => TextModifier.AntiInject(text, length, blacklist);
/// <summary>防注入处理,去除会引发代码注入的字符。可限定字符串长度。</summary>
public static string AntiInject(string text, int length = -1, string blacklist = Constant.InjectDefaultBlackList)
{
return TextModifier.AntiInject(text, length, blacklist == null ? null : blacklist.ToCharArray());
}
/// <summary>剪取文本内容,若指定头部为空则从原文本首部起,若指定尾部为空则至原文本末尾。</summary>
public static string Cut(string origin, string head = null, string foot = null) => TextModifier.Cut(origin, head, foot);
/// <summary>比较两个字符串的相似度。返回值大于 0,小于等于 1。</summary>
/// <param name="arg1"></param>
/// <param name="arg2"></param>
/// <returns></returns>
public static double Similarity(string arg1, string arg2) => Levenshtein.Compute(arg1, arg2).Rate;
/// <summary>判断对象为 Null、空字符串或空白字符串。</summary>
public static bool IsEmpty(string text) => TextVerifier.IsEmpty(text);
/// <summary>判断对象为含有内容的字符串。</summary>
public static bool NotEmpty(string text) => !TextVerifier.IsEmpty(text);
/// <summary>判断对象为 Null、空字符串或无实际内容的字符串。</summary>
public static bool IsBlank(string text, bool allCases = false) => TextVerifier.IsBlank(text, allCases);
/// <summary>判断对象为含有实际内容的字符串。</summary>
public static bool NotBlank(string text, bool allCases = false) => !TextVerifier.IsBlank(text, allCases);
/// <summary>生成新的 GUID(不带连字符、小写)。</summary>
public static string NewGuid(bool hyphenation = false, bool lower = true)
{
var guid = Guid.NewGuid();
if (!hyphenation && lower) return guid.ToString("n");
var text = Guid.NewGuid().ToString();
if (lower) text = text.ToLower();
else text = text.ToUpper();
if (!hyphenation) text = text.Replace("-", "");
return text;
}
/// <summary>生成随机字符串,出现的字符由字符池指定,默认池包含数字和字母。</summary>
/// <param name="pool">字符池,字符池中每个字符在随机字符串中出现的概率约等。</param>
/// <param name="length">随机字符串的长度。</param>
public static string Random(int length, string pool = "0123456789abcdefghijklmnopqrstuvwxyz") => RandomHelper.RandomCustom(pool, length);
/// <summary>对字符串列表去重。指定 valid 参数时将去除 NULL、空字符串和空白字符串。</summary>
public static List<string> Distinct(IEnumerable<string> origin, bool valid = false) => TextModifier.Distinct(origin, valid);
/// <summary>约束字符串长度范围,超出的部分将被截取去除。</summary>
public static string RestrictLength(string origin, int length) => TextModifier.RestrictLength(origin, length);
/// <summary>约束字符串长度为 32,超出的部分将被截取去除。</summary>
public static string Restrict32(string origin) => TextModifier.RestrictLength(origin, 32);
/// <summary>约束字符串长度为 255,超出的部分将被截取去除。</summary>
public static string Restrict255(string origin) => TextModifier.RestrictLength(origin, 255);
/// <summary>约束字符串长度为 2000,超出的部分将被截取去除。</summary>
public static string Restrict2000(string origin) => TextModifier.RestrictLength(origin, 2000);
/// <summary>约束字符串中的字符,不允许的字符将被去除。</summary>
public static string RestrictCharacters(string origin, params char[] allowable) => TextModifier.RestrictCharacters(origin, new string(allowable));
/// <summary>约束字符串中的字符,不允许的字符将被去除。</summary>
public static string RestrictCharacters(string origin, string allowable) => TextModifier.RestrictCharacters(origin, allowable);
/// <summary>约束字符串中的字符,只保留字母。</summary>
public static string RestrictLetters(string origin) => TextModifier.RestrictCharacters(origin, Constant.LetterCollection);
/// <summary>约束字符串中的字符,只保留数字。</summary>
public static string RestrictNumeric(string origin) => TextModifier.RestrictCharacters(origin, Constant.NumberCollection);
/// <summary>约束字符串,只保留 GUID 可能出现的字符,根据连字符限定长度为 32 或 36。</summary>
public static string RestrictGuid(string origin) => TextModifier.RestrictGuid(origin);
/// <summary>返回此字符串的安全键副本,只保留数据记录主键中可能出现的字符,默认限制长度为 255 字符。</summary>
public static string SafeKey(string text, int maxLength = 255)
{
if (string.IsNullOrEmpty(text)) return Constant.EmptyString;
var input = ToLower(text);
var max = maxLength;
if (max < 1 || max > input.Length) max = input.Length;
var sb = new StringBuilder();
var total = input.Length;
var length = 0;
for (var i = 0; i < total; i++)
{
var c = input[i];
if (Constant.KeyCollection.IndexOf(c) < 0) continue;
sb.Append(c);
length += 1;
if (length >= max) break;
}
var result = sb.ToString();
if (result.Length > max) result = result.Substring(0, max);
return result;
}
/// <summary>追加字符串。</summary>
public static StringBuilder Append(StringBuilder builder, params object[] cells)
{
if (builder != null) builder.Append(Join(null, cells));
return builder;
}
/// <summary>对 URL 编码。</summary>
public static string EncodeUrl(string plain)
{
return UrlEncoding.Encode(plain);
}
/// <summary>对 URL 解码。</summary>
public static string DecodeUrl(string escaped)
{
return UrlEncoding.Decode(escaped);
}
/// <summary>返回此字符串转换为小写形式的副本。</summary>
public static string ToLower(string text)
{
if (text == null) return null;
else if (text.Length < 1) return EmptyString;
else return text.ToLower();
}
/// <summary>返回此字符串转换为大写形式的副本。</summary>
public static string ToUpper(string text)
{
if (text == null) return null;
else if (text.Length < 1) return EmptyString;
else return text.ToUpper();
}
/// <summary>检查中国手机号码,包含 13x、14x、15x、16x、17x、18x 和 19x 号段。</summary>
public static bool IsPhone(string phone)
{
if (string.IsNullOrEmpty(phone)) return false;
var regex = new Regex(@"^(13|14|15|16|17|18|19)\d{9}$", RegexOptions.None);
var match = regex.Match(phone);
return match.Success;
}
/// <summary>渲染 Markdown 文本为 HTML 文本。</summary>
public static string RenderMarkdown(string markdown) => MarkdownSharp.Demo.ToHtml(markdown);
/// <summary>合并用于启动进程的参数。</summary>
public static string MergeProcessArgument(params object[] args)
{
// var special = " \"\n\r\b\t\f";
var list = new List<string>();
if (args != null)
{
foreach (var i in args)
{
var arg = null as string;
if (i != null)
{
if (i is string) arg = i as string;
else arg = i.ToString();
}
if (string.IsNullOrEmpty(arg))
{
list.Add("\"\"");
continue;
}
if (arg.Contains(" ") || arg.Contains("\""))
{
list.Add(Merge("\"", arg.Replace("\"", "\\\""), "\""));
continue;
}
list.Add(arg);
}
}
var result = Join(" ", list.ToArray());
return result;
}
/// <summary>合并用于启动进程的参数。</summary>
private static string MergeProcessArgument_2(params object[] args)
{
if (args == null) return "";
if (args.Length < 1) return "";
var sb = new StringBuilder();
for (var i = 0; i < args.Length; i++)
{
if (i > 0) sb.Append(" ");
var arg = null as string;
if (args[i] != null)
{
if (args[i] is string) arg = args[i] as string;
else arg = args[i].ToString();
}
if (arg.IsEmpty())
{
sb.Append("\"\"");
continue;
}
// var special = " \"\n\r\b\t\f";
var special = " \"";
if (arg.IndexOfAny(special.ToCharArray()) < 0)
{
sb.Append(arg);
}
else
{
sb.Append("\"");
if (arg.NotEmpty())
{
foreach (var c in arg)
{
switch (c)
{
case '"':
sb.Append("\\\"");
break;
// case '\n':
// sb.Append("\\n");
// break;
// case '\r':
// sb.Append("\\r");
// break;
// case '\b':
// sb.Append("\\b");
// break;
// case '\t':
// sb.Append("\\t");
// break;
default:
sb.Append(c);
break;
}
}
}
sb.Append("\"");
}
}
var result = sb.ToString();
return result;
}
}
}