All Manuals > CAPI User Guide and Reference Manual > 21 CAPI Reference Entries

collection-find-next-string Generic Function

Summary

Finds the next occurrence of the string that was previously searched for in a collection.

Package

capi

Signature

collection-find-next-string collection &key set => index

Arguments
collection
set
A boolean.
Values
index
A non-negative integer or nil.
Description

The generic function collection-find-next-string must be called after one of collection-search, collection-find-string or find-string-in-collection was called on collection. It searches for the next item in collection with printed representation matching the last string searched for and returns its index, or nil if no match is found.

If set is true, then if an item matching the string is found, the selection is set to this item. set defaults to t.

See also

collection-find-string
collection-last-search
find-string-in-collection


CAPI User Guide and Reference Manual (Unix version) - 01 Dec 2021 19:32:42