collection-find-next-string

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`⇩	A 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.