前言
笔者认为,对一个API的理解最重要的是三个方面
一、做了什么事
二、参数
三、返回值类型是什么
统一设置
let str = "hello world"
声明:
1.较为复杂的API我会写一些代码示例,其余具体用法请自行查阅MDN
2.字符串API一般不会改变原字符串
3.注意有些API返回的是String,有些返回的是Boolean,有些返回的是Number,有些返回的是Array
1.查找
1.1 str.charAt(index)
str.charAt(0) // "h"
做了什么事:从一个字符串中返回指定的字符
参数index:一个介于0 和字符串长度减1之间的整数 (0 ~ length-1),若没有参数,默认值为0
返回值:String 返回指定的字符
1.2 str.indexOf(searchValue[, fromIndex])
str.indexOf('or',5) // 7
做了什么事:返回一个字符串在另一个字符串中出现时的索引值,在fromIndex开始进行搜索。
参数searchValue:字符串
【留意字符串为空字符时的情况】
参数fromIndex:开始查找的位置
返回值:Number返回searchValue第一次出现的索引值;反之,返回-1
1.3 str.match(regexp)
str.match(/hello/i) // ["hello"]
做了什么事:当一个字符串与一个正则表达式匹配时, match()方法检索匹配项
参数regexp:一个正则表达式对象
返回值:Array、null 返回数组,被匹配成功的字符串为数组的第一项;若匹配失败,返回null
详细说明
regexp参数被传入一个非正则对象的使用较为复杂,笔者举例说明
// 1. 传入非正则表达式对象
str.match("hello") // ["hello"]
// 如果传入一个非正则表达式对象,则会隐式地使用 new RegExp(obj) 将其转换为一个 RegExp
str.match(new RegExp("hello")) -> str.match(/hello/)
// 2. 未传入任何参数,返回一个包含空字符串的数组
str.match() // [""]
1.4 str.search(regexp)
str.search(/world/i) // 6
做了什么事:使用正则表达式与str之间进行匹配
参数regexp:一个正则表达式对象
返回值:Number 返回正则表达式在字符串中首次匹配项的索引;否则,返回 -1
2.判断
2.1 str.includes(searchString[, position])
str.includes('or',8) // false
做了什么事:判断一个字符串是否包含在另一个字符串中
参数searchString:字符串
【留意字符串为空字符时的情况】
参数position:开始查询的索引位置,默认为0
返回值:Boolean匹配成功返回true,反之返回false
3.连接
3.1 str.concat(string2, string3[, ..., stringN])
str.concat(',I am',' a',' javascripter') // "hello world,I am a javascripter"
做了什么事:将一个或多个字符串与原字符串连接合并
参数:一个或多个字符串
返回值:合并后的新字符串
4.替换
4.1 str.replace(regexp|substr, newSubStr|function)
str.replace(/hello/i,'wonderful') // "wonderful world"
做了什么事:将str内被第一个参数匹配上的部分替换为第二个参数的值
参数regexp|substr:正则对象或者字符串
参数newSubStr|function:字符串或者回调函数
【关于回调函数部分有些复杂,建议大家自行查阅mdn】
返回值:String被替换后的新字符串
5.截取
5.1 str.slice(beginSlice[, endSlice])
str.slice(1,3) // "el"
做了什么事:提取一个字符串的一部分,并返回一新的字符串
参数beginSlice:开始截取的索引值
参数endSlice:结束截取的索引值
返回值:String被截取的字符串
5.2 str.split([separator[, limit]])
"Webkit Moz O ms Khtml".split( " ",2 ) // ["Webkit", "Moz"]
"Webkit Moz O ms Khtml".split( " " ) // ["Webkit", "Moz", "O", "ms", "Khtml"]
做了什么事:使用指定的分隔符字符串将一个String对象分割成字符串数组
参数separator:指定的分隔符
参数limit:数组的长度
返回值:Array被分割的字符串组成的数组
5.3 str.substr(start[, length])
str.substr(1,5) // "ello "
做了什么事:指定一个开始位置和字符长度,根据这个指定从一个字符串中截取并返回新的字符串
参数start:开始的索引位置
参数length:字符串字符数
返回值:String被截取的新字符串
5.4 str.substring(indexStart[, indexEnd])
str.substring(1,6) // "ello "
做了什么事:返回一个字符串在开始索引到结束索引之间的一个子集
参数indexStart:开始的索引位置
参数indexEnd:结束的索引位置【默认为字符串长度+1】
返回值:String被截取的新字符串
6. 大小写转换
// 全部转换为大写
str.toUpperCase() // "HELLO WORLD"
// 全部转换为小写
str.concat(',My Friend!').toLowerCase() // "hello world,my friend!"
行文匆忙,难免有一些弱智错误,还望大家提醒,共同进步
**粗体** _斜体_ [链接](http://example.com) `代码` - 列表 > 引用
。你还可以使用@
来通知其他用户。