NAG Library Function Document

1Purpose

nag_enum_value_to_name (x04nbc) returns the name of the NAG enumeration member given the enumeration member's value.

2Specification

 #include #include
 const char * nag_enum_value_to_name (int enum_value)

3Description

nag_enum_value_to_name (x04nbc) takes an integer argument, which must be the value of a NAG enumeration member and returns a string which is the name of that member (e.g., "Nag_ColMajor", "Nag_LogNormal", etc.). If the input value does not correspond to a NAG enumeration member then the function returns $0$.
The reverse process of converting from enumeration member name to enumeration member value is also available using nag_enum_name_to_value (x04nac).
Converting enumeration members to and from name and value may be of use when saving a set of problem arguments to file or reading problem arguments from a file for use in an application. In the case of saving problem arguments, any enumeration members to be saved should be saved using their names to be subsequently read as strings. nag_enum_value_to_name (x04nbc) can be used to get enumeration member names for writing.

None.

5Arguments

1:    $\mathbf{enum_value}$intInput
On entry: the value of a NAG enumeration member.

6Error Indicators and Warnings

If the value $0$ is returned then the input value is not recognized as a valid NAG enumeration member value.

Not applicable.

8Parallelism and Performance

nag_enum_value_to_name (x04nbc) is not threaded in any implementation.

None.

10Example

This example takes a set of NAG enumeration members and checks that the value used has a name that matches the member name.

10.1Program Text

Program Text (x04nbce.c)

None.

10.3Program Results

Program Results (x04nbce.r)

© The Numerical Algorithms Group Ltd, Oxford, UK. 2017