int8

R2026b

Tableaux de nombres entiers signés de 8 bits

Description

Dans MATLAB^®, les variables ayant le type de données (la classe) int8 sont stockées sous forme de nombres entiers signés de 1 octet (8 bits). Par exemple :

y = int8(10);
whos y

  Name      Size            Bytes  Class    Attributes

  y         1x1                 1  int8                 

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,'int8') crée une matrice de zéros de 100 x 100 de type int8.

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

Syntaxe

Y = int8(X)

Description

Y = int8(X) convertit les valeurs de X vers le type int8. 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 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | char

Exemples

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

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

x = 100;
xtype = class(x)

xtype = 
'double'

y = int8(x)

y = int8

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 int8 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 int8 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 int8 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 int8 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 int8 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 1 octet (8 bits). La sortie est un nombre complexe de type int8 ayant une partie imaginaire nulle.

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

y =

  int8
   1 +   0i

whos

  Name             Size            Bytes  Class     Attributes

  x                1x1                16  double     complex   
  y                1x1                 2  int8       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 int8.

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

y =

  int8
   1

whos

  Name             Size            Bytes  Class     Attributes

  x                1x1                16  double     complex   
  y                1x1                 1  int8                

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

uint8 | int16 | int32 | int64 | cast | typecast

Rubriques

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