Softanza
StartFrançais
Softanza
StartFrançais
Reference · stzString

RemoveCharsW()

RemoveCharsWXT(pcCondition): remove every char where the predicate is TRUE. Predicate runs with @char bound.

Basic examples (2)

Softanza
# removing { @char = "2" } leaves "15.450"
? Q("125.450").RemoveCharsWQ('{ @char = "2" }').Content()
Output
15.450

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

Softanza
# removing isDigit(@char) leaves the punctuation and spaces
? Q("(9, 7, 8)").RemoveCharsWQ('isDigit(@char)').Content()
Output
(, , )

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

Scope (4)

Softanza
# the chain just transforms
? Q("1 AA 2 B 3 CCC 4 DD 5 Z").
			RemoveCharsWQ('Q(@Char).IsNumberInString()').
			RemoveSpacesQ().
			RemoveDuplicatedCharsQ().
			Content()
Output
ABCDZ

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

Softanza
# the result is clear, the path forgotten
? Q("1 AA 2 B 3 CCC 4 DD 5 Z").
			RemoveCharsWQ('Q(@Char).IsNumberInString()').
			RemoveSpacesQ().
			RemoveDuplicatedCharsQ().
			Content()
Output
ABCDZ

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

Softanza
# (9, 7, 8) reduces to (,)
? Q("(9, 7, 8)").
			RemoveCharsWQ('Q(@Char).IsNumberInString()').	# becomes (, , )
			RemoveSpacesQ().				# becomes (,,)
			RemoveDuplicatedCharsQ().			# becomes (,)
			Content()
Output
(,)

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

Softanza
# removing the { lower(@char) = "x" } block yields the clean sentence
o = new stzString("
The xCommodore X64X, also known as the XC64 or the CBMx 64, is an x8-bit
home computer introduced in January 1982x by CommodoreXx International
")
o.Simplify()
o.RemoveCharsW('{ lower(@char) = "x" }')
? o.Content()
Output
The Commodore 64, also known as the C64 or the CBM 64, is an 8-bit home computer introduced in January 1982 by Commodore International

run on 2026-10-02 04:24 inside the library at commit 0e72e2e2c; taken from 544_removecharsw.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
yes
does what the method does, then returns the object, so the call can be chained · RemoveCharsWQ
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
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
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