numpy.can_cast

numpy.can_cast(from_, to, casting='safe')

Возвращает True, если преобразование между типами данных может произойти в соответствии с правилом преобразования. Если from является скаляром или скаляром массива, также возвращает True, если значение скаляра может быть преобразовано без переполнения или усечения к целому числу.

Параметры:

from_ : dtype, спецификатор dtype, скаляр или массив Тип данных, скаляр или массив для преобразования. to : dtype или спецификатор dtype Тип данных для преобразования. casting : {‘no’, ‘equiv’, ‘safe’, ‘same_kind’, ‘unsafe’}, необязательно Управляет тем, какой вид преобразования данных может произойти. ‘no’ означает, что типы данных вообще не должны преобразовываться. ‘equiv’ означает, что допускаются только изменения порядка байтов. ‘safe’ означает, что допускаются только преобразования, которые могут сохранить значения. ‘same_kind’ означает, что допускаются только безопасные преобразования или преобразования в пределах вида, такие как float64 в float32. ‘unsafe’ означает, что любые преобразования данных могут быть выполнены.

Возвращает:

out : bool True, если преобразование может произойти в соответствии с правилом преобразования.

См. также

dtype, result_type

Примечания

Начиная с NumPy 1.9, функция can_cast теперь возвращает False в режиме преобразования ‘safe’ для целочисленных/вещественных типов данных и строкового типа данных, если длина строкового типа данных недостаточно велика для хранения максимального значения целого/вещественного числа, преобразованного в строку. Ранее can_cast в режиме ‘safe’ возвращала True для целочисленных/вещественных типов данных и строкового типа данных любой длины.

Примеры

Основные примеры

>>> np.can_cast(np.int32, np.int64)
True
>>> np.can_cast(np.float64, complex)
True
>>> np.can_cast(complex, float)
False

>>> np.can_cast('i8', 'f8')
True
>>> np.can_cast('i8', 'f4')
False
>>> np.can_cast('i4', 'S4')
False

Преобразование скаляров

>>> np.can_cast(100, 'i1')
True
>>> np.can_cast(150, 'i1')
False
>>> np.can_cast(150, 'u1')
True

>>> np.can_cast(3.5e100, np.float32)
False
>>> np.can_cast(1000.0, np.float32)
True

Скаляр массива проверяет значение, массив — нет

>>> np.can_cast(np.array(1000.0), np.float32)
True
>>> np.can_cast(np.array([1000.0]), np.float32)
False

Использование правил преобразования

>>> np.can_cast('i8', 'i8', 'no')
True
>>> np.can_cast('<i8', '>i8', 'no')
False

>>> np.can_cast('<i8', '>i8', 'equiv')
True
>>> np.can_cast('<i4', '>i8', 'equiv')
False

>>> np.can_cast('<i4', '>i8', 'safe')
True
>>> np.can_cast('<i8', '>i4', 'safe')
False

>>> np.can_cast('<i8', '>i4', 'same_kind')
True
>>> np.can_cast('<i8', '>u4', 'same_kind')
False

>>> np.can_cast('<i8', '>u4', 'unsafe')
True