Core Function BinaryAppend

BinaryAppend( <binary-array>, <binary-array2>, <flag> )

Description

Append a binary variables data onto the end or beginning of another binary variables data.

Parameters

binary-array

The binary variable to append to.

binary-array2

The binary variable to be appended.

flag

Optional; Flag to choose where to append to:

0 = Append to end

1 = Append to beginning

Return Value

Success: Returns 1.

Failure: Returns 0.

Remarks

This modifies the original variable and does not return a copy of it.

Example

Append data to end:

$binary = Pack("A*", "The quick brown FoX");
$binary2 = Pack("A*", " jumps over the lazy dog");
BinaryAppend($binary, $binary2);
println( Unpack("A*", $binary, 3) ); // Prints: The quick brown FoX jumps over the lazy dog

Append data to beginning:

$binary = Pack("A*", "The quick brown FoX");
$binary2 = Pack("A*", " jumps over the lazy dog");
BinaryAppend($binary, $binary2, 0);
println( Unpack("A*", $binary, 3) ); //  jumps over the lazy dogThe quick brown FoX