Legacy fixed-width string functionality#
Legacy
This submodule is considered legacy and will no longer receive updates. This could also mean it will be removed in future NumPy versions. The string operations in this module, as well as thenumpy.char.chararrayclass, are planned to be deprecated in the future. Usenumpy.stringsinstead.
Thenumpy.char module provides a set of vectorized stringoperations for arrays of typenumpy.str_ ornumpy.bytes_. For example
>>>importnumpyasnp>>>np.char.capitalize(["python","numpy"])array(['Python', 'Numpy'], dtype='<U6')>>>np.char.add(["num","doc"],["py","umentation"])array(['numpy', 'documentation'], dtype='<U13')
The methods in this module are based on the methods instring
String operations#
| Add arguments element-wise. |
| Return (a * i), that is string multiple concatenation, element-wise. |
| 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 copy of |
| Return a copy ofa with its elements centered in a string of lengthwidth. |
| Calls |
| Calls |
| Return a copy of each string element where all tab characters are replaced by one or more spaces. |
| Return a string which is the concatenation of the strings in the sequenceseq. |
| Return an array with the elements ofa left-justified in a string of lengthwidth. |
| Return an array with the elements converted to lowercase. |
| For each element ina, return a copy with the leading characters removed. |
| Partition each element ina aroundsep. |
| For each element in |
| Return an array with the elements ofa right-justified in a string of lengthwidth. |
| Partition (split) each element around the right-most separator. |
| For each element ina, return a list of the words in the string, usingsep as the delimiter string. |
| For each element ina, return a copy with the trailing characters removed. |
| For each element ina, return a list of the words in the string, usingsep as the delimiter string. |
| For each element ina, return a list of the lines in the element, breaking at line boundaries. |
| For each element ina, 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 ina, return a copy of the string where all characters occurring in the optional argumentdeletechars 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#
Unlike the standard numpy comparison operators, the ones in thecharmodule strip trailing whitespace characters before performing thecomparison.
| Return (x1 == x2) element-wise. |
| Return (x1 != x2) element-wise. |
| Return (x1 >= x2) element-wise. |
| Return (x1 <= x2) element-wise. |
| Return (x1 > x2) element-wise. |
| Return (x1 < x2) element-wise. |
| Performs element-wise comparison of two string arrays using the comparison operator specified bycmp. |
String information#
| Returns an array with the number of non-overlapping occurrences of substring |
| Returns a boolean array which isTrue 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 data interpreted as a string are alphabetic and there is at least one character, false otherwise. |
| Returns true for each element if all characters in the string are alphanumeric 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 isTrue where the string element in |
| Returns the length of each element. |