$next list item
| (18 intermediate revisions by one user not shown) | |||
| Line 1: | Line 1: | ||
| − | $next list item is a [[ | + | $next list item is a [[Data Functions|Data Function]]. Lists have internal position counters to keep track of where you are. This function will return the list item at the list's current position, and then increment the list's position by one. |
This function is the easiest way to loop through a list sequentially (from position 0 | This function is the easiest way to loop through a list sequentially (from position 0 | ||
to the end of the list). | to the end of the list). | ||
| + | |||
| + | '''List:''' The desired populated list where the next list item will be pulled from. | ||
== Example == | == Example == | ||
| − | + | The contents of a list is used to create alerts using the next list item function. The [[Alert|alert command]] from the [[Flow Commands|flow commands]] is used to create an alert from each list item. | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | |||
| − | |||
| − | |||
| − | + | <pre>add list to list(%my list, $list from text("hello,hi,how are ya", ","), "Delete", "Global") | |
| − | + | set list position(%my list, 0) | |
| − | + | loop($list total(%my list)){alert($next list item(%my list))}</pre> | |
| − | + | ||
| − | |||
| + | [[File:Cap4.jpg]] | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| + | We are populating our list with a list created from text we typed into the list from text function. Our delimiter is the comma. | ||
| + | We are then setting the list position with the set list position command for our list to 0 so that the list starts from the beginning each time the script is run. | ||
| + | Our loop is set to loop according to the number of items in our list. Notice the next list item function inside the alert command. Each loop will pop up each list item from the list and stop when all list items have been shown. | ||
== Additional Information == | == Additional Information == | ||
| − | It is important to note that | + | It is important to note that you must place a [[Set List Position|set list position]] command just above the [[Loop|loop command]]. |
| − | you | + | This allows you to loop through the list as many times as you like without the worry of exceeding |
| − | the range of the list. The set list position command effectively “resets” the list back to | + | the range of the list. The [[Set List Position|set list position]] command effectively “resets” the list back to |
the first position. | the first position. | ||
Latest revision as of 20:51, 27 December 2016
$next list item is a Data Function. Lists have internal position counters to keep track of where you are. This function will return the list item at the list's current position, and then increment the list's position by one. This function is the easiest way to loop through a list sequentially (from position 0 to the end of the list).
List: The desired populated list where the next list item will be pulled from.
[edit] Example
The contents of a list is used to create alerts using the next list item function. The alert command from the flow commands is used to create an alert from each list item.
add list to list(%my list, $list from text("hello,hi,how are ya", ","), "Delete", "Global")
set list position(%my list, 0)
loop($list total(%my list)){alert($next list item(%my list))}
We are populating our list with a list created from text we typed into the list from text function. Our delimiter is the comma.
We are then setting the list position with the set list position command for our list to 0 so that the list starts from the beginning each time the script is run.
Our loop is set to loop according to the number of items in our list. Notice the next list item function inside the alert command. Each loop will pop up each list item from the list and stop when all list items have been shown.
[edit] Additional Information
It is important to note that you must place a set list position command just above the loop command. This allows you to loop through the list as many times as you like without the worry of exceeding the range of the list. The set list position command effectively “resets” the list back to the first position.
