MATLAB Function Reference

is*

判斷狀態

Syntax

k = iscell(C)                   TF = isnan(A)
k = iscellstr(S)                k = isnumeric(A)
k = ischar(S)                   k = isobject(A)
k = isempty(A)                  TF = isprime(A)
k = isequal(A,B,...)            k = isreal(A)
k = isfield(S,'field')          TF = isspace('str')
TF = isfinite(A)                k = issparse(S)
k = isglobal(NAME)              k = isstruct(S)
TF = isinf(A)                   k = isstudent
TF = isletter('str')            k = isunix
k = islogical(A)

Description

k = iscell(C) 若 C 是異質陣列(cell array)，回傳 1；反之，則回傳 0。

k = iscellstr(S) 若 S 是字串型態的異質陣列，回傳 1；反之，則回傳 0。字串型態的異質陣列是是指其裡面的每個元素是字元陣列。

k = ischar(S) 若 S 是字元陣列(character array)，回傳 1；反之，則回傳 0。

k = isempty(A) 若 A 是空陣列(empty array)，回傳 1；反之，則回傳 0。空陣列是指至少有一個維度的大小為零，例如： 0 x 0 或 0 x 5。

k = isequal(A,B,...) 若輸入的陣列是同樣的型態、大小及內容，回傳 1；反之，則回傳 0。

k = isfield(S,'field')    若 field 是結構陣列 S 裡的，回傳 1。

TF = isfinite(A) 回傳和 A 相同大小的陣列，其元素值取決於 A 中相對應元素的值，若是有限(finite)則為 1；若是無限(infinite)或 NaN，則為 0。

對於任何的 A，在 isfinite(A)，isinf(A)，及 isnan(A) 三個中，一定正好有一個等於 1。

k = isglobal(NAME) 若 NAME 被宣告成全域變數(global variable)，則回傳 1；反之，則回傳 0。

TF = isinf(A) 回傳和 A 相同大小的陣列，其元素值取決於 A 中相對應元素的值，若是正無窮大(+Inf)或負無窮大(-Inf)則為 1﹔反之，則為 0。

TF = isletter('str') 回傳和 'str' 相同大小的陣列，其元素值取決於 'str' 中相對應元素的值，若是字母則為 1﹔反之，則為 0。

k = islogical(A) 若 A 是邏輯陣列(logical array)，回傳 1；反之，則回傳 0。

TF = isnan(A) 回傳和 A 相同大小的陣列，其元素值取決於 A 中相對應元素的值，若是 NaN 則為 1﹔反之，則為 1。

k = isnumeric(A) 若 A 是數值陣列(numeric array)，回傳 1；反之，則回傳 0。例如：稀疏陣列(sparse array)、雙精準度陣列(double-precision array)是數值陣列；而字串(string)、異質陣列(cell array)、及結構陣列(structure array)不是。

k = isobject(A) 若 A 是物件(object)，回傳 1；反之，則回傳 1。

TF = isprime(A) 回傳和 A 相同大小的陣列，其元素值取決於 A 中相對應元素的值，若是質數(prime)則為 1；反之，則為 0。

k = isreal(A) 若 A 的元素是實數(real number)，回傳 1；若不是數值陣列或 A 中元素有非零的虛部，則回傳 0。由於字串是數值陣列的子類別(subclass)，所以對於字串的輸入，isreal 的值為 1。

因為 MATLAB 支援複數，而有些函數計算限定用實數，因此可用 isreal 來判斷。

TF = isspace('str') 回傳和 'str' 相同大小的陣列，其元素值取決於 'str' 中相對應元素的值，若是 ASCII white space 則為 1；反之，則為 0。 ASCII white spaces 包括 space，newline，carriage return，tab，vertical tab，formfeed characters。

k = issparse(S) 若 S 的儲存類別(storage class)是稀疏(sparse)，回傳 1；反之，則回傳 0。

k = isstruct(S) 若 S 是結構(structure)，回傳 1；反之，則回傳 0。

k = isstudent 若 MATLAB 版本為學生用版本，回傳 1；若為商業用版本，則回傳0。

k = isunix 若 MATLAB 版本為 UNIX 版，回傳 1；反之，則回傳 0。

Examples

s = 'A1,B2,C3';

isletter(s)
ans =
      1   0   0   1   0   0   1   0

B = rand(2,2,2);
B(:,:,:) = [];

isempty(B)
ans =
     1

若

A =                 B =                 C =
     1     0             1     0             1     0
     0     1             0     1             0     0

isequal(A,B,C) 回傳 0，而 isequal(A,B) 回傳 1.

若

a = [-2  -1  0  1  2]

則

isfinite(1./a) =  [1  1  0  1  1]
isinf(1./a)  =  [0  0  1  0  0]
isnan(1./a)  =  [0  0  0  0  0]

而

isfinite(0./a) =  [1  1  0  1  1]
isinf(0./a)  =  [0  0  0  0  0]
isnan(0./a)  =  [0  0  1  0  0]

See Also

isappdata, ishandle, ishold, isjava, iskeyword, ismember, isstr, isvalid, isvarname

ipermute

isa