# 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.