Project

General

Profile

$bfind » History » Version 15

Per Amundsen, 02/16/2023 09:09 PM

1 1 Per Amundsen
_Added in 1.9.0_
2
3 10 Per Amundsen
*$bfind(&binvar, N, M, [name])*
4 1 Per Amundsen
5
Searches a &binvar for a matching value.
6
7
_The search is case-insensitive._
8
9
*Parameters*
10
11 15 Per Amundsen
table(ktable).
12
|*Parameter*|*Description*|
13
| &binvar | The &binvar to search. |
14
| N | The position of the &binvar to start the search. |
15
| M | Numeric "ASCII":http://www.asciitable.com/ character(s) or text to search. |
16
| [name] | Name to store in [[$regml]] for the result(s) when using the .regex property. (optional) |
17 1 Per Amundsen
18 11 Per Amundsen
*Properties*
19 1 Per Amundsen
20 15 Per Amundsen
table(ktable).
21
|*Property*|*Description*|
22
| .text | Force a text search if the search text (M) is a number. |
23
| .textcs | Search case-sensitive. |
24
| .regex | *TODO* |
25
| .regextext | Performs a [[Scripting_Regex<notextile>|</notextile>regular expression]] search for the pattern *M* on UTF8 encoded text from the binvar. *(AdiIRC Only)* |
26 1 Per Amundsen
27
*Example*
28
29
<pre>
30 6 Per Amundsen
; Finds "test" starting from position 1.
31 1 Per Amundsen
//echo -a $bfind(&test, 1, test)
32
 
33 6 Per Amundsen
; Finds character 32 (a space) from position 5.
34 1 Per Amundsen
//echo -a $bfind(&test, 5, 32)
35
36 6 Per Amundsen
; Finds WAV from position 1.
37 1 Per Amundsen
//echo -a $bfind(&test, 1, 87 65 86)
38
</pre>