GETNAME procedure

Forms the name of a structure according to its IPRINT attribute (A.R.G. McLachlan).

No options

Parameters

STRUCTURE = identifiers

Structures whose names are to be obtained

NAME = texts

Saves the names of the structures

IDENTIFIER = texts

Saves the identifiers of the structures

EXTRA = texts

Saves the extra texts of the structures

IPRINT = texts

Saves (or forms) IPRINT attributes

Description

Procedure GETNAME can be used to obtain the name from any GenStat data structure.

The structure from which the name is to be obtained must be specified using the STRUCTURE parameter, and can be any data structure. The NAME parameter saves the name, which will be a text containing the identifier and/or the extra text associated with a structure depending on the setting of its IPRINT attribute. If the structure is one that does not have an IPRINT attribute (e.g. an LRV), NAME returns the identifier. If the structure is unnamed, NAME returns a missing text.

The IDENTIFIER parameter can save the identifier of the structure, and the EXTRA parameter can save the extra text from the structure (if any). The IPRINT parameter can save the IPRINT attribute if the structure has one. For structures that do not have an IPRINT attribute, IPRINT is set to 'identifier'. For unnamed structures, IPRINT returns a missing text.

Options: none.

Parameters: STRUCTURE, NAME, IDENTIFIER, EXTRA, IPRINT.

Method

GETNAME Uses GETATTRIBUTE to get the necessary attributes.