The library documents itself · Collections & objects

stzListFinder

30 own methods · 32 forms written with extensions, listed under their method

the source: base/list/stzListFinder.ring(opens in a new tab) · All classes · The area reference: Collections & objects

Under each method, its extensions (Q CS XT Z ZZ IB W U): bold and ticked, it exists; struck, it does not. The extensions and what they mean

Examples: 0 come from the library's tests; 17 were composed from each method's signature and run for this page, on a fresh object, for example o1 = new stzListFinder(["a", "b", "a", "c", "a", "b"]). 13 methods have none yet. Examples run on 2026-10-03 12:54 inside the library at commit 0e72e2e2c.

Method

Explanation, as the source carries it

init

initializationno extension

Content

content accessno extension

NumberOfItems

content access

composed example

o1 = new stzListFinder(["a", "b", "a", "c", "a", "b"])
? o1.NumberOfItems()
#--> 6

composed from the signature, run for this page

no extension

IsEmpty

content access

composed example

o1 = new stzListFinder(["a", "b", "a", "c", "a", "b"])
? o1.IsEmpty()
#--> 0

composed from the signature, run for this page

no extension

FindAllOccurrences

WITHOUT CASESENSITIVITYalso written: FindAllQCSXTZZZIBWUQRT

Find

finding all occurrences of an itemalso written: FindItemQCSXTZZZIBWUMany

AntiFind

finding positions where the item does not exist

composed example

o1 = new stzListFinder(["a", "b", "a", "c", "a", "b"])
? @@( o1.AntiFind("tea") )
#--> [ 1, 2, 3, 4, 5, 6 ]

composed from the signature, run for this page

QCSXTZZZIBWU

AntiFindAsSections

finding sections where the item does not exist

composed example

o1 = new stzListFinder(["a", "b", "a", "c", "a", "b"])
? @@( o1.AntiFindAsSections("tea") )
#--> [ [ 1, 6 ] ]

composed from the signature, run for this page

QCSXTZZZIBWU

AntiPositions

getting the anti-positions of the given positions in the list

composed example

o1 = new stzListFinder(["a", "b", "a", "c", "a", "b"])
? @@( o1.AntiPositions([ 1, 2 ]) )
#--> [ 3, 4, 5, 6 ]

composed from the signature, run for this page

no extension

FindNOccurrences

finding n occurrences of an itemQCSXTZZZIBWU

FindFirst

finding first occurrence of an item in the list

composed example

o1 = new stzListFinder(["a", "b", "a", "c", "a", "b"])
? o1.FindFirst("tea")
#--> 0

composed from the signature, run for this page

QCSXTZZZIBWU

FindLast

finding last occurrence of an item in the list

composed example

o1 = new stzListFinder(["a", "b", "a", "c", "a", "b"])
? o1.FindLast("tea")
#--> 0

composed from the signature, run for this page

QCSXTZZZIBWU

FindNth

finding nth occurrence of an item

composed example

o1 = new stzListFinder(["a", "b", "a", "c", "a", "b"])
? o1.FindNth(2, "tea")
#--> 0

composed from the signature, run for this page

QCSXTZZZIBWU

FindGivenOccurrences

finding given occurrences of an itemQCSXTZZZIBWU

FindAllExceptFirst

finding all except first occurrenceQCSXTZZZIBWU

FindAllExceptLast

finding all except last occurrenceQCSXTZZZIBWU

NumberOfOccurrence

number of occurrences of an item

composed example

o1 = new stzListFinder(["a", "b", "a", "c", "a", "b"])
? o1.NumberOfOccurrence("tea")
#--> 0

composed from the signature, run for this page

QCSXTZZZIBWU

FindNextNthOccurrence

finding next nth occurrence

composed example

o1 = new stzListFinder(["a", "b", "a", "c", "a", "b"])
? o1.FindNextNthOccurrence(2, "tea", 5)
#--> 0

composed from the signature, run for this page

QCSXTZZZIBWU

FindNextOccurrence

finding next occurrence

composed example

o1 = new stzListFinder(["a", "b", "a", "c", "a", "b"])
? o1.FindNextOccurrence("tea", 2)
#--> 0

composed from the signature, run for this page

QCSXTZZZIBWU

FindPreviousNthOccurrence

finding previous nth occurrencealso written: FindPreviousNth

composed example

o1 = new stzListFinder(["a", "b", "a", "c", "a", "b"])
? o1.FindPreviousNthOccurrence(2, "tea", 5)
#--> 0

composed from the signature, run for this page

QCSXTZZZIBWU

FindPreviousOccurrence

finding previous occurrence

composed example

o1 = new stzListFinder(["a", "b", "a", "c", "a", "b"])
? o1.FindPreviousOccurrence("tea", 2)
#--> 0

composed from the signature, run for this page

QCSXTZZZIBWU

CountItemsW

counting items under a conditionno extension

Contains

contains

composed example

o1 = new stzListFinder(["a", "b", "a", "c", "a", "b"])
? o1.Contains("tea")
#--> 0

composed from the signature, run for this page

QCSXTZZZIBWUMany

FindNextOccurrences

Same as FindNextOccurrencesCS: ALL occurrences after / before a positionQCSXTZZZIBWUST

FindPreviousOccurrences

next / previous occurrence search (from a position)QCSXTZZZIBWUST

FindNthNextOccurrence

the n-th occurrence after a position (forward; handles :Of/:StartingAt)also written: FindNextNth · NextNthOccurrence · NthNextOccurrence

composed example

o1 = new stzListFinder(["a", "b", "a", "c", "a", "b"])
? o1.FindNthNextOccurrence(2, "tea", 5)
#--> 0

composed from the signature, run for this page

no extension

FindNext

Same as FindNthNextOccurrence: the n-th occurrence after a position (forward; handles :Of/:StartingAt)also written: FindFirstNext

composed example

o1 = new stzListFinder(["a", "b", "a", "c", "a", "b"])
? o1.FindNext("tea", 2)
#--> 0

composed from the signature, run for this page

no extension

FindPrevious

nearest occurrence before a position (and its forward-indexed nth)also written: FindFirstPrevious

composed example

o1 = new stzListFinder(["a", "b", "a", "c", "a", "b"])
? o1.FindPrevious("tea", 2)
#--> 0

composed from the signature, run for this page

no extension

FindNextNthOccurrencesST

the listed nths (forward index) after / before a positionno extension

FindPreviousNthOccurrences

next / previous occurrence search (from a position)no extension