mxGetName, mxSetName

Purpose

Get and set the name of a Matrix.

C Synopsis

char *mxGetName(pm)
  Matrix *pm;
void mxSetName(pm,name)
  Matrix *pm;
  char *name;

Fortran Synopsis

character*20 function mxGetName(pm)
subroutine mxSetName(pm,name)
integer*4 pm
character*(*) name

Arguments

name
pointer to the Matrix name character string
pm
pointer to the Matrix structure

Description

These routines let you get and set the name of a Matrix object.mxGetName returns a pointer to the NULL-terminated character string containing the name. mxSetName copies up to mxMAXNAM characters from name into the Matrix object's name.

MATLAB variable names are stored in fixed-length character arrays of length mxMAXNAM+1, where mxMAXNAM is defined in the file matrix.h. Thus variable names can by any length up to mxMAXNAM. The actual length is determined by the NULL terminator.

If there is no name, mxGetName returns a NULL character.

(c) Copyright 1994 by The MathWorks, Inc.