Project

General

Profile

Actions

Bset » History » Revision 9

« Previous | Revision 9/11 (diff) | Next »
Per Amundsen, 07/27/2022 02:23 AM


Added in 1.9.0

/bset [-tacz] <&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 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 text contains no characters > 255.
-c - Chops the &binvar at the end of the copied bytes.
-z - TODO

Parameters

<&binvar> - The &binvar to modify.
<N> - The byte to modify. (one based)
<asciivalue> - The ASCII value to insert.

Example

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
}

Updated by Per Amundsen over 2 years ago · 9 revisions

Also available in: PDF HTML TXT