The function ex_get_variable_names() reads the names of the results variables from the database. Memory must be allocated for the name array before this function is invoked. The names are MAX_STR_LENGTH-characters
in length.
- Returns:
- In case of an error, ex_get_variable_names() returns a negative number; a warning will return a positive number. Possible causes of errors include:
- data file not properly opened with call to ex_create() or ex_open()
- invalid variable type specified.
- a warning value is returned if no variables of the specified type are stored in the file.
- Parameters:
-
[in] | exoid | exodus file ID returned from a previous call to ex_create() or ex_open(). |
[in] | obj_type | Variable indicating the type of variable which is described. Use one of the options in the table below. |
[in] | num_vars | The number of var_type variables that will be read from the database. |
[out] | var_names | Returned array of pointers to num_vars variable names. |
EX_GLOBAL} | Global entity type |
EX_NODAL} | Nodal entity type |
EX_NODE_SET | Node Set entity type |
EX_EDGE_BLOCK | Edge Block entity type |
EX_EDGE_SET | Edge Set entity type |
EX_FACE_BLOCK | Face Block entity type |
EX_FACE_SET | Face Set entity type |
EX_ELEM_BLOCK | Element Block entity type |
EX_ELEM_SET | Element Set entity type |
EX_SIDE_SET | Side Set entity type |
As an example, the following code segment will read the names of the nodal variables stored in the data file: