AdiIRC

_Added in 1.9.0_

*$fline(@name,wildtext,[N],[T],[S])*

Returns Nth position of line which matches the specified [[Scripting_Wildcards|wildcard]] text.

_See also [[$flinen]]._

*Parameters*

@name - The custom window name to search.

wildtext - [[Scripting_Wildcards|Wildcard]] text to search for.

[N] - If N = 0 returns number of matches, otherwise the Nth match. (Optional, default is 1)

[T] - If T = 0 reference the display area (default), If T is 1, it references the listbox, 2 implies that wildtext is a 

[[Scripting_Regex|regular expression]], and 3 for both. (Optional)

[S] - Start the search at the Sth line.

*Properties*

.text - Returns the matched text.

*Example*

<pre>

; Open a custom window.

/window @Example

; Add some lines

/aline @Example Test1

/aline @Example Test2

/aline @Example Test3

; Search the display area for the wildtext 'Text*' and print number of results.

//echo -ag $fline(@Example, Test*, 0)

; Search the display area for the wildtext 'Text*' and print the second result.

//echo -ag $fline(@Example, Test*, 2)

</pre>