numpy.can_cast

numpy.can_cast(from, totype, casting = 'safe')

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

Параметры:

from : dtype, спецификатор dtype, скаляр или массив Тип данных, скаляр или массив, из которого производится преобразование. totype : 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’ для типов данных integer/float и string, если длина типа string недостаточно велика, чтобы хранить максимальное целое/вещественное значение, преобразованное в строку. Ранее can_cast в режиме ‘safe’ возвращала True для типов данных integer/float и типа string любой длины.

Примеры

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

>>> np.can_cast(np.int32, np.int64)
True
>>> np.can_cast(np.float64, np.complex)
True
>>> np.can_cast(np.complex, np.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