string-search

Arguments: text-edit-pane string &key backward case-sensitive (select t)

Searches for the next occurrence of a string in a text control, starting from the current text cursor position. If the string is found, then the index of the first character in the match is returned; otherwise nil is returned.

The arguments are:

• text-edit-pane is the text-edit-pane or rich-edit-pane to search.
• string is the Lisp string to find in the window's text.
• backward: if true, then the search is done toward the beginning of the buffer, starting from the character just before the current text cursor position. Otherwise the search is done toward the end of the buffer, starting from the character just after the current text cursor position. The default is nil, meaning do a forward search.
• case-sensitive: if true, then a case-sensitive search is done; otherwise a case-insensitive search is done. The default is nil meaning do a case-insensitive search.
• select: if true (the default) and a match is found, then the match is selected. Otherwise the text cursor is not moved, and the match position or nil is simply returned as usual.

To ask the user interactively for the search string, it may be useful to call ask-user-for-string or pop-up-string-dialog.

Copyright (c) 1998-2008, Franz Inc. Oakland, CA., USA. All rights reserved.
Documentation for Allegro CL version 8.0. This page was not revised from the 7.0 page.
Created 2005.12.9.