isempty

Déterminer si un tableau est vide

Syntaxe

TF = isempty(A)

Description

TF = isempty(A) renvoie la valeur logique 1 (true) si A est vide et la valeur logique 0 (false) dans le cas contraire. Un tableau, une table ou une timetable vide a au moins une dimension de longueur 0, par exemple 0 x 0 ou 0 x 5.

Exemples

Tableau multidimensionnel vide

Créez un tableau 3D dont une longueur de dimension est égale à zéro puis déterminez s’il est vide.

A = zeros(0,2,2);
TF = isempty(A)

TF = logical
   1

Tableaux vides et valeurs manquantes

Comparez des tableaux vides à des tableaux comportant des valeurs manquantes.

Dans MATLAB®, un tableau vide a au moins une longueur de dimension égale à zéro. Un tableau comportant des valeurs manquantes telles que NaN ou <undefined> n’est pas nécessairement vide.

Créez un vecteur catégoriel avec des valeurs manquantes.

cat1 = categorical([missing missing])

cat1 = 1×2 categorical
     <undefined>      <undefined> 

Comme cat1 n’a aucune dimension de longueur égale à zéro, il n’est pas vide.

TF1 = isempty(cat1)

TF1 = logical
   0

Créez un tableau catégoriel de 0 x 0 et testez s’il est vide.

cat2 = categorical([]);
TF2 = isempty(cat2)

TF2 = logical
   1

Tableaux de chaînes de caractères vides

Comparez des tableaux de chaînes de caractères vides et des chaînes de caractères ne contenant aucun caractère.

Créez un vecteur de chaînes de caractères dont les éléments sont des chaînes de caractères ne contenant aucun caractère. str1 n’est pas vide, car aucune de ses dimensions n’a une longueur égale à zéro.

str1 = strings(1,3)

str1 = 1×3 string
    ""    ""    ""

TF1 = isempty(str1)

TF1 = logical
   0

Créez un tableau de chaînes de caractères de 0 x 3 et testez s’il est vide.

str2 = strings(0,3);
TF2 = isempty(str2)

TF2 = logical
   1

Arguments d'entrée

A — Tableau en entrée

scalaire | vecteur | matrice | tableau multidimensionnel | table | timetable

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

Conseils

• Pour déterminer si un tableau de chaînes de caractères comporte des chaînes de caractères vides (éléments de chaîne de caractères avec zéro caractère), utilisez l’opérateur ==. Par exemple, si str est une chaîne de caractères contenant zéro caractère, str == "" renvoie la valeur logique 1 (true). Pour plus d’informations sur les tests de chaînes de caractères vides, consultez Test for Empty Strings and Missing Values. Pour plus d’informations sur la comparaison de chaînes de caractères, consultez Compare Text.

• Pour tester si un tableau comporte des valeurs manquantes, utilisez la fonction ismissing.

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 isempty 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 HDL
Générez du code VHDL, Verilog et SystemVerilog pour les designs FPGA et ASIC avec HLD 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.

Cette fonction 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 isempty 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™.

Cette fonction 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

Voir aussi

ismissing | eq