BinaryEncode

Encodes a set of values into a single binaryvalue.Syntax:

```
binaryEncode(<formatsList>, <dataStringList>)

```

Examples:

```
binaryEncode("a","Q") -- returns "Q"

```

```
binaryEncode("A5","QED") -- returns "QED  "

```

```
binaryEncode("N2a12x",firstNum,secondNum,labelString,"nothing")

```

```
charToNum(binaryEncode("B*","01111111")) -- returns 127

```

Use the **binaryEncode** function to encode one or more values
as binary data.

The binary data format produced by **binaryEncode** is similar to the
format produced by the "pack()" function of the Perl programming
language.

If you don't specify a number with the a, A, b, B, h, or H dataTypes,
one character is encoded. If the dataType normally takes more
than one character, trailing zeroes are added to make up the required
number of characters. For example, H requires two characters, so
binaryEncode("H","3") Encodes the hexadecimal number 30,
adding a zero to the end to make the dataString two characters long.

Parameters:

* formatsList: The formatsList consists of one or more dataTypes, each followedoptionally by an amount. A dataType is one of the following singleletters: x: output amount null characters
* dataStringList (string): A comma-separated list of dataStrings. Each dataString is a string, oran expression that evaluates to a string.
* amount (enum):
* - If the dataType is a, A, b, B, h, or H, the amount specifies the number of characters or groups of the dataString to use; extra characters are ignored. The \* character Encodes the rest of the data in the current dataString. If no amount is specified, the dataType is used for one character.- If the dataType is c, C, s, S, i, I, n, N, m, M, f, or d, the amount specifies the number of dataStrings to encode. The \* character Encodes the rest of the dataStrings. If no amount is specified, the dataType is used for one dataString.- If the dataType is x, the amount specifies how many nulls to place in the returned value.
* - byte integersC: encode amount numbers as unsigned 1-byte integerss: encode amount numbers as signed 2-byte integers in host byte orderS: encode amount numbers as unsigned 2-byte integers in host byte orderi: encode amount numbers as signed 4-byte integers in host byte orderI: encode amount numbers as unsigned 4-byte integers in host byte ordern: encode amount numbers as signed 2-byte integers in network byte orderN: encode amount numbers as signed 4-byte integers in network byte orderm: encode amount numbers as unsigned 2-byte integers in network byte orderM: encode amount numbers as unsigned 4-byte integers in network byte orderf: encode amount numbers as single-precision floating-point numbersd: encode amount numbers as double-precision floating-point numbersThe amount corresponding to each dataType is an integer or the \* character:
* Returns:The **binaryEncode** function returns the binary stringrepresentation of the dataStrings.
* The result: Although the x dataType places nulls in the resulting stringregardless of the contents of its corresponding dataString, you stillmust provide a dataString for instances of x that appear in theformatsList. The **binaryEncode** function disregards the contents ofthe dataString used for the dataType x, so you can use any value.

See also: format (function),