Строковые функции#

The numpy.strings модуль предоставляет набор универсальных функций, работающих с массивами типа numpy.str_ или numpy.bytes_. Например,

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

Эти универсальные функции также используются в numpy.char, который предоставляет numpy.char.chararray подкласс массива, чтобы эти процедуры также получили преимущества в производительности.

Примечание

До NumPy 2.0 вся функциональность для строк находилась в numpy.charкоторый работал только с строками фиксированной ширины. Этот модуль не будет получать обновления и будет устаревшим в будущем.

Создание массива из итератора.#

add(x1, x2, / [, out, where, casting, order, ...])

Добавить аргументы поэлементно.

center(a, width[, fillchar])

Вернуть копию a с его элементами, центрированными в строке длины ширина.

capitalize(a)

Вернуть копию a только с первой заглавной буквой каждого элемента.

decode(a[, encoding, errors])

Вызывает bytes.decode поэлементно.

encode(a[, encoding, errors])

Вызывает str.encode поэлементно.

expandtabs(a[, tabsize])

Возвращает копию каждого строкового элемента, где все символы табуляции заменены одним или несколькими пробелами.

ljust(a, width[, fillchar])

Возвращает массив с элементами a выровнено по левому краю в строке длиной ширина.

lower(a)

Вернуть массив с элементами, преобразованными в нижний регистр.

lstrip(a[, chars])

Для каждого элемента в a, вернуть копию с удалёнными начальными символами.

mod(a, values)

Возвращает (a % i), то есть форматирование строк до Python 2.6 (интерполяция), поэлементно для пары array_likes из 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 выровненные по правому краю в строке длиной ширина.

rpartition(a, sep)

Разделить (разбить) каждый элемент вокруг самого правого разделителя.

rstrip(a[, chars])

Для каждого элемента в a, возвращает копию с удалёнными завершающими символами.

slice(a[, start, stop, step])

Нарезать строки в a срезами, заданными начало, стоп, шаг.

strip(a[, chars])

Для каждого элемента в a, возвращает копию с удаленными начальными и конечными символами.

swapcase(a)

Поэлементно возвращает копию строки с преобразованием заглавных символов в строчные и наоборот.

title(a)

Возвращает поэлементную версию строки или юникода с заглавными буквами в начале слов.

translate(a, table[, deletechars])

Для каждого элемента в a, верните копию строки, где все символы, встречающиеся в необязательном аргументе deletechars удаляются, а оставшиеся символы были отображены через заданную таблицу перевода.

upper(a)

Вернуть массив с элементами, преобразованными в верхний регистр.

zfill(a, ширина)

Возвращает числовую строку, дополненную нулями слева.

Сравнение#

The 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])

Возвращает логический массив, который True где строковый элемент в a заканчивается на suffix, иначе 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, но вызывает ValueError когда подстрока sub не найдено.

startswith(a, prefix[, start, end])

Возвращает логический массив, который True где строковый элемент в a начинается с prefix, иначе False.

str_len(x, /[, out, where, casting, order, ...])

Возвращает длину каждого элемента.