Storing into Containers

The put, set, and get commands are used to store values into containers. Several other commands will also change the value of or in a container, for example the turn on an off commands.

put, set commands

The put ... into command is used to assign a value to a container:

put 5 into count

put true into global peace

put customerName into word 2 of line 6 of customerStatement

The set command can do the same thing:

set count = 5

set global peace to be true

set word 2 of line 6 of customerStatement to customerName

Syntax

put source into container
set container [= | to {be {equal to}} | equal] source

Appending Values

The put command (but not set) can also append values at the beginning or end of a container, by specifying before or after instead of into:

put "flower" into wordToMakePlural -- flower

put "s" after wordToMakePlural -- flowers

put heading & return before reportBody

put " " & customerLastName after word 2 of line 6 of customerStatement

put "$" before character firstDigit of Amount

Syntax

put source [before | after] container

Storing Multiple Values At Once

Both the put and set commands can store values into several containers at once. To do this, list the containers separated by commas and enclosed in parentheses or curly braces. If the source value is a single non-list value, that value will be assigned to all of the destination containers:

put zero into (a,b,c) -- sets a, b, and c all to zero

set (startTime, endTime) to "noon"

If the source value is a list, consecutive items from the source list will be assigned to each of the destination containers in turn. Excess values will be ignored:

put (1,2,3) into (a,b,c) -- sets a to 1, b to 2, and c to 3

set (x,y) to (y,x)-- swaps the values of x and y

Source values will be skipped if no container is provided to store them into:

put (1,2,3) into (a,,c) -- sets a to 1, and c to 3 (2 is ignored)

put "html://foo/bar" split by "/" into (scheme,,root,leaf)

Extra values at the end of the source list can be gathered into a single container by using "..." (three dots) after the final container:

put (1,2,3,4) into (a,b...) -- sets a to 1, and b to (2,3,4)

turn on, turn off commands

These commands set the value of a container to on or off:

turn the caseSensitive on

turn off bit 1 of rootflags

Syntax:

turn [on | off] container

turn container [on | off]

get command

The get command offers another way to access a value, which can then be referred to as it:

get the last word of address

if it is "DC" then shipNow

Note: It is actually a local variable that is also stored into by several other commands besides get, including the ask, answer, convert, and read commands and the "repeat with each" form of the repeat command (see All About "It").

Syntax

get source

Other Commands Modify Container Values

Several other commands will also change the contents of containers, including the add, subtract, multiply, divide, insert, replace, and delete commands, and some forms of the convert, read, sort, split, and join commands:

add qty to item productNum of inventoryQty

divide profit by shareholderCount

convert lastUpdate to long date

 

This topic was last updated on January 19, 2022, at 05:39:44 PM.

Eggplant icon Eggplantsoftware.com | Documentation Home | User Forums | Support | Copyright © 2022 Eggplant