Count()

Same as CountCS: How many times the given substring occurs.

also written: NumberOfOccurrences

Basic examples (2)

Softanza

oAB  = new stzString("ab")
big  = new stzString( oAB.Repeated(1000000) )
# NumberOfOccurrences('a') is 1,000,000 (> 65536)
? big.NumberOfOccurrences("a")
# FindAll('a') returns all 1,000,000 positions
? len(big.FindAll("a"))
# NumberOfOccurrences('ab') is 1,000,000
? big.NumberOfOccurrences("ab")

Output

1000000
1000000
1000000

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

Softanza

oAB  = new stzString("ab")
big  = new stzString( oAB.Repeated(1000000) )
oE = new stzString("😀🎉")
e  = new stzString( oE.Repeated(50000) )
# NumberOfChars is 100,000 codepoints
? e.NumberOfChars()
# NumberOfOccurrences('😀') is 50,000
? e.NumberOfOccurrences("😀")
# Reversed keeps 100,000 codepoints
? StzLen(e.Reversed())

Output

100000
50000
100000

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

Scope (3)

Softanza

oAB  = new stzString("ab")
big  = new stzString( oAB.Repeated(1000000) )
oRep = new stzString( oAB.Repeated(500000) )   # 1,000,000 chars
oRep.Replace("a", "X")
# after Replace, 'a' is gone
? oRep.NumberOfOccurrences("a")
# after Replace, 'X' is 500,000
? oRep.NumberOfOccurrences("X")
# 'b' is untouched at 500,000
? oRep.NumberOfOccurrences("b")

Output

0
500000
500000

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

Softanza

oAB  = new stzString("ab")
big  = new stzString( oAB.Repeated(1000000) )
oUp = new stzString( big.Uppercased() )
# Uppercased keeps full 2,000,000 length
? oUp.NumberOfChars()
# Uppercased head is 'ABAB'
? oUp.Section(1, 4)
# Uppercased has 1,000,000 'A'
? oUp.NumberOfOccurrences("A")
# Uppercased has zero 'a'
? oUp.NumberOfOccurrences("a")

Output

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

Softanza

oAB  = new stzString("ab")
big  = new stzString( oAB.Repeated(1000000) )
oAr = new stzString("سلام")
ar  = new stzString( oAr.Repeated(100000) )
# NumberOfChars is 400,000 codepoints
? ar.NumberOfChars()
# NumberOfOccurrences('سلام') is 100,000
? ar.NumberOfOccurrences("سلام")
# Contains inner 'لا' is TRUE
? ar.Contains("لا")
# Reversed keeps 400,000 codepoints
? StzLen(ar.Reversed())

Output

run on 2026-10-02 04:24 inside the library at commit 0e72e2e2c; taken from 999_engine_string_millions_narrated.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

does what the method does, then returns the object, so the call can be chained

chains on the next, more specific type of object (the Q ladder)

QQQ

chains on the most specific type of object (the Q ladder)

QRT

returns the result as an object of the requested type

yes

takes a case-sensitivity flag · CountCS, NumberOfOccurrencesCS

takes the position to start from (StartingAt)

takes bounds that are included (IncludingBounds)

yes

the extended form: more parameters than the base method · NumberOfOccurrencesXT

XTT

yet another extension: a further extended form, after XT

includes the position in what it returns

returns positions as sections, [start, end]

selects by a condition

selects by a condition, with the expressive keywords (@NextItem, @PreviousItem...)

takes a direction, forward or backward (Directional)

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

works on a collection of items instead of one (the plural form)

Except

takes exceptions, what to leave out (the exceptional form)

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.

Count()

Basic examples (2)

Scope (3)

The extensions of this method

See also