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>