numpy.char.chararray

class numpy.char.chararray(shape, itemsize=1, unicode=False, buffer=None, offset=0, strides=None, order=None)

Предоставляет удобный вид на массивы строковых и Unicode-значений.

Примечание

Класс chararray существует для обратной совместимости с Numarray, он не рекомендуется для новых разработок. Начиная с numpy 1.4, если нужны массивы строк, рекомендуется использовать массивы типа dtype object_, string_ или unicode_, и использовать свободные функции в модуле numpy.char для быстрых векторизованных строковых операций.

По сравнению с обычным массивом NumPy типа str или unicode, этот класс добавляет следующие возможности:

1. значения автоматически очищаются от пробелов в конце при индексировании
2. операторы сравнения автоматически очищают значения от пробелов в конце при сравнении
3. векторизованные строковые операции предоставляются как методы (например, endswith) и инфиксные операторы (например, "+", "*", "%")

chararrays должны создаваться с помощью numpy.char.array или numpy.char.asarray, а не напрямую с помощью этого конструктора.

Этот конструктор создает массив, используя buffer (с offset и strides), если это не None. Если buffer равно None, то создает новый массив с strides в порядке "C", если оба len(shape) >= 2 и order='F' не установлены, в противном случае strides в порядке "Fortran".

Параметры

shapetuple

Форма массива.

itemsizeint, optional

Длина каждого элемента массива в количестве символов. По умолчанию 1.

unicodebool, optional

Являются ли элементы массива типа Unicode (True) или строковые (False). По умолчанию False.

bufferint, optional

Адрес памяти начала данных массива. По умолчанию None, в этом случае создаётся новый массив.

offsetint, optional

Фиксированное смещение шага от начала оси? По умолчанию 0. Должно быть >=0.

stridesarray_like of ints, optional

Шаги массива (см. ndarray.strides для полного описания). По умолчанию None.

order{‘C’, ‘F’}, optional

Порядок хранения данных массива в памяти: ‘C’ -> “строчный” порядок (по умолчанию), ‘F’ -> “столбцовый” (Fortran) порядок.

Примеры

>>> charar = np.chararray((3, 3))
>>> charar[:] = 'a'
>>> charar
chararray([[b'a', b'a', b'a'],
           [b'a', b'a', b'a'],
           [b'a', b'a', b'a']], dtype='|S1')

>>> charar = np.chararray(charar.shape, itemsize=5)
>>> charar[:] = 'abc'
>>> charar
chararray([[b'abc', b'abc', b'abc'],
           [b'abc', b'abc', b'abc'],
           [b'abc', b'abc', b'abc']], dtype='|S5')

Атрибуты

T

Транспонированный массив.

base

Базовый объект, если память взята из другого объекта.

ctypes

Объект для упрощения взаимодействия массива с модулем ctypes.

data

Объект буфера Python, указывающий на начало данных массива.

dtype

Тип данных элементов массива.

flags

Информация о расположении памяти массива.

flat

Итератор по массиву в 1-мерном виде.

imag

Мнимая часть массива.

itemsize

Длина одного элемента массива в байтах.

nbytes

Общее количество байтов, занимаемых элементами массива.

ndim

Количество измерений массива.

real

Вещественная часть массива.

shape

Кортеж измерений массива.

size

Количество элементов в массиве.

strides

Кортеж байтов для шага в каждом измерении при обходе массива.

Методы

astype(dtype[, order, casting, subok, copy])	Копия массива, преобразованного к указанному типу.
argsort([axis, kind, order])	Возвращает индексы, которые отсортируют этот массив.
copy([order])	Возвращает копию массива.
count(self, sub[, start, end])	Возвращает массив с количеством неперекрывающихся вхождений подстроки sub в диапазоне [start, end].
decode(self[, encoding, errors])	Вызывает str.decode поэлементно.
dump(file)	Сохраняет дамп массива в указанный файл.
dumps()	Возвращает дамп массива в виде строки.
encode(self[, encoding, errors])	Вызывает str.encode поэлементно.
endswith(self, suffix[, start, end])	Возвращает булевый массив, который равен True если строковый элемент в self оканчивается на suffix, в противном случае False.
expandtabs(self[, tabsize])	Возвращает копию каждого строкового элемента, где все символы табуляции заменены одним или несколькими пробелами.
fill(value)	Заполняет массив скалярным значением.
find(self, sub[, start, end])	Для каждого элемента возвращает самый низкий индекс в строке, где найдена подстрока sub.
flatten([order])	Возвращает плоский массив-копию.
getfield(dtype[, offset])	Возвращает поле данного массива как определенного типа.
index(self, sub[, start, end])	Подобно find, но вызывает ValueError если подстрока не найдена.
isalnum(self)	Возвращает True для каждого элемента, если все символы в строке являются буквенно-цифровыми и присутствует хотя бы один символ, в противном случае False.
isalpha(self)	Возвращает True для каждого элемента, если все символы в строке являются буквенными и присутствует хотя бы один символ, в противном случае False.
isdecimal(self)	Для каждого элемента в self, возвращает True, если в элементе присутствуют только десятичные символы.
isdigit(self)	Возвращает True для каждого элемента, если все символы в строке являются цифрами и присутствует хотя бы одна цифра, в противном случае False.
islower(self)	Возвращает True для каждого элемента, если все символы в строке, имеющие регистр, являются строчными и присутствует хотя бы один такой символ, в противном случае False.
isnumeric(self)	Для каждого элемента в self, возвращает True, если в элементе присутствуют только числовые символы.
isspace(self)	Возвращает True для каждого элемента, если в строке присутствуют только пробельные символы и присутствует хотя бы один символ, в противном случае False.
istitle(self)	Возвращает True для каждого элемента, если элемент является заглавной строкой и присутствует хотя бы один символ, в противном случае False.
isupper(self)	Возвращает True для каждого элемента, если все символы в строке, имеющие регистр, являются заглавными и присутствует хотя бы один такой символ, в противном случае False.
item(*args)	Копирует элемент массива в стандартный скаляр Python и возвращает его.
join(self, seq)	Возвращает строку, которая является конкатенацией строк в последовательности seq.
ljust(self, width[, fillchar])	Возвращает массив с элементами self выровненными по левому краю в строке длины width.
lower(self)	Возвращает массив с элементами self, преобразованными в нижний регистр.
lstrip(self[, chars])	Для каждого элемента в self, возвращает копию с удаленными начальными символами.
nonzero()	Возвращает индексы элементов, которые не равны нулю.
put(indices, values[, mode])	Устанавливает a.flat[n] = values[n] для всех n в indices.
ravel([order])	Возвращает сглаженный массив.
repeat(repeats[, axis])	Повторяет элементы массива.
replace(self, old, new[, count])	Для каждого элемента в self, возвращает копию строки со всеми вхождениями подстроки old замененными на new.
reshape(shape[, order])	Возвращает массив, содержащий те же данные с новой формой.
resize(new_shape[, refcheck])	Изменяет форму и размер массива на месте.
rfind(self, sub[, start, end])	Для каждого элемента в self, возвращает самый высокий индекс в строке, где найдена подстрока sub, при условии, что sub содержится в [start, end].

rindex(self, sub[, start, end])	Как rfind, но вызывает исключение ValueError когда подстрока sub не найдена.
rjust(self, width[, fillchar])	Возвращает массив с элементами self, выровненными по правому краю в строке длиной width.
rsplit(self[, sep, maxsplit])	Для каждого элемента в self, возвращает список слов в строке, используя sep в качестве разделителя.
rstrip(self[, chars])	Для каждого элемента в self, возвращает копию со удаленными символами в конце.
searchsorted(v[, side, sorter])	Находит индексы, куда элементы v следует вставить в a, чтобы сохранить порядок.
setfield(val, dtype[, offset])	Поместить значение в указанное место в поле, определенное типом данных.
setflags([write, align, uic])	Установить флаги массива WRITEABLE, ALIGNED, (WRITEBACKIFCOPY и UPDATEIFCOPY), соответственно.
sort([axis, kind, order])	Сортирует массив на месте.
split(self[, sep, maxsplit])	Для каждого элемента в self, возвращает список слов в строке, используя sep в качестве разделителя.
splitlines(self[, keepends])	Для каждого элемента в self, возвращает список строк в элементе, разбивая по границам строк.
squeeze([axis])	Удалить одномерные записи из формы a.
startswith(self, prefix[, start, end])	Возвращает булевый массив, который True если строковый элемент в self начинается с prefix, иначе False.
strip(self[, chars])	Для каждого элемента в self, возвращает копию со удаленными начальными и конечными символами.
swapaxes(axis1, axis2)	Возвращает представление массива с axis1 и axis2 поменяными местами.
swapcase(self)	Для каждого элемента в self, возвращает копию строки с заглавными буквами, преобразованными в строчные, и наоборот.
take(indices[, axis, out, mode])	Возвращает массив, сформированный из элементов a по заданным индексам.
title(self)	Для каждого элемента в self, возвращает строку в стиле заголовка: слова начинаются с заглавных букв, все остальные символы - строчные.
tofile(fid[, sep, format])	Записать массив в файл как текст или двоичные данные (по умолчанию).
tolist()	Возвращает массив как вложенный список Python, вложенность a.ndim уровней, содержащий скалярные значения.
tostring([order])	Создать байты Python, содержащие сырые данные байтов в массиве.
translate(self, table[, deletechars])	Для каждого элемента в self, возвращает копию строки, где все символы, присутствующие в необязательном аргументе deletechars удалены, а оставшиеся символы отображены через заданную таблицу преобразования.
transpose(*axes)	Возвращает представление массива с переставленными осями.
upper(self)	Возвращает массив с элементами self, преобразованными в верхний регистр.
view([dtype, type])	Новое представление массива с теми же данными.
zfill(self, width)	Возвращает числовую строку, заполненную слева нулями в строке длиной width.