title: 字符串

字符串

字符串方法库允许您通过简单的方式访问和操作字符串。

Method

提取字符串所表达的合法的函数名。

Str.Method("Function");                       // Function
Str.Method("ClassName.Function");             // Function
Str.Method("ClassName.Function@NewFunction"); // NewFunction
Str.Method("ClassName.Function@#$%^^&*");     // Function

函数原型

string Method(string pattern);

Is

判断规定字符串是否符合匹配表达式。匹配表达式只允许使用星号*通配(即删减正则表达式中除了星号外的所有功能)

var result = Str.Is("he*d" , "helloworld"); // true

函数原型

string Is(string pattern, string value);

bool Is<T>(string[] patterns, T source);

AsteriskWildcard

将规定字符串翻译为星号匹配表达式。(即删减正则表达式中除了星号外的所有功能)

var result = Str.AsteriskWildcard("[hello]w*d");
// result : "\[hello\]w*d"

函数原型

string AsteriskWildcard(string pattern);

Split

根据长度将字符串分割到数组中,最后一个元素可能小于需求长度。

var result = Str.Split("helloworld1" , 2);
// result : ["he", "ll", "ow", "or", "ld", "1"]

函数原型

string[] Split(string str, int length = 1);

Repeat

将字符串重复指定的次数。

var result = Str.Repeat("hello" , 3);
// result : hellohellohello

函数原型

string Repeat(string str, int num);

Shuffle

随机打乱字符串中的所有字符

var result = Str.Shuffle("helloworld");
// result 为被打乱的值，如：lwloeodlrh, 每次调用值都不一样

函数原型

string Shuffle(string str, int? seed = null);

SubstringCount

计算子串在字符串中出现的次数（该函数不计数重叠的子串）

var result = Str.SubstringCount("abcabcab","abcab");
// result : 1

函数原型

int SubstringCount(string str, string subStr, int start = 0, int? length = null, StringComparison comparison = StringComparison.CurrentCultureIgnoreCase);

Reverse

反转规定字符串

var result = Str.Reverse("helloworld");
// result : dlrowolleh

函数原型

string Reverse(string str);

Pad

把规定字符串填充为新的长度。

• 如果填充长度小于字符串的原始长度，则不进行任何操作。
• 填充字符串的两侧。如果不是偶数，则右侧获得额外的填充。

var result = Str.Pad("hello", 10, "wor", PadTypes.Both);
// result : wohellowor

函数原型

string Pad(string str, int length, string padStr = null, PadTypes type = PadTypes.Right);
// 该函数原型即将在v2.0版本中弃用

string Pad(int length, string str, string padStr = null, PadTypes type = PadTypes.Right);

After

在规定字符串中查找在规定搜索值，并在规定搜索值之后返回规定字符串的剩余部分。(如果没有找到则返回规定字符串本身)

var result = Str.After("helloworld","llo");
// result : world

函数原型

string After(string str, string search);

Contains

判断规定字符串是否包含规定子字符串。

var result = Str.Contains("helloworld","llo");
// result : true

函数原型

bool Contains(string str, params string[] needles);

Replace

在规定字符串中替换匹配项。

var result = Str.Replace(new []{"hel","wor"},"***","helloworld");
// result : ***lo***ld

函数原型

string Replace(string[] matches, string replace, string str);

ReplaceFirst

替换规定字符串中第一次遇到的匹配项

var result = Str.ReplaceFirst("hel","***","helloworldhelloworld");
// result : ***loworldhelloworld

函数原型

string ReplaceFirst(string match, string replace, string str);

ReplaceLast

替换规定字符串中从后往前第一次遇到的匹配项

var result = Str.ReplaceLast("hel","***","helloworldhelloworld");
// result : helloworld***loworld

函数原型

string ReplaceLast(string match, string replace, string str);

Random

生成一个随机字母（含大小写），数字的字符串。

var result = Str.Random(8);
// result : 一个随机值，如：u8Kn1YUz

函数原型

string Random(int length = 16, int? seed = null);

Trancate

如果长度超过给定的最大字符串长度，则截断字符串。 截断的字符串的最后一个字符将替换为默认为...的省略字符串。

var result = Str.Trancate("helloworld",6);
// result: hel...

var result = Str.Trancate("hello world",10 , " ");
// result: hello...

函数原型

string Truncate(string str, int length, object separator = null, string mission = null);

JoinList

返回给定数组的所有顺序组合。

v[0] = "hello"
v[1] = "world"
var result = Str.JoinList(v, "/"); 
result[0] == "hello";
result[1] == "hello/world";

函数原型

string[] JoinList(string[] source, string separator = null);

string[] JoinList(string[] source, char separator);

Levenshtein

计算两个字符串之间的相似度。

https://en.wikipedia.org/wiki/Levenshtein_distance

Str.Levenshtein("hello", "world"); // 4
Str.Levenshtein("hello", "catlib"); // 5
Str.Levenshtein("hello", "catlib-world"); // 10

函数原型

int Levenshtein(string str1, string str2);

Space

表示了一个带有空格的空字符串。

var space = Str.Space; // " "

常量原型

const string Space = " ";;