getcname

(getcname command_name)

The getcname function lets you retrieve either the primary (underscored) name of a built-in command by specifying a localized command, or the localized command name by specifying the underscored command name.

A primary (underscored) command name is always an English command name.

Argument

The command_name argument specifies the name of the command to evaluate. Usually a localized name is passed to the function.

Return Value

The function returns a string containing the primary (underscored) built-in command name when passing a localized command name to the function. It returns a localized command name when passing an English primary command name. The function returns nil if command_name is an invalid command name.

Examples

Assuming that English is the current program language, passing the English command name "LINE" to the function returns the internal command name "_LINE", and passing "_LINE" returns "LINE":

: (getcname "line")

"_LINE"

: (getcname "_line")

"LINE"

Assuming that the language of the program is set to German:

: (getcname "linie")

"_LINE"

: (getcname "_line")

"LINIE"

However, passing an English command name (without underscore) to the function when German is the current language, causes the function to return nil.

: (getcname "line")

nil