This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English version of the page.

Note: This page has been translated by MathWorks. Click here to see
To view all translated materials including this page, select Country from the country navigator on the bottom of this page.

isempty

Determine whether array is empty

Syntax

TF = isempty(A)

Description

example

TF = isempty(A) returns logical 1 (true) if A is empty, and logical 0 (false) otherwise. An empty array, table, or timetable has at least one dimension with length 0, such as 0-by-0 or 0-by-5.

Examples

collapse all

Create a 3-D array with one dimension length equal to zero, and determine if it is empty.

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

Compare empty arrays to arrays containing missing values.

In MATLAB®, an empty array has at least one dimension length equal to zero. An array containing missing values, such as NaN or <undefined>, is not necessarily empty.

Create a categorical vector with missing values.

cat1 = categorical([missing missing])
cat1 = 1x2 categorical array
     <undefined>      <undefined> 

Since cat1 does not have a dimension of length zero, it is not empty.

TF1 = isempty(cat1)
TF1 = logical
   0

Create a 0-by-0 categorical array and test if it is empty.

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

Compare empty string arrays and strings with no characters.

Create a string vector whose elements are strings with no characters. str1 is nonempty since none of its dimensions have length zero.

str1 = strings(1,3)
str1 = 1x3 string array
    ""    ""    ""

TF1 = isempty(str1)
TF1 = logical
   0

Create a 0-by-3 string array and test if it is empty.

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

Input Arguments

collapse all

Input array or table, specified as a scalar, vector, matrix, multidimensional array, table, or timetable.

Tips

  • To determine whether a string array has empty strings (string elements with zero characters), use the == operator. For example, if str is a string containing zero characters, then str == "" returns logical 1 (true). For more information on testing empty strings, see Test for Empty Strings and Missing Values. For information on string comparison, see Compare Text.

  • To test for missing values in an array, use the ismissing function.

Extended Capabilities

C/C++ Code Generation
Generate C and C++ code using MATLAB® Coder™.

See Also

|

Introduced before R2006a