NumPyのcan_cast()メソッド – キャストルールに従ったスカラーとデータ型のキャスト可否を判定する

numpy.can_cast()メソッドは、指定されたキャストルールに従ってスカラー（またはデータ型・配列）から目的のデータ型へのキャストが可能である場合にTrueを返します。

このメソッドは以下の2つの引数を受け取ります。

• 第1引数： キャスト元となるスカラー値、データ型、または配列
• 第2引数： キャスト先のデータ型

数値の範囲や精度を超えるキャスト（例：大きな整数を小さな整数型へ変換する場合など）は安全ではないため、Falseが返されます。データ損失を防ぐために、事前にキャストの可否を確認できる便利なメソッドです。

手順

まず、必要なライブラリをインポートします。

import numpy as np

次に、キャストルールに従ってスカラーとデータ型の間でキャストが可能かどうかを確認します。

print("Checking with can_cast() method in Numpy\n")
print("Result...",np.can_cast(20, 'i1'))
print("Result...",np.can_cast(280, 'i1'))
print("Result...",np.can_cast(80, 'u1'))
print("Result...",np.can_cast(300.7, np.float32))
print("Result...",np.can_cast(120.6, np.float64))
print("Result...",np.can_cast(7.2e100, np.float32))
print("Result...",np.can_cast(6.5e100, np.float64))

コード例

import numpy as np

# numpy.can_cast()メソッドは、キャストルールに従って
# スカラーとデータ型の間でキャストが可能な場合にTrueを返します。
# 第1引数：キャスト元のスカラー、データ型、または配列
# 第2引数：キャスト先のデータ型

print("Checking with can_cast() method in Numpy\n")
print("Result...",np.can_cast(20, 'i1'))
print("Result...",np.can_cast(280, 'i1'))
print("Result...",np.can_cast(80, 'u1'))
print("Result...",np.can_cast(300.7, np.float32))
print("Result...",np.can_cast(120.6, np.float64))
print("Result...",np.can_cast(7.2e100, np.float32))
print("Result...",np.can_cast(6.5e100, np.float64))

出力結果

Checking with can_cast() method in Numpy

Result... True
Result... False
Result... True
Result... True
Result... True
Result... False
Result... True

結果の解説

• 20 → i1（int8）: int8の範囲は-128〜127なので、20は範囲内。True
• 280 → i1（int8）: 280はint8の最大値127を超えるため。False
• 80 → u1（uint8）: uint8の範囲は0〜255なので、80は範囲内。True
• 300.7 → float32: float32で表現可能な範囲内。True
• 120.6 → float64: float64で表現可能な範囲内。True
• 7.2e100 → float32: float32の最大値（約3.4e38）を大幅に超えるため。False
• 6.5e100 → float64: float64の最大値（約1.8e308）以内なので。True