AdiIRC

_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":http://www.asciitable.com/ values, they are copied to successive positions after byte position N.

*Switches*

table(ktable).

|*Switch*|*Description*|

| -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 | Creates new or truncates existing &binvar at zero length. |

*Parameters*

table(ktable).

|*Parameter*|*Description*|

| <&binvar> | The &binvar to modify. |

| <N> | The byte to modify. (one based) |

| <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>