Forms a string listing the identifiers of a set of data structures (R.W. Payne).
Options
STRING = text |
Saves the string |
|---|---|
POINTERNAME = text |
If all the structures are belong to the same pointer, this saves its name |
ELEMENTNAMES = text or variate |
Saves the elements of the pointer, in a text if they have labels, otherwise in a variate |
Parameter
DATA = identifiers |
Data structures to be used to form the string |
|---|
Description
This procedure forms a string listing the identifiers of the data structures specified by the DATA parameter. This is used, for example, by the AREPMEASURES procedure when it appends variates of observations made at successive times into a combined variate for the analysis. FVSTRING is used to form a string listing the variates, and this is then used as the “extra” text for the combined variate. This extra text is displayed in the output from directives like ANOVA. Users can thus see what is actually being analysed.
If the data structures do not belong to a common pointer, the string simply contains their identifiers separated by commas e.g. x,y,z for structures x, y and z. However, if they do belong to a pointer, FVSTRING produces a more succinct string e.g. p[1,3,5] for p[1], p[3] and p[5], or p['a','c','e'] for p['a'], p['c'] and p['e']. The name of the common pointer can be saved by the POINTERNAME option, and the names (numbers or strings) of the elements can be saved by the ELEMENTNAME option.
Options: STRING, POINTERNAME, ELEMENTNAMES.
Parameter: DATA.
See also
Directive: TXCONSTRUCT.
Commands for: Calculations and manipulation.
Example
CAPTION 'FVSTRING example'; STYLE=meta FVSTRING [STRING=abc] a,b,c PRINT abc POINTER [NVALUES=3] p FVSTRING [STRING=pabc] p[] PRINT pabc POINTER [NVALUES=!t(a,b,c)] p FVSTRING [STRING=pabc] p[] PRINT pabc