1. Home
  2. FVSTRING procedure

FVSTRING procedure

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
Updated on March 7, 2019

Was this article helpful?