$fline » History » Revision 8
Revision 7 (Per Amundsen, 12/23/2019 01:16 AM) → Revision 8/9 (Per Amundsen, 10/09/2020 10:46 PM)
_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>