numpy.can_cast

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

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

Параметры:

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

Возвращает:

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

См. также

dtype, result_type

Примечания

Изменено в версии 1.17.0: Преобразование между простым типом данных и структурированным типом возможно только для преобразований «unsafe». Преобразование к нескольким полям разрешено, но преобразование из нескольких полей не разрешено.

Изменено в версии 1.9.0: Преобразование из числового типа в строковый тип в режиме «safe» требует, чтобы длина строкового типа была достаточно большой для хранения максимального значения целого/вещественного числа, преобразованного в строку.

Примеры

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

>>> 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