Softanza
StartFrançais
Softanza
StartFrançais
Reference · stzList

Content()

getting the content of the list

Basic examples (2)

Softanza
? @@( Q(["A", "B" ]) * 3 )
? @@( ( Q(["A", "B" ]) * Q(3) ).Content() )
Output
[ "A", "B", "A", "B", "A", "B" ]
[ "A", "B", "A", "B", "A", "B" ]

run on 2026-10-02 04:23 inside the library at commit 0e72e2e2c; taken from 21_pr.ring(opens in a new tab)

Softanza
? @@( Q([4, 44, 444 ]) / 3 )
? @@( ( Q([4, 44, 444 ]) / Q(3) ).Content() )
Output
[ [ 4 ], [ 44 ], [ 444 ] ]
[ [ 4 ], [ 44 ], [ 444 ] ]

run on 2026-10-02 04:23 inside the library at commit 0e72e2e2c; taken from 24_pr.ring(opens in a new tab)

Scope (8)

Softanza
? Q([1, "*", 2, "*", 3 ]) - "*"
? ( Q([1,"*",  2, "*", 3 ]) - Q("*") ).Content()
Output
1
2
3

1
2
3

run on 2026-10-02 04:23 inside the library at commit 0e72e2e2c; taken from 18_pr.ring(opens in a new tab)

Softanza
? ( Q([ "ONE", "TWO", "THREE" ]) * TRUEObject() ).Content()
? @@( ( Q([ "ONE", "TWO", "THREE" ]) * Q(2) ).Content() )
Output
ONE
TWO
THREE

[ "ONE", "TWO", "THREE", "ONE", "TWO", "THREE" ]

run on 2026-10-02 04:22 inside the library at commit 0e72e2e2c; taken from 406_multiply_operator_object.ring(opens in a new tab)

Softanza
? @@( Q(["one", "two", "three", "four", "five", "six" ]) / 3 ) + NL
? @@( ( Q(["one", "two", "three", "four", "five", "six" ]) / Q(3) ).Content() )
Output
[ [ "one", "two" ], [ "three", "four" ], [ "five", "six" ] ]

[ [ "one", "two" ], [ "three", "four" ], [ "five", "six" ] ]

run on 2026-10-02 04:23 inside the library at commit 0e72e2e2c; taken from 23_pr.ring(opens in a new tab)

Softanza
o1 = new stzList(1:7)
o1 - 4:6
? @@( o1.Content() )
Output
[ 1, 2, 3, 4, 5, 6, 7 ]

run on 2026-10-02 04:22 inside the library at commit 0e72e2e2c; taken from 261_minus_operator_range.ring(opens in a new tab)

Softanza
o1 = new stzList(["file1", "file2", "file3" ])
? @@( o1 / 3 ) + NL
? @@( o1.Content() )
Output
[ [ "file1" ], [ "file2" ], [ "file3" ] ]

[ "file1", "file2", "file3" ]

run on 2026-10-02 04:23 inside the library at commit 0e72e2e2c; taken from 582_divide_operator.ring(opens in a new tab)

Softanza
? @@( ( Q([1, 2, 3]) + Q([ 4, 5 ]) ).Content() )
? @@( Q([1, 2, 3]) + Obj(Q([ 4, 5 ])) )
? @@( Q([1, 2, 3]) + ObjQ(Q([ 4, 5 ])) + 6 )
Output
[ 1, 2, 3, [ 4, 5 ] ]
[ 1, 2, 3, @noname ]
[ 1, 2, 3, @noname, 6 ]

run on 2026-10-02 04:22 inside the library at commit 0e72e2e2c; taken from 410_plus_operator_objects.ring(opens in a new tab)

Softanza
o1 = new stzList(["file1", "file2", "file3" ])
? o1 * ".ring"
? o1.Content()
? o1 + "file4"
Output
file1.ring
file2.ring
file3.ring

file1
file2
file3

file1
file2
file3
file4

run on 2026-10-02 04:23 inside the library at commit 0e72e2e2c; taken from 581_multiply_operator_string.ring(opens in a new tab)

Softanza
? Q(1:5) - 3
? ( Q(1:5) - Q(3) ).Content()
? Q([ "A", "B", 1:3, "C" ]) - 1:3
? ( Q([ "A", "B", 1:3, "C" ]) - Q(1:3) ).Content()
Output
1
2
4
5

1
2
4
5

A
B
C

A
B
C

run on 2026-10-02 04:22 inside the library at commit 0e72e2e2c; taken from 400_minus_operator.ring(opens in a new tab)

and 6 more in the tests

The extensions of this method

Each extension, and whether it exists for this method; an extension that exists combines with the others (FindSTCS).

Extension
Exists
What it adds · The names
Q
yes
does what the method does, then returns the object, so the call can be chained · ContentQ, ContentUQ, ContentCSQ, ContentCSUQ
QQ
no
chains on the next, more specific type of object (the Q ladder)
QQQ
no
chains on the most specific type of object (the Q ladder)
QRT
no
returns the result as an object of the requested type
CS
yes
takes a case-sensitivity flag · ContentCS, ContentCSQ, ContentCSU, ContentCSUQ
ST
no
takes the position to start from (StartingAt)
IB
no
takes bounds that are included (IncludingBounds)
XT
no
the extended form: more parameters than the base method
XTT
no
yet another extension: a further extended form, after XT
Z
no
includes the position in what it returns
ZZ
no
returns positions as sections, [start, end]
W
no
selects by a condition
WF
no
selects by a condition, with the expressive keywords (@NextItem, @PreviousItem...)
D
no
takes a direction, forward or backward (Directional)
F
no
takes a function (the condition or the update is given as a function); the forms document also uses F for the future form, which defers the action
Many
no
works on a collection of items instead of one (the plural form)
Except
no
takes exceptions, what to leave out (the exceptional form)
U
yes
returns the result without duplication · ContentU, ContentUQ, ContentCSU, ContentCSUQ

Every example is a test file of the library, run inside the library for this page; only those whose output kept every promise their file wrote are shown.

See also