foundText

Typefunction
DictionaryLCS
LibraryLiveCode Script
Syntax
the foundText
foundText()
Summary

Returns the text located by the most recent find command.

Introduced1.0
OSmac, windows, linux, ios, android
Platformsdesktop, server, mobile
Example
the foundText
put the foundText into whichWord
Values
NameTypeDescription
return

The foundText function returns the text that was found.

RelatedKeyword: word, string, selection
Command: find
Function: clickText, foundField
Control Structure: function
Glossary: command, return, current card
Description

Use the foundText function to determine which word in the search string was found, and whether it matches a whole word or a portion of a word.

Depending on what form of the find command you used, the text found may be different from the text you searched for. For example, the command find "hurl" can find any word that starts with the string "hurl", such as "hurling" or "hurler". In this case, the entire word --not just the portion specified in the find command --is surrounded by a box, and the foundText returns the entire word.

The foundText function is cleared when the text selection moves into the foundField or when the current card is closed. At the same time, the box the find command draws around the found text disappears. If there is no box, the foundText function returns empty.

To get the location of the text that was found, use the foundChunk function.

Tagsdatabase