cast

Convertir una variable a un tipo de datos diferente

Sintaxis

B = cast(A,newclass)

B = cast(A,like=p)

Descripción

B = cast(A,newclass) devuelve los datos de A convertidos al tipo de datos (clase) newclass, donde newclass es el nombre de un tipo de datos integrado compatible con A. Cualquier valor de A que esté fuera del rango de newclass se trunca en B con el punto final más cercano.

Cuando se convierte un número de punto flotante en un entero, la función cast redondea el número al entero más cercano. Si el número de punto flotante tiene una parte fraccionaria de exactamente 0,5, se redondea alejándose de cero hacia el entero de mayor magnitud.

B = cast(A,like=p) convierte A al mismo tipo de datos y dispersión que la variable p. La complejidad (real o complejo) de B está determinada por A y p. Si tanto A como p son reales, B también es real. De lo contrario, B será complejo.

Ejemplos

Convertir tipo de datos numéricos

Convierta los valores int8 en uint8.

Defina un vector de enteros de 8 bits.

a = int8([-5 5]);

Convierta a en enteros de 8 bits sin signo. El valor –5 fuera del rango de uint8 está truncado a 0.

b = cast(a,"uint8")

b = 1×2 uint8 row vector

   0   5

Convertir un vector a un tipo de datos existente

Cree un vector de 1 por 3 de enteros con signo de 32 bits.

A = int32([-12 34 56])

A = 1×3 int32 row vector

   -12    34    56

Cree un número complejo del tipo de datos double.

p = 1+2i

p = 
1.0000 + 2.0000i

Convierta A al mismo tipo de datos y complejidad que la variable p.

B = cast(A,like=p)

B = 1×3 complex

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

Convertir una matriz a un tipo de datos existente

Cree una matriz de ceros de 2 por 3 cuyos elementos sean enteros sin signo de 32 bits.

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

A = 2×3 uint32 matrix

   0   0   0
   0   0   0

Cree una matriz dispersa de 2 por 2 del tipo de datos double.

p = sparse(2,2,pi)

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

Convierta A al mismo tipo de datos y dispersión que la variable p.

B = cast(A,like=p)

B = 2×3 sparse double matrix
   All zero

Argumentos de entrada

A — Arreglo de entrada

escalar | vector | matriz | arreglo multidimensional

Arreglo de entrada, especificado como escalar, vector, matriz o arreglo multidimensional. El tipo de datos de A puede ser un tipo de datos integrado u otro tipo de datos compatible con la conversión al nuevo tipo de datos especificado.

Tipos de datos: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | char
Soporte de números complejos: Sí

newclass — Nueva clase

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

Nueva clase, especificada como "single", "double", "int8", "int16", "int32", "int64", "uint8", "uint16", "uint32", "uint64", "logical" o "char".

p — Prototipo

escalar | vector | matriz | arreglo multidimensional

Prototipo, especificado como escalar, vector, matriz o arreglo multidimensional. El tipo de datos de p puede ser un tipo de datos integrado u otro tipo de datos compatible con la conversión desde el tipo de datos de entrada.

Tipos de datos: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | char
Soporte de números complejos: Sí

Argumentos de salida

B — Arreglo de salida

escalar | vector | matriz | arreglo multidimensional

Arreglo de salida, devuelto como escalar, vector, matriz o arreglo multidimensional.

Capacidades ampliadas

Generación de código C/C++

Genere código C y C++ mediante MATLAB® Coder™.

Notas y limitaciones de uso:

• Las entradas de enumeración deben ser un valor escalar en el momento de la compilación. No se admiten los arreglos de enumeraciones.

Generación de código de GPU

Genere código CUDA® para GPU NVIDIA® mediante GPU Coder™.

Notas y limitaciones de uso:

• Las entradas de enumeración deben ser un valor escalar en el momento de la compilación. No se admiten los arreglos de enumeraciones.

Entorno basado en subprocesos

Ejecute código en segundo plano con MATLAB® backgroundPool o acelere código con Parallel Computing Toolbox™ ThreadPool.

Esta función es totalmente compatible con entornos basados en subprocesos. Para obtener más información, consulte Ejecutar funciones de MATLAB en entornos basados en subprocesos.

Arreglos GPU

Acelere código mediante la ejecución en una unidad de procesamiento gráfico (GPU) mediante Parallel Computing Toolbox™.

La función cast es compatible con entradas de arreglos de GPU con estas notas y limitaciones de uso:

• En la sintaxis B = cast(A,like=p), la salida B es un gpuArray si y solo si p es un gpuArray.

Para obtener más información, consulte Run MATLAB Functions on a GPU (Parallel Computing Toolbox).

Arreglos distribuidos

Realice particiones de arreglos grandes por toda la memoria combinada de su cluster mediante Parallel Computing Toolbox™.

Notas y limitaciones de uso:

• En la sintaxis B = cast(A,like=p), la salida B es un arreglo distribuido si y solo si p es un arreglo distribuido.

Para obtener más información, consulte Run MATLAB Functions with Distributed Arrays (Parallel Computing Toolbox).

Historial de versiones

Introducido antes de R2006a

R2022a: cast devuelve una salida consistente para la subclase de tipos numéricos de MATLAB

A partir de la versión R2022a, la sintaxis cast(A,like=p) devuelve una salida consistente con el prototipo p cuando el tipo de datos de p es una subclase de tipos numéricos de MATLAB^®.

Por ejemplo, este código devuelve ahora una salida que tiene el mismo tipo de datos que p:

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

x = 

  OnOffSwitchState enumeration

    on

En versiones anteriores, el código devuelve x = 1 con el tipo de datos logical.

R2021b: El argumento de entrada newclass distingue entre mayúsculas y minúsculas

A partir de la versión R2021b, el argumento de entrada newclass de la sintaxis cast(A,newclass) distingue entre mayúsculas y minúsculas. Debe especificar newclass como un vector de caracteres o una cadena de letras minúsculas que representa el nuevo tipo de datos.

Por ejemplo, para convertir un valor double a un tipo de datos int8, debe utilizar cast(1.234,"int8"). El comando cast(1.234,"Int8") ahora da error.

Consulte también

class | typecast

Temas

• Class Support for Array-Creation Functions