Core Function BinaryRemove - Revision history

UberFoX: 1 revision

2015-06-14T12:37:44Z

1 revision

← Older revision

Revision as of 12:37, 14 June 2015

UberFoX: 1 revision

2014-08-11T21:41:08Z

1 revision

← Older revision

Revision as of 21:41, 11 August 2014

UberFoX: /* Example */

2014-08-02T22:19:52Z

Example

← Older revision		Revision as of 22:19, 2 August 2014
Line 56:		Line 56:
	// Prints:		// Prints:
	// Before:		// Before:
−	// 00 \| 48 65 6C 6C 6F ~~-- -- -- -- -- -- --~~ -- -- -- -- Hello	+	// 00 \| 48 65 6C 6C 6F 20 57 6F 72 6C 64 21 -- -- -- -- Hello World!
	// After:		// After:
	// 00 \| 48 65 -- -- -- -- -- -- -- -- -- -- -- -- -- -- He		// 00 \| 48 65 -- -- -- -- -- -- -- -- -- -- -- -- -- -- He
Line 76:		Line 76:
	// Prints:		// Prints:
	// Before:		// Before:
−	// 00 \| 48 65 6C 6C 6F ~~-- -- -- -- -- -- --~~ -- -- -- -- Hello	+	// 00 \| 48 65 6C 6C 6F 20 57 6F 72 6C 64 21 -- -- -- -- Hello World!
	// After:		// After:
	// 00 \| 48 65 20 57 6F 72 6C 64 21 -- -- -- -- -- -- -- He World!		// 00 \| 48 65 20 57 6F 72 6C 64 21 -- -- -- -- -- -- -- He World!
Line 96:		Line 96:
	// Prints:		// Prints:
	// Before:		// Before:
−	// 00 \| 48 65 6C 6C 6F ~~-- -- -- -- -- -- --~~ -- -- -- -- Hello	+	// 00 \| 48 65 6C 6C 6F 20 57 6F 72 6C 64 21 -- -- -- -- Hello World!
	// After:		// After:
	// 00 \| 48 65 6C 6C 6F 20 57 6F 72 -- -- -- -- -- -- -- Hello Wor		// 00 \| 48 65 6C 6C 6F 20 57 6F 72 -- -- -- -- -- -- -- Hello Wor

UberFoX: Created page with "

 BinaryRemove( , ,  )

=== Description === Remove bytes from a binary variable. === Parameters === ==== binary-array ==== The binary ..."

2014-08-01T22:25:21Z

Created page with "<pre> BinaryRemove( <binary-array>, <start>, <length> ) </pre> === Description === Remove bytes from a binary variable. === Parameters === ==== binary-array ==== The binary ..."

New page

<pre>
BinaryRemove( <binary-array>, <start>, <length> )
</pre>

=== Description ===

Remove bytes from a binary variable.

=== Parameters ===

==== binary-array ====

The binary variable to use.

==== start ====

Position to start from.

If the start is a negative value the position will work backwards from the length of the binary.

==== length ====

Optional; How many bytes to delete.

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 ===

Success: Returns true.

Failure: Returns false (On error or if there was no bytes removed).

=== Remarks ===

None.

=== Example ===

Remove everything after position 2

<syntaxhighlight lang="sputnik">
// Create the binary
$a = Pack("A*", "Hello World!");
// Print it
say "Before:";
say BinaryExpand($a);
// Remove bytes
BinaryRemove($a, 2);
// Print result
say "After:";
say BinaryExpand($a);
// Prints:
// Before:
// 00 | 48 65 6C 6C 6F -- -- -- -- -- -- -- -- -- -- -- Hello
// After:
// 00 | 48 65 -- -- -- -- -- -- -- -- -- -- -- -- -- -- He
</syntaxhighlight>

Remove 3 bytes after position 2

<syntaxhighlight lang="sputnik">
// Create the binary
$a = Pack("A*", "Hello World!");
// Print it
say "Before:";
say BinaryExpand($a);
// Remove bytes
BinaryRemove($a, 2, 3);
// Print result
say "After:";
say BinaryExpand($a);
// Prints:
// Before:
// 00 | 48 65 6C 6C 6F -- -- -- -- -- -- -- -- -- -- -- Hello
// After:
// 00 | 48 65 20 57 6F 72 6C 64 21 -- -- -- -- -- -- -- He World!
</syntaxhighlight>

Remove the last 3 bytes

<syntaxhighlight lang="sputnik">
// Create the binary
$a = Pack("A*", "Hello World!");
// Print it
say "Before:";
say BinaryExpand($a);
// Remove bytes
BinaryRemove($a, -3);
// Print result
say "After:";
say BinaryExpand($a);
// Prints:
// Before:
// 00 | 48 65 6C 6C 6F -- -- -- -- -- -- -- -- -- -- -- Hello
// After:
// 00 | 48 65 6C 6C 6F 20 57 6F 72 -- -- -- -- -- -- -- Hello Wor
</syntaxhighlight>

[[Category:Core Function]]