Project

General

Profile

$bvar » History » Revision 8

Revision 7 (Per Amundsen, 01/02/2019 03:34 AM) → Revision 8/13 (Per Amundsen, 01/02/2019 03:34 AM)

_Added in 1.9.0_ 

 *$bvar(&binvar,N,M)* 

 Returns M "ASCII":http://www.asciitable.com/ values from a &binvar starting from the Nth byte. 

 _N-N2 can be used to get a range of ASCII values._ 
 _N- can be used to get all ASCII values from position N._ 

 *Parameters* 

 &binvar - The &binvar to use. 
 N - Position to start retrieving bytes. 
 M - Numbers of bytes to get. 

 *Properties* 

 .text - Returns plain text instead of "ASCII":http://www.asciitable.com/ values. 
 .word 
  word - Outputs decimal value of a 2-byte word, seeing bytes in little-endian byte order (low value first) 
 .nword - Outputs decimal value of a 2-byte word, seeing bytes in big-endian byte order (high value first) 
 .long - Outputs decimal value of a 4-byte dword (unsigned long), seeing bytes in little-endian byte order (low value first) 
 .nlong - Outputs decimal value of a 4-byte dword (unsigned long), seeing bytes in big-endian byte order (high value first) 

 *Example* 

 <pre> 
 ; Returns the length of the binary variable. 
 //echo -ag $bvar(&binvar,0)         

 ; Returns ASCII value at position N. 
 //echo -ag $bvar(&binvar,1) 

 ; Returns ASCII values from 5 to 8. 
 //echo -ag $bvar(&binvar,5,3) 

 ; Returns ASCII values from 5 to end. 
 //echo -ag $bvar(&binvar,5-) 

 ; Returns plain text from 5 to 8 up to the first zero character. 
 //echo -ag $bvar(&binvar,5,3).text 

 ; Returns &binvar if the binvar exists. 
 //echo -ag $bvar(&binvar) 
 </pre>