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.

bufferobject exposing the buffer interface or str, 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])	Совместимый псевдоним для tobytes, с абсолютно таким же поведением.
translate(self, table[, deletechars])	Для каждого элемента в self, возвращает копию строки, где все символы, присутствующие в необязательном аргументе deletechars удалены, а оставшиеся символы отображены с помощью заданной таблицы преобразования.
transpose(*axes)	Возвращает представление массива с перенумерованными осями.
upper(self)	Возвращает массив с элементами self, преобразованными в верхний регистр.
view([dtype][, type])	Новое представление массива с теми же данными.
zfill(self, width)	Возвращает числовую строку, дополненную нулями слева, в строке длиной width.