|
|
Purpose
|
Assigns a name to a dimension. |
|
|
Return value
|
Returns SUCCEED (or 0) if successful and FAIL (or -1) otherwise. |
|
|
Description
|
SDsetdimname sets the name of the dimension identified by the parameter dim_id to the value specified in the parameter dim_name. Dimensions that are not explicitly named by the user will have the default name of "fakeDim[x]" specified by the HDF library, where [x] denotes the dimension index. |
|
|
|
If another dimension exists with the same name it is assumed that they refer to the same dimension object and changes to one will be reflected in the other. If the dimension with the same name has a different size, an error condition will result. |
|
|
|
Naming dimensions is optional but encouraged. |
|
|
|
The length of the parameter dim_name can be at most 64 characters. |