type

Purpose

Returns the symbol table type (matrix, string, etc) of its input argument.

Format

t = type(x)
Parameters:x (any) – local or global symbol, can be an expression.
Returns:t (scalar) –

argument type.

6 matrix
13 string
15 string array
17 structure
21 array
23 structure pointer
38 sparse matrix

Examples

Example 1

// Create a matrix
x = { 1 2,
      3 4 };

// Find type of 'x'
x_type = type(x);

After the above code, x_type will equal: 6, indicating that x is a matrix.

Example 2

// Create a string
x = "myfile.dat";

// Find type of 'x'
x_type = type(x);

After the above code, x_type will equal: 13, indicating that x is a string.

Remarks

type() is often used to verify that inputs to a user defined procedure are valued. For example, if an input is a file name, then it must be a string:

proc (1) = myProc(fname);
    if type(fname) != 13;
        errorlog "Input 'fname' must be a string";
        end;
    endif;
endp;

type() returns the type of a single symbol. The related function typecv() will take a character vector of symbol names and return a vector of either their types or the missing value code for any that are undefined. type() works for the symbol types listed above; typecv() works for user-defined procedures, keywords and functions as well. type() works for global or local symbols; typecv() works only for global symbols.

See also

Functions typecv(), typef()