Lists Codeblocks Reference

What's New: 2027

List codeblocks are used to create and manipulate lists of values, for example numbers or strings.

Create List

The create list codeblock is used to create a collection of items.

Items in a list may be of any type; examples include strings, numbers, booleans, or variables, or even other lists.

Items with the same value can appear in the list multiple times.

Create List With

The create list with codeblock is used to create a collection, containing multiple copies of an item.

The item to be copied can be of any datatype. The repeat input must be a whole number.

Length of List

The length of list codeblock returns a number, corresponding to the number of items in the list.

Is Empty List

The is empty list codeblock returns 'True' if the input list is empty. Any other input (including a non-list) returns 'False'.

The input must be a list.

In List

The 'in list' codeblock searches a list for an item. Items can be number, string, boolean, or variable.

If the item is found, the position of the input in the list is returned as a number. The first position in the list is '1'.

If the item is not found in the list '0' is returned.

Find item in list has two options:

• First returns the index of the first occurrence of the item in the list.
• Last returns the index of the last occurrence of the item in the list.

Get and Remove from List

The get and remove codeblock is used to get items from a list, or remove items from a list.

The get and remove codeblock has two controls, with the following options:

• Item

  • get returns an item from a list
  • get and remove returns an item from a list, and removes it from the list
  • remove removes an item from the list

• Position

  • # the position of the item from the beginning of the list
  • # from end the position of the item from the end of the list
  • first the first item in the list
  • last the last items in the list
  • random a random item from the list, with equal probability

Set and Insert in List

The set and insert in list codeblock is used to add and replace items in a list.

The set and insert codeblock has two controls, with the following options:

• Item

  • set replaces the item at the given position in the list
  • insert at adds a new item to the list, at the given position

• Position

  • # the position of the item from the beginning of the list, the first item is position 1.
  • # from end the position of the item from the end of the list, the last item is position 1.
  • first the first item in the list
  • last the last item in the list
  • random a random item from the list, with equal probability

Get Sublist

The get sublist codeblock is used to get a concurrent sublist of items from a list.

The get sublist codeblock has two position controls, with the following options;

• Start Position

  • # the position of the first item from the beginning of the list
  • # from end the position of the first item from the beginning of the list
  • first the first item in the list

• End position

  • # the position of the last item from the beginning of the list
  • # from end the position of the last item from the end of the list
  • last the last items in the list

Make List From

The make list from codeblock is used to convert delimited text into a list, or make a list into delimited text.

The delimiter can be a space, comma, or semicolon.

The make list from codeblock has two options:

• list from text returns a list from delimited test
• text from list returns delimited text from a list

Sort List

The sort list codeblock returns an ordered copy of a list.

The sort list codeblock has two functions:

• Type

  • numeric orders a list of numbers
  • alphabetic orders a list of words, uppercase, then lowercase
  • alphabetic, ignore case orders a list of words, ignoring case

• Order

  • ascending smallest to largest, or alphabetically
  • descending largest to smallest, or reverse alphabetical