cast

変数を別のデータ型に変換

構文

B = cast(A,newtype)

B = cast(A,like=p)

説明

B = cast(A,newtype) は、A のデータをデータ型 (クラス) newtype に変換して返します。ここで newtype は、A と互換性のある組み込みデータ型の名前です。A の値のうち、newtype の範囲外であるものは、B で最も近い端点まで切り捨てられます。

浮動小数点数を整数に変換するとき、関数 cast は数値を最も近い整数に丸めます。浮動小数点数の小数部が厳密に 0.5 の場合、これはゼロ方向とは反対の絶対値が大きい方の整数に丸めます。

B = cast(A,like=p) は、A を変数 p と同じデータ型およびスパース性に変換します。B の実数/複素数 (実数または複素数のいずれであるか) は、A と p の両方によって決まります。A と p の両方が実数である場合、B も実数です。そうでない場合、B は複素数です。

例

数値データ型の変換

int8 値を uint8 に変換します。

8 ビット整数のベクトルを定義します。

a = int8([-5 5]);

a を符号なしの 8 ビット整数に変換します。uint8 の範囲外である -5 の値は 0 に切り捨てられます。

b = cast(a,"uint8")

b = 1×2 uint8 row vector

   0   5

ベクトルの既存のデータ型への変換

32 ビットの符号付き整数の 1 行 3 列のベクトルを作成します。

A = int32([-12 34 56])

A = 1×3 int32 row vector

   -12    34    56

データ型が double の複素数を作成します。

p = 1+2i

p = 
1.0000 + 2.0000i

A を、変数 p と同じデータ型と実数/複素数に変換します。

B = cast(A,like=p)

B = 1×3 complex

 -12.0000 + 0.0000i  34.0000 + 0.0000i  56.0000 + 0.0000i

行列の既存のデータ型への変換

要素が 32 ビットの符号なし整数である 2 行 3 列のゼロの行列を作成します。

A = zeros(2,3,"uint32")

A = 2×3 uint32 matrix

   0   0   0
   0   0   0

データ型が double の 2 行 2 列のスパース行列を作成します。

p = sparse(2,2,pi)

p = 2×2 sparse double matrix (1 nonzero)
   (2,2)       3.1416

A を変数 p と同じデータ型およびスパース性に変換します。

B = cast(A,like=p)

B = 2×3 sparse double matrix
   All zero

入力引数

A — 入力配列

スカラー | ベクトル | 行列 | 多次元配列

入力配列。スカラー、ベクトル、行列または多次元配列として指定します。A のデータ型は、組み込みデータ型、または指定された新しいデータ型への変換をサポートする他のデータ型にすることができます。

データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | char
複素数のサポート: あり

newtype — 新しいデータ型

"single" | "double" | "int8" | "int16" | "int32" | "int64" | ...

新しいデータ型。"single"、"double"、"int8"、"int16"、"int32"、"int64"、"uint8"、"uint16"、"uint32"、"uint64"、"logical"、または "char" として指定します。

p — プロトタイプ

スカラー | ベクトル | 行列 | 多次元配列

プロトタイプ。スカラー、ベクトル、行列、または多次元配列として指定します。p のデータ型は、組み込みデータ型、または入力データ型からの変換をサポートする他の互換性のあるデータ型にすることができます。

データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | char
複素数のサポート: あり

出力引数

B — 出力配列

スカラー | ベクトル | 行列 | 多次元配列

出力配列。スカラー、ベクトル、行列または多次元配列として返されます。

拡張機能

C/C++ コード生成

MATLAB® Coder™ を使用して C および C++ コードを生成します。

使用上の注意および制限:

• 列挙型入力は、コンパイル時にスカラー値でなければなりません。列挙型の配列はサポートされていません。

GPU コード生成

GPU Coder™ を使用して NVIDIA® GPU のための CUDA® コードを生成します。

使用上の注意および制限:

• 列挙型入力は、コンパイル時にスカラー値でなければなりません。列挙型の配列はサポートされていません。

スレッドベースの環境

MATLAB® の backgroundPool を使用してバックグラウンドでコードを実行するか、Parallel Computing Toolbox™ の ThreadPool を使用してコードを高速化します。

cast 関数はスレッドベースの環境を完全にサポートしています。詳細については、スレッドベースの環境での MATLAB 関数の実行を参照してください。

GPU 配列

Parallel Computing Toolbox™ を使用してグラフィックス処理装置 (GPU) 上で実行することにより、コードを高速化します。

cast 関数は GPU 配列入力をサポートしますが、次の使用上の注意および制限があります。

• 構文 B = cast(A,like=p) では、p が gpuArray である場合にのみ、出力 B が gpuArray になります。

詳細については、GPU での MATLAB 関数の実行 (Parallel Computing Toolbox)を参照してください。

分散配列

Parallel Computing Toolbox™ を使用して、クラスターの結合メモリ上で大きなアレイを分割します。

cast 関数は分散配列をサポートしますが、次の使用上の注意および制限があります。

• 構文 B = cast(A,like=p) では、p が分散配列である場合にのみ、出力 B が分散配列になります。

詳細については、分散配列を使用した MATLAB 関数の実行 (Parallel Computing Toolbox)を参照してください。

バージョン履歴

R2006a より前に導入

R2026a: 変換後の複素数入力の虚数部がゼロの場合に実数/複素数を維持

cast(A,newtype) 構文は、複素数入力を変換するとき、変換結果の虚数部がゼロの場合でも実数/複素数を維持します。

たとえば、double 型の複素数について考えてみます。この数値を single 型に変換します。出力は虚数部がゼロの single 型の複素数になります。

a = complex(1,1e-48);
b = cast(a,"single")

b =

  single
   1.0000 + 0.0000i

whos

  Name             Size            Bytes  Class     Attributes

  a                1x1                16  double    complex   
  b                1x1                 8  single    complex   

変換後の数値が実数かどうかを確認すると、logical 0 が返されます。

tf = isreal(b)

tf =

  logical
   0

比較として、以前のリリースでは、これと同じ数値を変換すると single 型の実数が返されます。

a = complex(1,1e-48);
b = cast(a,"single")

b =

  single
     1

whos

  Name             Size            Bytes  Class     Attributes

  a                1x1                16  double     complex   
  b                1x1                 4  single               

変換後の数値が実数かどうかを確認すると、代わりに logical 1 が返されます。

tf = isreal(b)

tf =

  logical
   1

R2022a: cast は MATLAB 数値型のサブクラスについて一貫した出力を返す

R2022a 以降、構文 cast(A,like=p) は、プロトタイプ p のデータ型が MATLAB^® 数値型のサブクラスである場合、p と一致する出力を返します。

たとえば、次のコードは p と同じデータ型の出力を返します。

p = matlab.lang.OnOffSwitchState.on;
x = cast(1,like=p)

x = 

  OnOffSwitchState enumeration

    on

以前のリリースでは、このコードはデータ型が logical である x = 1 を返します。

R2021b: 入力引数 newtype で大文字と小文字を区別

R2021b 以降では、構文 cast(A,newtype) の入力引数 newtype で大文字と小文字が区別されます。newtype は、新しいデータ型を表す小文字の文字ベクトルまたは string として指定する必要があります。

たとえば、double の値を int8 データ型に変換するには、cast(1.234,"int8") を使用する必要があります。コマンド cast(1.234,"Int8") は現在はエラーになります。

参考

class | typecast

トピック

• 配列作成関数に対するクラス サポート