numpy.chararray

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

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

Примечание

Класс 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='Fortran', в этом случае strides в порядке «Fortran».

Параметры:

shape : кортеж Форма массива. itemsize : int, необязательно Длина каждого элемента массива в количестве символов. По умолчанию 1. unicode : bool, необязательно Элементы массива типа юникод (True) или строка (False). По умолчанию False. buffer : int, необязательно Адрес памяти начала данных массива. По умолчанию None, в этом случае создается новый массив. offset : int, необязательно Фиксированное смещение шага с начала оси? По умолчанию 0. Должно быть >=0. strides : массив-подобный из целых чисел, необязательно Шаги для массива (см. ndarray.strides для полного описания). По умолчанию None. order : {‘C’, ‘F’}, необязательно Порядок, в котором данные массива хранятся в памяти: ‘C’ -> «строчный» порядок (по умолчанию), ‘F’ -> «столбцовый» (Fortran) порядок.

Примеры

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

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

Атрибуты

T	То же самое, что self.transpose(), за исключением того, что self возвращается, если self.ndim < 2.
base	Базовый объект, если память взята из другого объекта.
ctypes	Объект для упрощения взаимодействия массива с модулем ctypes.
data	Объект Python буфера, указывающий на начало данных массива.
dtype	Тип данных элементов массива.
flags	Информация о структуре памяти массива.
flat	Итератор 1-D по массиву.
imag	Мнимая часть массива.
itemsize	Длина одного элемента массива в байтах.
nbytes	Общее количество байтов, занимаемых элементами массива.
ndim	Число измерений массива.
real	Вещественная часть массива.
shape	Кортеж измерений массива.
size	Количество элементов в массиве.
strides	Кортеж байтов, которые нужно перешагнуть в каждом измерении при обходе массива.

Методы

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

replace(old, new[, count])	Для каждого элемента в self, возвращает копию строки со всеми вхождениями подстроки old замененными на new.
reshape(shape[, order])	Возвращает массив, содержащий те же данные с новой формой.
resize(new_shape[, refcheck])	Изменение формы и размера массива на месте.
rfind(sub[, start, end])	Для каждого элемента в self, возвращает наибольший индекс в строке, где подстрока sub находится, так что sub содержится в [start, end].
rindex(sub[, start, end])	Подобно rfind, но вызывает исключение ValueError, когда подстрока sub не найдена.
rjust(width[, fillchar])	Возвращает массив с элементами self выровненными по правому краю в строке длины width.
rsplit([sep, maxsplit])	Для каждого элемента в self, возвращает список слов в строке, используя sep в качестве разделительной строки.
rstrip([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([sep, maxsplit])	Для каждого элемента в self, возвращает список слов в строке, используя sep в качестве разделителя.
splitlines([keepends])	Для каждого элемента в self, возвращает список строк в элементе, разбивая по границам строк.
squeeze([axis])	Удалить одномерные записи из формы a.
startswith(prefix[, start, end])	Возвращает булевый массив, который равен True, если строковый элемент в self начинается с prefix, в противном случае False.
strip([chars])	Для каждого элемента в self, возвращает копию со удаленными начальными и конечными символами.
swapaxes(axis1, axis2)	Возвращает представление массива с axis1 и axis2 поменянными местами.
swapcase()	Для каждого элемента в self, возвращает копию строки с заглавными буквами преобразованными в строчные и наоборот.
take(indices[, axis, out, mode])	Возвращает массив, образованный из элементов a по заданным индексам.
title()	Для каждого элемента в self, возвращает строку в стиле заголовка: слова начинаются с заглавной буквы, остальные символы в нижнем регистре.
tofile(fid[, sep, format])	Записать массив в файл как текст или двоичные данные (по умолчанию).
tolist()	Возвращает массив как (возможно, вложенный) список.
tostring([order])	Построить Python bytes, содержащие сырые данные байтов в массиве.
translate(table[, deletechars])	Для каждого элемента в self, возвращает копию строки, где все символы, присутствующие в необязательном аргументе deletechars, удаляются, а оставшиеся символы отображаются через заданную таблицу преобразований.
transpose(*axes)	Возвращает представление массива с переставленными осями.
upper()	Возвращает массив с элементами self преобразованными в верхний регистр.
view([dtype, type])	Новое представление массива с теми же данными.
zfill(width)	Возвращает числовую строку, заполненную нулями слева, в строке длины width.