Buffer
Operators and functions for working with an array of bytes (buf type) are described here.
Operator | Result | Description |
* buf | int | Returns the number of bytes in the array. |
buf ? | bool | Calls bool(buf). |
buf + buf | buf | Merges two buffers. |
buf = buf | buf | Assignment operator. |
buf &= buf | buf | Create a clone of the buffer. The new variable will work with the same data set. |
buf += buf | buf | Appends a buffer to a buffer variable. |
buf += int | buf | Appends one byte to the buffer. The number must be less than 256. |
buf += str | buf | Appends a string to the buffer. |
buf += char | buf | Appends a character to the buffer. |
buf [ int ] | int | Sets/gets a byte by index. |
The bool function returns false if the buffer is empty, otherwise, it returns true.
The buf function converts a string to a buf value and returns it.
The str function converts a buf value to a string and returns it.
The Base64 function converts a value of the buf type into a string in base64 encoding and returns it.
The DecodeInt function gets an integer from a parameter of buf type. offset is the offset in the buffer at which to read the number. The function reads 8 bytes and returns them as an integer.
The Del function removes part of the data from the byte array. off is the offset of the data to be deleted, length is the number of bytes to be deleted. If length is less than zero, then the data will be deleted to the left of the specified offset. The function returns the b variable in which the deletion occurred.
The EncodeInt function appends an integer number to a specified variable of buf type. Since the int value occupies 8 bytes, 8 bytes are appended to the buffer regardless of the i parameter value. The function returns the b parameter.
The Hex function encodes a buf value to a hexadecimal string and returns it.
The Insert function inserts an array of bytes src into the array b. off is the offset where the specified byte array will be inserted. The function returns the variable b.
The SetLen function sets the size of the buffer. If size is less than the size of the buffer, then it will be truncated. Otherwise, the buffer will be padded with zeros to the specified size.
The Subbuf function returns a new buffer that contains the chunk of the b buffer with the specified offset and length.
The UnBase64 function converts a string in base64 encoding into a value of the buf type and returns it.
The UnHex function returns the buf value represented by the hexadecimal string s. The input string must contain only hexadecimal characters.
The Write function writes the byte array of the src variable into the b variable starting from the specified offset. The data is written over existing values. The function returns variable b.