字符串功能

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 的 array_like，按元素进行。
multiply(a, i)	返回 (a * i)，即字符串多次连接，按元素进行。
partition(a, sep)	围绕 sep 分割 a 中的每个元素。
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])	返回一个数组，包含在范围 [start, end] 内子字符串 sub 的不重叠出现次数。
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, ...])	返回每个元素的长度。