List Functions
Sawtooth Script: |
Description: |
ADD (ListName) ADD (ListName, Member#) ADD (ListName, StartMember#, EndMember#) |
Adds members from a specified list to the end of the constructed list. |
AddSorted (QuestionName) AddSorted (QuestionName, Direction)
|
Adds members rated/ranked within a multi-part radio/rank/numeric question to a constructed list, in ascending or descending order. Specify a 0 for Direction to indicate descending order; specify 1 for ascending order. |
AIC (QuestionName) AIC (QuestionName, Member#) AIC (QuestionName, StartMember#, EndMember#) |
Add If Chosen: Adds members chosen in a select-type question onto a new constructed list. More info.
|
AIE (QuestionName, Value) |
Add If Equal: Adds members in a grid numeric, grid constant sum, grid ranking, grid with all radio buttons, constant sum, or ranking question that were given answers equal to a specific value. More info. (Also see Loop functions). |
AIG (QuestionName, Value) |
Add If Greater: Adds members in a grid numeric, grid constant sum, grid ranking, grid with all radio buttons, constant sum, or ranking question that were given answers greater than a specific value. More info. (Also see Loop functions). |
AIL (QuestionName, Value) |
Add If Less: Adds members in a grid numeric, grid constant sum, grid ranking, grid with all radio buttons, constant sum, or ranking question that were given answers less than a specific value. More info. (Also see Loop functions). |
ANC (QuestionName) ANC (QuestionName, Member#) ANC (QuestionName, StartMember#, EndMember#) |
Add if Not Chosen: Adds members not chosen in a select-type question onto a new constructed list. |
ANE (QuestionName, Value) |
Add if Not Equal: Adds members in a grid numeric, grid constant sum, grid ranking, grid with all radio buttons, constant sum, or ranking question that were given answers not equal to a specific value. More info. (Also see Loop functions). |
BanditMaxDiff(MaxDiffExerciseName, Items) |
Uses Thompson Sampling to select items from a parent list to add to the constructed list to be shown to a respondent within an adaptive bandit MaxDiff exercise. More info. |
DisplayListLabels (ListName, "SeparatorText", "FinalSeparatorText") |
Returns a string with every list item separated by "SeparatorText" with "FinalSeparatorText" prior to the last list item. For example: DisplayListLabels (fruitlist, "," , "and") returns: grape, peach, and cherry. |
FormatListLabels (ListName, "BeforeText", "AfterText") |
Returns a string with all list items joined together with "BeforeText" before each item and "AfterText" after each item. For example "<li>" and "</li>" as BeforeText and AfterText returns a bulleted list. |
INSERT (TargetPosition#, ListName) INSERT (TargetPosition#, ListName, Member#) INSERT (TargetPosition#, ListName, StartMember#, EndMember#) |
Inserts members from a specified list to an exact position within a constructed list. |
ListHasParentMember (ListName, ParentMember#)
|
Is true if the specified parent member exists in the specified list. |
ListLabel (ListName, Member#) |
Returns the label of a specified member number in a list. |
ListLabelsArray (ListName) |
Returns a comma-separated list of member labels enclosed in quotes. |
ListLength (ListName) |
Returns the number of members in the list. |
ListMax (Value) |
Controls the maximum length of a list. |
ListMin (Value) |
Controls the minimum length of a list.
|
ListValue (ListName, Member#) |
Returns the list member position from the original parent list for the specified member# on the specified constructed list. |
ListValuesArray (ListName) |
Returns an array of list positions from the original parent list for the specified constructed list (example: [1, 4, 6]). |
Click this link for available functions. |
|
Mirror (ListName) Mirror (ListName, Offset) |
Adds list members from the parent list that correspond to the list values in ListName. |
ParentListName() |
Returns the parent list name of the current constructed list. This is useful as input for "ListName" in other constructed list functions. For example: ADD(ParentListName()) |
Randomize () Randomize (SeedValue) Randomize (StartMember#, EndMember#) Randomize (SeedValue, StartMember#, EndMember#) |
Randomizes the members of a constructed list. |
Remove (ListName) Remove (ListName, Member#) Remove (ListName, StartMember#, EndMember#)
|
Removes the members in the specified list from the constructed list. |
Reverse () |
Reverses the members in a list. For example, list members A, B, C, D when reversed become D, C, B, A. |
RIC (QuestionName) RIC (QuestionName, Member#) RIC (QuestionName, StartMember#, EndMember#) |
Remove If Chosen. Removes items from the list that were chosen in QuestionName. |
SetListLength (Value) |
Controls the length of a list. |
SortByLabel () |
Sorts a list based on list labels. Numbers are sorted below letters. |
SortByValue () |
Sorts the members in a constructed list with respect to their natural order (lowest to highest value) from their parent predefined list. For example, list members with values 5, 3, 2, 7 would be sorted as 2, 3, 5, 7. |
