Spec-Zone.ru › NumPy 2.0

Функциональность строк

Модуль 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 поэлементно.

ljust(a, width[, fillchar])

Возвращает массив с элементами a, выровненными влево в строке длиной width.

lower(a)

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

lstrip(a[, chars])

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

mod(a, values)

Возвращает (a % i), то есть форматирование строк до Python 2.6 (интерполяция), поэлементно для пары массивоподобных объектов типа str или unicode.

multiply(a, i)

Возвращает (a * i), то есть множественное конкатенация строк, поэлементно.

replace(a, old, new[, count])

Для каждого элемента в a, возвращает копию строки с заменой вхождения подстроки old на new.

rjust(a, width[, fillchar])

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

rstrip(a[, chars])

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

strip(a[, chars])

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

swapcase(a)

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

title(a)

Возвращает поэлементно строку в формате заглавных букв.

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

Возвращает массив с количеством неперекрывающихся вхождений подстроки 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, ...])

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

© 2005–2024 NumPy Developers
Licensed under the 3-clause BSD License.
https://numpy.org/doc/2.0/reference/routines.strings.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API