uint16

R2026b

Tableaux de nombres entiers non signés de 16 bits

Description

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

y = uint16(10);
whos y

  Name      Size            Bytes  Class     Attributes

  y         1x1                 2  uint16                     

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

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

Syntaxe

Y = uint16(X)

Description

Y = uint16(X) convertit les valeurs de X vers le type uint16. Les valeurs en dehors de la plage [0,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 | int16 | int32 | int64 | uint8 | uint32 | uint64 | logical | char

Exemples

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

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

x = 100;
xtype = class(x)

xtype = 
'double'

y = uint16(x)

y = uint16

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 uint16 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 uint16 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 uint16 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 uint16 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 uint16 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 non signé de 2 octets (16 bits). La sortie est un nombre complexe de type uint16 ayant une partie imaginaire nulle.

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

y =

  uint16
   1 +   0i

whos

  Name             Size            Bytes  Class     Attributes

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

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

y =

  uint16
   1

whos

  Name             Size            Bytes  Class     Attributes

  x                1x1                16  double     complex   
  y                1x1                 2  uint16               

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 | uint32 | uint64 | int16 | cast | typecast

Rubriques

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