MATLAB®

mxIsClass (C and Fortran) - Determine whether mxArray is member of specified class

C Syntax

#include "matrix.h"
bool mxIsClass(const mxArray *pm, const char *classname);

Fortran Syntax

integer*4 mxIsClass(pm, classname)
mwPointer pm
character*(*) classname

Arguments

pm

Pointer to an mxArray

classname

The array category that you are testing. Specify classname as a string (not as an integer identifier). You can specify any one of the following predefined constants:

In the table, <class_name> represents the name of a specific MATLAB custom object. You can also specify one of your own class names.

Returns

Logical 1 (true) if pm points to an array having category classname, and logical 0 (false) otherwise.

Description

Each mxArray is tagged as being a certain type. Call mxIsClass to determine whether the specified mxArray has this type.

In C:

mxIsClass(pm, "double");

is equivalent to calling either of these forms:

mxIsDouble(pm);

strcmp(mxGetClassName(pm), "double");

In Fortran:

mxIsClass(pm, 'double')

is equivalent to calling either one of the following:

mxIsDouble(pm)

mxGetClassName(pm) .eq. 'double'

It is most efficient to use the mxIsDouble form.

C Examples

See mxisclass.c in the mx subdirectory of the examples directory.

See Also

mxClassID, mxGetClassID, mxIsEmpty, mxGetClassName

mxIsChar (C and Fortran)

mxIsComplex (C and Fortran)