$bvar » History » Version 13
Per Amundsen, 02/16/2023 09:09 PM
| 1 | 1 | Per Amundsen | _Added in 1.9.0_ |
|---|---|---|---|
| 2 | |||
| 3 | *$bvar(&binvar,N,M)* |
||
| 4 | |||
| 5 | 2 | Per Amundsen | Returns M "ASCII":http://www.asciitable.com/ values from a &binvar starting from the Nth byte. |
| 6 | 1 | Per Amundsen | |
| 7 | 6 | Per Amundsen | _N-N2 can be used to get a range of ASCII values._ |
| 8 | _N- can be used to get all ASCII values from position N._ |
||
| 9 | |||
| 10 | 1 | Per Amundsen | *Parameters* |
| 11 | |||
| 12 | 13 | Per Amundsen | table(ktable). |
| 13 | |*Parameter*|*Description*| |
||
| 14 | | &binvar | The &binvar to use. | |
||
| 15 | | N | Position to start retrieving bytes. | |
||
| 16 | | M | Numbers of bytes to get. | |
||
| 17 | 1 | Per Amundsen | |
| 18 | *Properties* |
||
| 19 | |||
| 20 | 13 | Per Amundsen | table(ktable). |
| 21 | |*Property*|*Description*| |
||
| 22 | | .text | Returns plain text instead of "ASCII":http://www.asciitable.com/ values. | |
||
| 23 | | .word | Outputs decimal value of a 2-byte word, seeing bytes in little-endian byte order (low value first, (unsigned 16 bit) | |
||
| 24 | | .nword | Outputs decimal value of a 2-byte word, seeing bytes in big-endian byte order (high value first, unsigned 16 bit) | |
||
| 25 | | .sword | Outputs decimal value of a 2-byte word, seeing bytes in little-endian byte order (low value first, signed 16 bit, *AdiIRC only*) | |
||
| 26 | | .nsword | Outputs decimal value of a 2-byte word, seeing bytes in big-endian byte order (high value first, signed 16 bit, *AdiIRC only*) | |
||
| 27 | | .long | Outputs decimal value of a 4-byte dword (unsigned long), seeing bytes in little-endian byte order (low value first, unsigned 32 bit) | |
||
| 28 | | .nlong | Outputs decimal value of a 4-byte dword (unsigned long), seeing bytes in big-endian byte order (high value first. unsigned 32 bit) | |
||
| 29 | | .slong | Outputs decimal value of a 4-byte dword (unsigned long), seeing bytes in little-endian byte order (low value first, signed 32 bit, *AdiIRC only*) | |
||
| 30 | | .nslong | Outputs decimal value of a 4-byte dword (unsigned long), seeing bytes in big-endian byte order (high value first. signed 32 bit *AdiIRC only*) | |
||
| 31 | | .uint64 | Outputs decimal value of an 8-byte qword (unsigned long), seeing bytes in little-endian byte order (low value first, unsigned 64 bit *AdiIRC only*) | |
||
| 32 | | .nuint64 | Outputs decimal value of an 8-byte qword (unsigned long), seeing bytes in big-endian byte order (high value first. unsigned 64 bit *AdiIRC only*) | |
||
| 33 | | .sint64 | Outputs decimal value of an 8-byte qword (unsigned long), seeing bytes in little-endian byte order (low value first, signed 64 bit, *AdiIRC only*) | |
||
| 34 | | .nsint64 | Outputs decimal value of an 8-byte qword (unsigned long), seeing bytes in big-endian byte order (high value first. signed 64 bit *AdiIRC only*) | |
||
| 35 | 1 | Per Amundsen | |
| 36 | *Example* |
||
| 37 | |||
| 38 | <pre> |
||
| 39 | 3 | Per Amundsen | ; Returns the length of the binary variable. |
| 40 | 1 | Per Amundsen | //echo -ag $bvar(&binvar,0) |
| 41 | |||
| 42 | 4 | Per Amundsen | ; Returns ASCII value at position N. |
| 43 | 1 | Per Amundsen | //echo -ag $bvar(&binvar,1) |
| 44 | 4 | Per Amundsen | |
| 45 | 1 | Per Amundsen | ; Returns ASCII values from 5 to 8. |
| 46 | 6 | Per Amundsen | //echo -ag $bvar(&binvar,5,3) |
| 47 | |||
| 48 | ; Returns ASCII values from 5 to end. |
||
| 49 | //echo -ag $bvar(&binvar,5-) |
||
| 50 | 1 | Per Amundsen | |
| 51 | 3 | Per Amundsen | ; Returns plain text from 5 to 8 up to the first zero character. |
| 52 | 1 | Per Amundsen | //echo -ag $bvar(&binvar,5,3).text |
| 53 | 5 | Per Amundsen | |
| 54 | ; Returns &binvar if the binvar exists. |
||
| 55 | //echo -ag $bvar(&binvar) |
||
| 56 | 1 | Per Amundsen | </pre> |