Core Function BinaryAppend

Revision as of 20:41, 4 December 2011

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("z0", "The quick brown FoX");
$binary2 = Pack("z0", " jumps over the lazy dog");
BinaryAppend($binary, $binary2);
println( Unpack("z0", $binary) ); // Prints: The quick brown FoX jumps over the lazy dog

Append data to beginning:

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