Core Function BinaryExpand - Revision history

UberFoX: 1 revision

2015-06-14T12:37:42Z

1 revision

← Older revision

Revision as of 12:37, 14 June 2015

UberFoX: 1 revision

2014-08-11T21:41:07Z

1 revision

← Older revision

Revision as of 21:41, 11 August 2014

UberFoX at 01:04, 28 July 2014

2014-07-28T01:04:59Z

← Older revision		Revision as of 01:04, 28 July 2014
Line 16:		Line 16:

	Optional; Position to start printing the bytes at		Optional; Position to start printing the bytes at
		+
		+	If the start is a negative value the position will work backwards from the length of the binary.

	==== length ====		==== length ====
Line 21:		Line 23:
	Optional; How many bytes to print		Optional; How many bytes to print

−	Default~~: @INT32_MAX~~	+	Default is all remaining bytes;
		+
		+	If length is given and is negative, then that many bytes will be omitted from the end of binary (after the start position has been calculated when a start is negative).
		+
		+	If start denotes the position of this truncation or beyond, empty binary variable will be returned.

	=== Return Value ===		=== Return Value ===

UberFoX at 00:29, 27 July 2014

2014-07-27T00:29:11Z

← Older revision		Revision as of 00:29, 27 July 2014
Line 1:		Line 1:
	<pre>		<pre>
−	BinaryExpand( <binary-array> )	+	BinaryExpand( <binary-array>, <start>, <length> )
	</pre>		</pre>

Line 12:		Line 12:

	The binary variable to use.		The binary variable to use.
		+
		+	==== start ====
		+
		+	Optional; Position to start printing the bytes at
		+
		+	==== length ====
		+
		+	Optional; How many bytes to print
		+
		+	Default: @INT32_MAX

	=== Return Value ===		=== Return Value ===
Line 38:		Line 48:
	//		//
	// See how it makes it easier to see whats inside the binary?		// See how it makes it easier to see whats inside the binary?
		+	</syntaxhighlight>
		+
		+	Example of printing everything after the 4th byte
		+	<syntaxhighlight lang="sputnik">
		+	$bin = Pack("iz0iNnz0Nz0", 777, "Hello World!", 100, 200, 700, "Cat", 1337, "Hello world!!!");
		+	say BinaryExpand($bin, 4);
		+	// Prints
		+	// 48 65 6C 6C 6F 20 57 6F 72 6C 64 21 64 00 00 00 Hello World!d...
		+	// 00 00 00 C8 02 BC 43 61 74 00 00 05 39 48 65 6C ...È..Cat...9Hel
		+	// 6C 6F 20 77 6F 72 6C -- -- -- -- -- -- -- -- -- lo worl
		+	</syntaxhighlight>
		+
		+	Example of printing 12 bytes after the 4th byte
		+	<syntaxhighlight lang="sputnik">
		+	$bin = Pack("iz0iNnz0Nz0", 777, "Hello World!", 100, 200, 700, "Cat", 1337, "Hello world!!!");
		+	say BinaryExpand($bin, 4, 12);
		+	// Prints
		+	// 48 65 6C 6C 6F 20 57 6F 72 6C 64 21 -- -- -- -- Hello World!
	</syntaxhighlight>		</syntaxhighlight>

	[[Category:Core Function]]		[[Category:Core Function]]

UberFoX: Created page with "

 BinaryExpand(  )

=== Description === Reverse the order bytes a binary variable. === Parameters === ==== binary-array ==== The binary variable to u..."

2014-07-27T00:01:02Z

Created page with "<pre> BinaryExpand( <binary-array> ) </pre> === Description === Reverse the order bytes a binary variable. === Parameters === ==== binary-array ==== The binary variable to u..."

New page

<pre>
BinaryExpand( <binary-array> )
</pre>

=== Description ===

Reverse the order bytes a binary variable.

=== Parameters ===

==== binary-array ====

The binary variable to use.

=== Return Value ===

Success: Returns string of the expanded binary.

Failure: Returns empty string.

=== Remarks ===

This converts a binary variable into a string of numbers followed by text so it is easy to read and understand.

This is especially good when making a Client/Server program and you wish to see what information you are getting or sending.

=== Example ===

<syntaxhighlight lang="sputnik">
// Create a large binary that contains some text
$bin = Pack("z0iNnz0Nz0", "Hello World!", 100, 200, 700, "Cat", 1337, "Hello world!!!");
// Print it out
say BinaryExpand($bin);
// Prints
// 48 65 6C 6C 6F 20 57 6F 72 6C 64 21 64 00 00 00 Hello World!d...
// 00 00 00 C8 02 BC 43 61 74 00 00 05 39 48 65 6C ...È..Cat...9Hel
// 6C 6F 20 77 6F 72 6C 64 21 21 21 -- -- -- -- -- lo world!!!
//
// See how it makes it easier to see whats inside the binary?
</syntaxhighlight>

[[Category:Core Function]]