Forms a text structure from any Genstat data structure (A. Keen & J.T.N.M. Thissen).
||What to print for missing value; default
||Structure (scalar, variate, factor, text, table, matrix, symmetricmatrix, diagonalmatrix, pointer) from which the text structure is to be formed|
||Saves the text structure|
||Number of decimals to use when forming the text structure; default * uses the number required to provide 4 significant figures, but unnecessary trailing zeros are ignored|
||How factor values are to be represented in the text structure (
FTEXT can be used to form a text structure from almost any Genstat data structure. The structure from which the text structure is to be formed must be specified using the
STRUCTURE parameter, and can be a scalar, factor, variate, text, table, matrix, symmetricmatrix, diagonalmatrix or pointer. The identifier of the text structure must be specified using the
TEXT parameter. For numerical structures, the number of decimal places to use when forming the text can be set by means of the
DECIMALS parameter. By default the number required to provide four significant figures is used, but unnecessary trailing zeros are ignored. For example, a scalar containing the number 3.250 will be printed with two decimal places, not three. If the
STRUCTURE parameter is set to a factor, parameter
FREPRESENTATION can be used to control the way in which factor values are represented in the text structure. The default is to use labels if available and levels otherwise. If
FREPRESENTATION is set to ordinals, the
DECIMALS parameter is always set to zero for the corresponding factor.
MISSING option allows you to specify a string to be used instead of the default asterisk symbol to represent missing values. For example, you could set
STRUCTURE parameter has been restricted (as is possible only for a variate, factor or text) the length of the text structure will be the length of the restricted structure. The number of decimal places is determined from the values not excluded by the restriction.
Commands for: Calculations and manipulation.
CAPTION 'FTEXT example'; STYLE=meta VARIATE [VALUES=1...10] vari FACTOR [LEVELS=!(2.5,5); VALUES=2(2.5,5)] factlev FACTOR [LABELS=!t(a,b); VALUES=2(1,2)] factlab FTEXT STRUCTURE=vari,factlev,factlab; TEXT=text,textlev,textlab PRINT vari,text PRINT factlev,textlev,factlab,textlab