numpy.char.chararray.resize

метод

char.chararray.resize(new_shape, refcheck=True)

Изменение формы и размера массива на месте.

Параметры

new_shapetuple of ints, or n ints

Форма измененного массива.

refcheckbool, optional

Если False, счетчик ссылок не проверяется. По умолчанию True.

Возвращает

None

Исключения

ValueError

Если массив a не владеет собственными данными или существуют ссылки или представления на них, и память данных должна быть изменена. Только PyPy: всегда будет поднимать исключение, если память данных должна быть изменена, так как нет надежного способа определить, существуют ли ссылки или представления на нее.

SystemError

Если задан ключевой аргумент order. Это поведение является ошибкой в NumPy.

См. также

resize

Возвращает новый массив с заданной формой.

Примечания

Это перераспределяет память для области данных при необходимости.

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

Цель проверки счетчика ссылок заключается в том, чтобы убедиться, что вы не используете этот массив в качестве буфера для другого объекта Python, а затем перераспределяете память. Однако счетчики ссылок могут увеличиваться и другими способами, поэтому если вы уверены, что не разделяете память этого массива с другим объектом Python, вы можете безопасно установить refcheck в значение False.

Примеры

Уменьшение массива: массив выравнивается (в порядке, в котором данные хранятся в памяти), изменяется размер и форма:

>>> a = np.array([[0, 1], [2, 3]], order='C')
>>> a.resize((2, 1))
>>> a
array([[0],
       [1]])

>>> a = np.array([[0, 1], [2, 3]], order='F')
>>> a.resize((2, 1))
>>> a
array([[0],
       [2]])

Увеличение массива: как и выше, но отсутствующие элементы заполняются нулями:

>>> b = np.array([[0, 1], [2, 3]])
>>> b.resize(2, 3) # new_shape parameter doesn't have to be a tuple
>>> b
array([[0, 1, 2],
       [3, 0, 0]])

Ссылка на массив предотвращает изменение размера…

>>> c = a
>>> a.resize((1, 1))
Traceback (most recent call last):
...
ValueError: cannot resize an array that references or is referenced ...

Если refcheck равно False:

>>> a.resize((1, 1), refcheck=False)
>>> a
array([[0]])
>>> c
array([[0]])