字符串功能

numpy.strings 模块提供了一组对 numpy.str_ 或 numpy.bytes_ 类型数组进行操作的通用函数.例如

>>> np.strings.add(["num", "doc"], ["py", "umentation"])
array(['numpy', 'documentation'], dtype='<U13')

这些通用函数也在 numpy.char 中使用,它提供了 numpy.char.chararray 数组子类,以便这些例程也能获得性能优势.

备注

在 NumPy 2.0 之前,所有的字符串功能都在 numpy.char 中,它只操作固定宽度的字符串.该模块将不会得到更新,并且将在未来的某个时候被弃用.

字符串操作

add(x1, x2, /[, out, where, casting, order, ...])	逐元素添加参数.
center(a, width[, fillchar])	返回 a 的副本,其元素在长度为 width 的字符串中居中.
capitalize(a)	返回 a 的副本,其中每个元素的第一个字符大写.
decode(a[, encoding, errors])	逐元素调用 bytes.decode.
encode(a[, encoding, errors])	逐元素调用 str.encode.
expandtabs(a[, tabsize])	返回每个字符串元素的副本,其中所有制表符字符都被一个或多个空格替换.
ljust(a, width[, fillchar])	返回一个数组,其中 a 的元素在长度为 width 的字符串中左对齐.
lower(a)	返回一个将元素转换为小写的数组.
lstrip(a[, chars])	对于 a 中的每个元素,返回一个删除了前导字符的副本.
mod(a, values)	返回 (a % i),即 Python 2.6 之前的字符串格式化（插值）,对一对 str 或 unicode 的类数组元素逐个进行.
multiply(a, i)	返回 (a * i),即字符串多次拼接,逐元素进行.
partition(a, sep)	将 a 中的每个元素围绕 sep 进行分区.
replace(a, old, new[, count])	对于 a 中的每个元素,返回一个字符串的副本,其中子字符串 old 被 new 替换.
rjust(a, width[, fillchar])	返回一个数组,其中 a 的元素在长度为 width 的字符串中右对齐.
rpartition(a, sep)	分区（分割）每个元素围绕最右边的分隔符.
rstrip(a[, chars])	对于 a 中的每个元素,返回一个去掉尾部字符的副本.
strip(a[, chars])	对于 a 中的每个元素,返回一个去除前导和尾随字符的副本.
swapcase(a)	返回逐元素的字符串副本,其中大写字符转换为小写,小写字符转换为大写.
title(a)	返回字符串或unicode的逐元素标题大小写版本.
translate(a, table[, deletechars])	对于 a 中的每个元素,返回一个字符串的副本,其中所有出现在可选参数 deletechars 中的字符都被删除,剩余的字符通过给定的转换表进行映射.
upper(a)	返回一个元素被转换为大写的数组.
zfill(a, width)	返回用零左填充的数字字符串.

比较

numpy.strings 模块还导出了比较通用函数,这些函数现在也可以对字符串数组进行操作.

equal(x1, x2, /[, out, where, casting, ...])	逐元素返回 (x1 == x2).
not_equal(x1, x2, /[, out, where, casting, ...])	返回 (x1 != x2) 逐元素.
greater_equal(x1, x2, /[, out, where, ...])	返回 (x1 >= x2) 的元素级真值.
less_equal(x1, x2, /[, out, where, casting, ...])	返回 (x1 <= x2) 的元素级真值.
greater(x1, x2, /[, out, where, casting, ...])	返回逐元素比较 (x1 > x2) 的真值.
less(x1, x2, /[, out, where, casting, ...])	返回 (x1 < x2) 的元素级真值.

字符串信息

count(a, sub[, start, end])	返回一个数组,其中包含子字符串 sub 在范围 [start, end) 中非重叠出现的次数.
endswith(a, suffix[, start, end])	返回一个布尔数组,其中在 a 中的字符串元素以 suffix 结尾的位置为 True,否则为 False.
find(a, sub[, start, end])	对于每个元素,返回字符串中子字符串 sub 找到的最低索引,使得 sub 包含在范围 [start, end) 中.
index(a, sub[, start, end])	类似于 find,但在找不到子字符串时会引发 ValueError.
isalnum(x, /[, out, where, casting, order, ...])	对于每个元素,如果字符串中的所有字符都是字母数字且至少有一个字符,则返回 true,否则返回 false.
isalpha(x, /[, out, where, casting, order, ...])	对于每个元素,如果数据解释为字符串中的所有字符都是字母且至少有一个字符,则返回 true,否则返回 false.
isdecimal(x, /[, out, where, casting, ...])	对于每个元素,如果元素中只有十进制字符,则返回 True.
isdigit(x, /[, out, where, casting, order, ...])	对于每个元素,如果字符串中的所有字符都是数字且至少有一个字符,则返回 true,否则返回 false.
islower(x, /[, out, where, casting, order, ...])	如果字符串中的所有有大小写的字符都是小写且至少有一个有大小写的字符,则对每个元素返回 true,否则返回 false.
isnumeric(x, /[, out, where, casting, ...])	对于每个元素,如果元素中只有数字字符,则返回 True.
isspace(x, /[, out, where, casting, order, ...])	对于每个元素,如果字符串中只有空白字符且至少有一个字符,则返回 true,否则返回 false.
istitle(x, /[, out, where, casting, order, ...])	对于每个元素,如果该元素是一个标题大小写的字符串并且至少有一个字符,则返回 true,否则返回 false.
isupper(x, /[, out, where, casting, order, ...])	如果字符串中的所有有大小写的字符都是大写且至少有一个字符,则对每个元素返回 true,否则返回 false.
rfind(a, sub[, start, end])	对于每个元素,返回子字符串 sub 在字符串中找到的最高索引,这样 sub 包含在范围 [start, end) 中.
rindex(a, sub[, start, end])	类似于 rfind,但在子字符串 sub 未找到时会引发 ValueError.
startswith(a, prefix[, start, end])	返回一个布尔数组,其中在 a 中的字符串元素以 prefix 开头的位置为 True,否则为 False.
str_len(x, /[, out, where, casting, order, ...])	返回每个元素的长度.