String operations

This module provides a set of vectorized string operations for arrays of type numpy.string_ or numpy.unicode_. All of them are based on the string methods in the Python standard library.

String operations

add(x1, x2) Return (x1 + x2), that is string concatenation, element-wise for a pair of array_likes of str or unicode.
multiply(a, i) Return (a * i), that is string multiple concatenation, element-wise.
mod(a, values) Return (a % i), that is pre-Python 2.6 string formatting
capitalize(a) Return a copy of a with only the first character of each element capitalized.
center(a, width[, fillchar]) Return a copy of a with its elements centered in a string of length width.
decode(a[, encoding, errors]) Calls str.decode element-wise.
encode(a[, encoding, errors]) Calls str.encode element-wise.
join(sep, seq) Return a string which is the concatenation of the strings in the sequence seq.
ljust(a, width[, fillchar]) Return an array with the elements of a left-justified in a string of length width.
lower(a) Return an array with the elements of a converted to lowercase.
lstrip(a[, chars]) For each element in a, return a copy with the leading characters removed.
partition
replace(a, old, new[, count]) For each element in a, return a copy of the string with all occurrences of substring old replaced by new.
rjust(a, width[, fillchar]) Return an array with the elements of a right-justified in a string of length width.
rpartition
rsplit(a[, sep, maxsplit]) For each element in a, return a list of the words in the string, using sep as the delimiter string.
rstrip(a[, chars]) For each element in a, return a copy with the trailing characters removed.
split(a[, sep, maxsplit]) For each element in a, return a list of the words in the string, using sep as the delimiter string.
splitlines(a[, keepends]) For each element in a, return a list of the lines in the element, breaking at line boundaries.
strip(a[, chars]) For each element in a, return a copy with the leading and trailing characters removed.
swapcase(a) For each element in a, return a copy of the string with uppercase characters converted to lowercase and vice versa.
title(a) For each element in a, return a titlecased version of the string: words start with uppercase characters, all remaining cased characters are lowercase.
translate(a, table[, deletechars]) 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.
upper(a) Return an array with the elements of a converted to uppercase.
zfill(a, width) Return the numeric string left-filled with zeros in a string of length width.

Comparison

Unlike the standard numpy comparison operators, the ones in the char module strip trailing whitespace characters before performing the comparison.

equal(x1, x2) Return (x1 == x2) element-wise.
not_equal(x1, x2) Return (x1 != x2) element-wise.
greater_equal(x1, x2) Return (x1 >= x2) element-wise.
less_equal(x1, x2) Return (x1 <= x2) element-wise.
greater(x1, x2) Return (x1 > x2) element-wise.
less(x1, x2) Return (x1 < x2) element-wise.

String information

count(a, sub[, start, end]) Returns an array with the number of non-overlapping occurrences of substring sub in the range [start, end].
len
find(a, sub[, start, end]) For each element, return the lowest index in the string where substring sub is found.
index(a, sub[, start, end]) Like find, but raises ValueError when the substring is not found.
isalpha(a) Returns true for each element if all characters in the string are alphabetic and there is at least one character, false otherwise.
isdecimal(a) For each element in a, return True if there are only decimal
isdigit(a) Returns true for each element if all characters in the string are digits and there is at least one character, false otherwise.
islower(a) Returns true for each element if all cased characters in the string are lowercase and there is at least one cased character, false otherwise.
isnumeric(a) For each element in a, return True if there are only numeric
isspace(a) Returns true for each element if there are only whitespace characters in the string and there is at least one character, false otherwise.
istitle(a) Returns true for each element if the element is a titlecased string and there is at least one character, false otherwise.
isupper(a) Returns true for each element if all cased characters in the string are uppercase and there is at least one character, false otherwise.
rfind(a, sub[, start, end]) For each element in a, return the highest index in the string where substring sub is found, such that sub is contained within [start, end].
rindex(a, sub[, start, end]) Like rfind, but raises ValueError when the substring sub is
startswith(a, prefix[, start, end]) Returns a boolean array which is True where the string element

Convenience class

chararray Provides a convenient view on arrays of string and unicode values.

Table Of Contents

Previous topic

C-Types Foreign Function Interface (numpy.ctypeslib)

Next topic

numpy.core.defchararray.add

This Page