foundChunk

Typefunction
DictionaryLCS
LibraryLiveCode Script
Syntax
the foundChunk
foundChunk()
Summary

Returns a chunk expression describing the location of the text that was found by the most recent find command.

Introduced1.0
OSmac, windows, linux, ios, android
Platformsdesktop, server, mobile
Example
the foundChunk
if the foundChunk is not word 1 of thingToFind then find thingToFind
Values
NameTypeDescription
return

The foundChunk function returns a chunk expression of the form char startChar to endChar of field fieldNumber.

RelatedKeyword: selection, character
Command: find
Function: selectedChunk, foundField
Control Structure: function
Glossary: current card, command, return, chunk expression
Description

Use the foundChunk function after a find command to determine where the text was found.

The foundChunk 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 foundChunk function returns empty.

The return value reports the text that was found: the startChar is the first character of the found text, and the endChar is the last character. For example, if the most recent find command was find "foo bar", either word might have been found.

To get the actual text that was found, use the foundText function.

Tagsdatabase