Namespace: String

SuperMap.String

字符串操作的一系列常用扩展函数。

Members

SuperMap.String.numberRegExRegExp

判断一个字符串是否只包含一个数值，默认为 numberRegEx=/^([+-]?)(?=\d|.\d)\d*(.\d*)?(Ee)?$/。

SuperMap.String.tokenRegExRegExp

寻找带 token 的字符串，默认为 tokenRegEx=/${([\w.]+?)}/g。

Example
Examples: ${a}, ${a.b.c}, ${a-b}, ${5}

Methods

SuperMap.String.camelize(str){string}

common/commontypes/BaseTypes.js, line 119

骆驼式("-")连字符的字符串处理。 例如："chicken-head" becomes "chickenHead", "-chicken-head" becomes "ChickenHead"。

Name Type Description
str string

要处理的字符串，原始内容不应被修改。
Returns:
Type Description
string

SuperMap.String.contains(str, sub){boolean}

common/commontypes/BaseTypes.js, line 98

判断目标字符串是否包含指定的子字符串。

Name Type Description
str string

目标字符串。
sub string

查找的子字符串。
Returns:
Type Description
boolean 目标字符串中包含指定的子字符串，则返回 true；否则返回 false。

SuperMap.String.format(template, context, args){string}

common/commontypes/BaseTypes.js, line 137

提供带 ${token} 标记的字符串, 返回 context 对象属性中指定标记的属性值。

Name Type Default Description
template string

带标记的字符串将要被替换。参数 template 格式为"${token}"，此处的 token 标记会替换为 context["token"] 属性的值。
context Object window 可选

带有属性的可选对象的属性用于匹配格式化字符串中的标记。如果该参数为空，将使用 window 对象。
args Array 可选

可选参数传递给在 context 对象上找到的函数。
Returns:
Type Description
string 从 context 对象属性中替换字符串标记位的字符串。
Example
示例：
(code)
1、template = "${value,getValue}";
        context = {value: {getValue:function(){return Math.max.apply(null,argument);}}};
        args = [2,23,12,36,21];
      返回值:36
(end)
示例:
(code)
2、template = "$${{value,getValue}}";
        context = {value: {getValue:function(){return Math.max.apply(null,argument);}}};
        args = [2,23,12,36,21];
      返回值:"${36}"
(end)
示例:
(code)
3、template = "${a,b}";
        context = {a: {b:"format"}};
        args = null;
      返回值:"format"
(end)
示例:
(code)
3、template = "${a,b}";
        context = null;
        args = null;
      返回值:"${a.b}"
(end)

SuperMap.String.isNumeric(){boolean}

common/commontypes/BaseTypes.js, line 232

判断一个字符串是否只包含一个数值。

Returns:
Type Description
boolean 字符串包含唯一的数值，返回 true；否则返回 false。
Example
(code)
SuperMap.String.isNumeric("6.02e23") // true
SuperMap.String.isNumeric("12 dozen") // false
SuperMap.String.isNumeric("4") // true
SuperMap.String.isNumeric(" 4 ") // false
(end)

SuperMap.String.numericIf(){number|string}

common/commontypes/BaseTypes.js, line 248

把一个看似数值型的字符串转化为一个数值。

Returns:
Type Description
number | string 如果能转换为数值则返回数值，否则返回字符串本身。

SuperMap.String.startsWith(str, sub){boolean}

common/commontypes/BaseTypes.js, line 87

判断目标字符串是否以指定的子字符串开头。

Name Type Description
str string

目标字符串。
sub string

查找的子字符串。
Returns:
Type Description
boolean 目标字符串以指定的子字符串开头，则返回 true；否则返回 false。

SuperMap.String.trim(str){string}

common/commontypes/BaseTypes.js, line 109

删除一个字符串的开头和结尾处的所有空白字符。

Name Type Description
str string

（可能）存在空白字符填塞的字符串。
Returns:
Type Description
string 删除开头和结尾处空白字符后的字符串。