All Manuals > CAPI Reference Manual > 1 CAPI Reference Entries

NextPrevUpTopContentsIndex

collection-find-next-string

Generic Function
Summary

Finds the next occurence 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 .

See also

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


CAPI Reference Manual - 15 Dec 2011

NextPrevUpTopContentsIndex