String functionality#
The numpy.strings
module provides a set of universal functions operating
on arrays of type numpy.str_
or numpy.bytes_
.
For example
>>> np.strings.add(["num", "doc"], ["py", "umentation"])
array(['numpy', 'documentation'], dtype='<U13')
These universal functions are also used in numpy.char
, which provides
the numpy.char.chararray
array subclass, in order for those routines
to get the performance benefits as well.
Note
Prior to NumPy 2.0, all string functionality was in numpy.char
, which
only operated on fixed-width strings. That module will not be getting
updates and will be deprecated at some point in the future.
String operations#
|
Add arguments element-wise. |
|
Return a copy of a with its elements centered in a string of length width. |
|
Return a copy of |
|
Calls |
|
Calls |
|
Return an array with the elements of a left-justified in a string of length width. |
|
Return an array with the elements converted to lowercase. |
|
For each element in a, return a copy with the leading characters removed. |
|
Return (a % i), that is pre-Python 2.6 string formatting (interpolation), element-wise for a pair of array_likes of str or unicode. |
|
Return (a * i), that is string multiple concatenation, element-wise. |
|
For each element in |
|
Return an array with the elements of a right-justified in a string of length width. |
|
For each element in a, return a copy with the trailing characters removed. |
|
For each element in a, return a copy with the leading and trailing characters removed. |
|
Return element-wise a copy of the string with uppercase characters converted to lowercase and vice versa. |
|
Return element-wise title cased version of string or unicode. |
|
For each element in a, return a copy of the string where all characters occurring in the optional argument deletechars are removed, and the remaining characters have been mapped through the given translation table. |
|
Return an array with the elements converted to uppercase. |
|
Return the numeric string left-filled with zeros |
Comparison#
The numpy.strings
module also exports the comparison universal functions
that can now operate on string arrays as well.
|
Return (x1 == x2) element-wise. |
|
Return (x1 != x2) element-wise. |
|
Return the truth value of (x1 >= x2) element-wise. |
|
Return the truth value of (x1 <= x2) element-wise. |
|
Return the truth value of (x1 > x2) element-wise. |
|
Return the truth value of (x1 < x2) element-wise. |
String information#
|
Returns an array with the number of non-overlapping occurrences of substring |
|
Returns a boolean array which is True where the string element in |
|
For each element, return the lowest index in the string where substring |
|
Like |
|
Returns true for each element if all characters in the string are alphanumeric and there is at least one character, false otherwise. |
|
Returns true for each element if all characters in the data interpreted as a string are alphabetic and there is at least one character, false otherwise. |
|
For each element, return True if there are only decimal characters in the element. |
|
Returns true for each element if all characters in the string are digits and there is at least one character, false otherwise. |
|
Returns true for each element if all cased characters in the string are lowercase and there is at least one cased character, false otherwise. |
|
For each element, return True if there are only numeric characters in the element. |
|
Returns true for each element if there are only whitespace characters in the string and there is at least one character, false otherwise. |
|
Returns true for each element if the element is a titlecased string and there is at least one character, false otherwise. |
|
Return true for each element if all cased characters in the string are uppercase and there is at least one character, false otherwise. |
|
For each element, return the highest index in the string where substring |
|
Like |
|
Returns a boolean array which is True where the string element in |
|
Returns the length of each element. |