foundLine

returns a chunk expression describing the line in which text was located by the most recent find command.

# Metadata

Platforms: desktop, server, mobile OS: mac, windows, linux, ios, android Introduced: 1.0 Security:

# Syntax

the foundLine

# Examples

the foundLine

if value(the foundLine) contains "*" then answer value(the foundLine)

# Description

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

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

To get a chunk expression describing the word or string that was found, use the foundChunk function.

# Tags

database,

# See

- **keyword:** selection, line - **command:** find - **function:** foundField, mouseLine - **control structure:** function - **glossary:** current card, command, return, chunk expression