get_order

The get_order function returns the string stored in a ordered widget's system-generated order_* variable. These strings are comma-separated numbers where each number refers to an element's original position in the list.

Syntax

[* get_order('widget_label') *]

The widget label, which may refer to a list or a question, must be surrounded in single quotes. [* *] may not necessary, depending on the context.

Example

The get_order function will return any order, for any widget anywhere in the survey source, regardless of whether that widget is defined before or after the get_order instance. In the following example, the order for Q2 is printed on screen.

[* get_order('Q2') *]
 
newpage
 
2. This a question.
type: radio
order:[*]
series: 1..5
 
newpage
 
End