int16

R2026b

Tableaux de nombres entiers signés de 16 bits

Description

Dans MATLAB^®, les variables ayant le type de données (la classe) int16 sont stockées sous forme de nombres entiers signés de 2 octets (16 bits). Par exemple :

y = int16(10);
whos y

  Name      Size            Bytes  Class    Attributes

  y         1x1                 2  int16                    

Pour plus d’informations sur les types entiers, consultez Nombres entiers.

Création

Certaines fonctions de création de tableau vous permettent de spécifier le type de données. Par exemple, zeros(100,'int16') crée une matrice de zéros de 100 x 100 de type int16.

Si vous avez un tableau de type différent tel que double ou single, vous pouvez le convertir en tableau de type int16 avec la fonction int16.

Syntaxe

Y = int16(X)

Description

Y = int16(X) convertit les valeurs de X vers le type int16. Les valeurs en dehors de la plage [-2¹⁵,2¹⁵-1] sont mappées sur le point d’extrémité le plus proche.

Arguments en entrée

X — Tableau en entrée

scalaire | vecteur | matrice | tableau multidimensionnel

Tableau en entrée, spécifié sous forme de scalaire, de vecteur, de matrice ou de tableau multidimensionnel.

Types de données : double | single | int8 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | char

Exemples

Convertir en variable entière signée de 16 bits

Convertissez une variable double précision en nombre entier signé de 16 bits.

x = 100;
xtype = class(x)

xtype = 
'double'

y = int16(x)

y = int16

100

Capacités étendues

Tall arrays

Calculer avec des arrays possédant plus de rangées que la mémoire ne peut en contenir.

La fonction int16 supporte entièrement les tall arrays. Pour plus d’informations, consultez Tall array.

Génération de code C/C++
Générez du code C et C++ avec MATLAB® Coder™.

Génération de code GPU
Générez du code CUDA® pour les GPU NVIDIA® avec GPU Coder™.

Environnement basé sur les threads

Exécutez du code en arrière-plan avec MATLAB® backgroundPool ou accélérez le code avec Parallel Computing Toolbox™ ThreadPool.

La fonction int16 supporte entièrement les environnements basés sur des threads. Pour plus d’informations, consultez Run MATLAB Functions in Thread-Based Environment.

GPU Arrays

Accélérez le code en exécutant les calculs sur une unité de traitement graphique (GPU) avec Parallel Computing Toolbox™.

La fonction int16 supporte entièrement les GPU arrays. Pour exécuter la fonction sur un GPU, spécifiez les données en entrée en tant que gpuArray (Parallel Computing Toolbox). Pour plus d’informations, consultez Exécuter les fonctions MATLAB sur un GPU (Parallel Computing Toolbox).

Distributed arrays

Divisez les tableaux volumineux dans la mémoire combinée de votre cluster avec Parallel Computing Toolbox™.

La fonction int16 supporte entièrement les distributed arrays. Pour plus d’informations, consultez Exécuter les fonctions MATLAB avec des tableaux distribués (Parallel Computing Toolbox).

Historique des versions

Introduit avant R2006a

R2026a: Conservation de la nature complexe lorsque l’entrée complexe convertie a une partie imaginaire nulle

La fonction int16 conserve la nature complexe lors de la conversion d’une entrée complexe, même si le résultat de la conversion a une partie imaginaire nulle.

Par exemple, convertissez un nombre complexe de type double en nombre entier signé de 2 octets (16 bits). La sortie est un nombre complexe de type int16 ayant une partie imaginaire nulle.

x = complex(1,1e-48);
y = int16(x)

y =

  int16
   1 +   0i

whos

  Name             Size            Bytes  Class     Attributes

  x                1x1                16  double     complex   
  y                1x1                 4  int16      complex   

Si vous vérifiez si le nombre converti est réel, la vérification renvoie un 0 logique.

tf = isreal(y)

tf =

  logical
   0

Dans les versions précédentes, la conversion de ce même nombre renvoie un nombre réel de type int16.

x = complex(1,1e-48);
y = int16(x)

y =

  int16
   1

whos

  Name             Size            Bytes  Class     Attributes

  x                1x1                16  double     complex   
  y                1x1                 2  int16                

Si vous vérifiez si le nombre converti est réel, la vérification renvoie un 1 logique à la place.

tf = isreal(y)

tf =

  logical
   1

Voir aussi

uint16 | int8 | int32 | int64 | cast | typecast

Rubriques

• Nombres entiers
• Identifying Numeric Classes
• Hexadecimal and Binary Values