Core Function BinaryHex

Latest revision as of 12:38, 14 June 2015

BinaryHex( <expression>, <flag> )

Description

Create a binary array from a hex string.

Parameters

expression

A string of hex to convert into a binary variable.

flag

Optional; There are a few flags that can be turned on or off using the | operator

1 = The string actually is hex using \x escape and is to be treated as such

2 = Add a zero to the end of the binary data (null termination)

(To make that flag has null termination and uses a \x string you would do 1 | 2)

Return Value

Success: Returns the binary variable.

Failure: Returns null.

Remarks

The string must contain only the hex chars nothing else not even 0x or spaces.

Example

$binary = BinaryHex("48656c6c6f20576f726c6421");
println( "Binary HEX: '" . BinaryStr($binary, ",") . "'" );
println("The binary size is: " . BinaryLen($binary) );
Foreach ($binary as $i)
{
	println( "Byte: " . $i . " | Hex: " . Hex($i) . " | Char: " . Chr($i) );
}
$String = Unpack("A*", $binary, 3);
println("Full string: " . $String);

Example of using the flag

$binary = BinaryHex("\x48\x65\x6c\x6c\x6f\x20\x57\x6f\x72\x6c\x64\x21", true);
println( "Binary HEX: '" . BinaryStr($binary, ",") . "'" );
println("The binary size is: " . BinaryLen($binary) );
Foreach ($binary as $i)
{
	println( "Byte: " . $i . " | Hex: " . Hex($i) . " | Char: " . Chr($i) );
}
$String = Unpack("A*", $binary, 3);
println("Full string: " . $String);