numpy.char.chararray.resize

метод

chararray.resize(new_shape, refcheck=True)

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

Параметры:	new_shape : tuple of ints, or n ints Форма изменённого массива. refcheck : bool, 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]])