Skip to main content

More List Functions

Additional functions for working with lists:

  • $ListValid determines whether a string is a list.

  • $ListFromString returns a list built from a delimited string.

  • $ListToString returns a delimited string built from a list.

  • $ListSame compares 2 lists item by item, and returns 1 if they are identical, 0 otherwise.

  • $ListNext advances sequentially from one list item to the next.

  • Set $ListBuild sets a list of variables to a list of values, one by one.

Note:

The $ListNext function changes the value of its second and third arguments.

SAMPLES>set addr = "One Memorial Drive", city = "Cambridge"

SAMPLES>set st = "MA", zip = "02142"

SAMPLES>set Pmail = addr _ "^" _ city _ "^" _ st _ "^" _ zip

SAMPLES>set Lmail = $listfromstring(Pmail, "^")

SAMPLES>write $listvalid(Lmail)
1
SAMPLES>write $listvalid(Pmail)
0
SAMPLES>write $list(Lmail, 2)
Cambridge
SAMPLES>write $listlength(Lmail)
4
SAMPLES>write $listfind(Lmail, "MA")
3
SAMPLES>set Pmail = $listtostring(Lmail,"*")

SAMPLES>write Pmail
One Memorial Drive*Cambridge*MA*02142
SAMPLES>set Lmail2 = $listbuild("One Memorial Drive","Cambridge","MA","02141")

SAMPLES>write $listsame(Lmail, Lmail2)  // not the same because of different zip
0
SAMPLES>set p = 0 while $listnext(Lmail, p, value) { write !, value }
One Memorial Drive
Cambridge
MA
02142
SAMPLES>set $listbuild(addr2, city2, st2, zip2) = Lmail2

SAMPLES>write addr2, !, city2, !, st2, !, zip2
One Memorial Drive
Cambridge
MA
02141
SAMPLES>
FeedbackOpens in a new tab