Namespace: String

String

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

Members

staticSuperMap.String.numberRegEx

Used to test strings as numbers.

Default Value:
  • /^([+-]?)(?=\d|\.\d)\d*(\.\d*)?([Ee]([+-]?\d+))?$/

staticSuperMap.String.tokenRegEx

Used to find tokens in a string.

Default Value:
  • /\$\{([\w.]+?)\}/g
Example
Examples: ${a}, ${a.b.c}, ${a-b}, ${5}

Methods

staticSuperMap.String.camelize(str){string}

common/commontypes/BaseTypes.js, line 112

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

Name Type Description
str string

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

staticSuperMap.String.contains(str, sub){Boolean}

common/commontypes/BaseTypes.js, line 92

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

Name Type Description
str string

目标字符串.
sub string

查找的子字符串.
Returns:
Type Description
Boolean 目标字符串中包含指定的子字符串,则返回true;否则返回false.

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

common/commontypes/BaseTypes.js, line 158

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

Name Type Description
template string

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

带有属性的可选对象的属性用于匹配格式化字符串中的标记.如果该参数为空,将使用 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)

staticSuperMap.String.isNumeric(){Boolean}

common/commontypes/BaseTypes.js, line 227

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

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)

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

common/commontypes/BaseTypes.js, line 236

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

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

staticSuperMap.String.startsWith(str, sub){Boolean}

common/commontypes/BaseTypes.js, line 82

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

Name Type Description
str string

目标字符串.
sub string

查找的子字符串.
Returns:
Type Description
Boolean 目标字符串以指定的子字符串开头,则返回true;否则返回false.

staticSuperMap.String.trim(str){string}

common/commontypes/BaseTypes.js, line 101

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

Name Type Description
str string

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