gtk:text-iter-find-char (iter predicate &key limit direction)

iter -- a gtk:text-iter instance
pred -- a gtk:text-char-predicate callback function to be called on each character
limit -- a gtk:text-iter instance with a search limit, or nil for none, the default is nil
direction -- a :forward value indicates forward search and a :backward value backward search, the default is :forward

True if a match was found.

Advances the iterator, calling the pred function on each character. If direction is :backward goes backward from the iterator.

If the pred callback function returns true, returns true and stops scanning. If the pred callback function never returns true, the iterator is set to limit if limit is non-nil, otherwise to the end iterator. The limit keyword argument has the nil default value. This function combines the gtk_text_iter_forward_find_char() and gtk_text_iter_backward_find_char() functions into one single function using the direction keyword argument.