Revision as of 18:14, 7 July 2020

$bfind searches &binvar for a matching value.

Synopsis

$bfind(&binvar, N , M , [name])

Parameters

• &binvar - A binary variable name which begins with the & symbol.
• N - The position within the binary variable where it starts searching.
• M - Value being searched for, either ASCII decimals 0-255 or text.
• name - an optional name to go with .regex, to be able to reference captured group later on.

Properties

• text - Treats a numeric N as text instead of ASCII value(s)
• textcs - When M is recognized as text, search is performed as case-sensitive
• .regex - performs a regex search, you can use the optional 4th name parameter to reference captured group later on

Note: Searches for text are case-insensitive by default.

Example

//bset -t &var 1 test wavmIRC32WAV test | echo -a space beginning pos1: $bfind(&var,1,32) / space beginning pos11: $bfind(&var,11,32) / finds string '32' instead of chr(32) $bfind(&var,1,32).text / case-sensitive: $bfind(&var, 1, $asc(W) $asc(A) $asc(V) ) / case-insensitive: $bfind(&var,1,WAV).text / case-sensitive: $bfind(&var,1,WAV).textcs / not found: $bfind(&var,1,abc).text
 
result: space beginning pos1: 5 / space beginning pos11: 18 / finds string '32' instead of chr(32) 13 / case-sensitive: 15 / case-insensitive: 6 / case-sensitive: 15 / not found: 0
 
Note that 32 searches for ASCII 32 (space) except when .text is used. Searching for "WAV" is case-insensitive and finds the lowercase letters, but the search for the 3 ASCII values finds the matching case. Using .textcs is available as of 7.58 to search for a case-sensitive text string without translating it to byte values.

Compatibility

Added: mIRC v5.7
Added on: 02 Feb 2000
Note: Unless otherwise stated, this was the date of original functionality.
Further enhancements may have been made in later versions.

See Also