Project

General

Profile

Bset » History » Revision 5

Revision 4 (Per Amundsen, 09/29/2017 09:36 PM) → Revision 5/11 (Per Amundsen, 10/16/2018 03:35 AM)

_Added in 1.9.0_ 

 */bset [-ta] <&binvar> <N> <asciivalue> [asciivalue ... asciivalue]* 

 Sets the <N>th byte in binary variable &binvar to the specified ascii value. 

 _If N = -1, the data is added to the end of the variable._ 

 If the &binvar docent exists it is created. 
 If <N> is larger than the size of &binvar it will be zero filled up to <N> bytes. 
 If you specify multiple "ASCII":http://www.asciitable.com/ values, they are copied to successive positions after byte position N. 

 *Switches* 

 -t - Treat values a plain text. 
 -a - Disables UTF-8 encoding of characters in the range 0-255, as long as the line contains no characters > 255. 
 -1 - TODO 

 *Parameters* 

 <&binvar> - The &binvar to modify. 
 <N> - The byte to modify. 
 <asciivalue> - The "ASCII":http://www.asciitable.com/ value to insert. 

 *Example* 

 <pre> 
 alias example { 
   ; Create a binary variable set it to "This is fun!" 
   bset -t &Example 1 This is fun! 
 
   ; Print out the content of the variable 
   echo -a $bvar(&Example, 1-).text 
 } 
 </pre>