Basic examples (2)
Softanza
o1 = new stzString("The total is 42 dollars and 13 cents.")
o1.MultiplyByN(2)
# both doubled
? o1.Content()
o1.DivideByN(2)
# both halved back
? o1.Content()
o1.AddN(8)
# both plus eight
? o1.Content()
o1.RetrieveN(12)
# both minus twelve
? o1.Content()Output
The total is 84 dollars and 26 cents. The total is 42 dollars and 13 cents. The total is 50 dollars and 21 cents. The total is 38 dollars and 9 cents.
run on 2026-10-02 04:24 inside the library at commit 0e72e2e2c; taken from from_regexuter_03_pr.ring(opens in a new tab)
Softanza
o2 = new stzString("The total is 42 dollars and 13 cents.")
o2.MultiplyByNXT([2, 3])
# 42 by 2, 13 by 3
? o2.Content()
o2.DivideByNXT([ 2, 3 ])
# divided back
? o2.Content()
o2.AddNXT([ 8, 7 ])
# 42 plus 8, 13 plus 7
? o2.Content()
o2.RetrieveNXT([40, 10])
# 50 minus 40, 20 minus 10
? o2.Content()Output
The total is 84 dollars and 39 cents. The total is 42 dollars and 13 cents. The total is 50 dollars and 20 cents. The total is 10 dollars and 10 cents.
run on 2026-10-02 04:24 inside the library at commit 0e72e2e2c; taken from from_regexuter_03_pr.ring(opens in a new tab)
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
no
does what the method does, then returns the object, so the call can be chained
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
no
takes a case-sensitivity flag
ST
no
takes the position to start from (StartingAt)
IB
no
takes bounds that are included (IncludingBounds)
XT
yes
the extended form: more parameters than the base method · DivideByNXT
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
no
returns the result without duplication
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
- The class stzString
- The area's reference: String
- The other methods in these examples: stzString.AddN · stzString.MultiplyByN · stzString.RetrieveN

