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: /* Return Value */

2014-08-01T23:21:41Z

Return Value

← Older revision		Revision as of 23:21, 1 August 2014
Line 39:		Line 39:
	Success: Returns true.		Success: Returns true.

−	Failure: Returns false (On error or if there was no bytes ~~removed~~).	+	Failure: Returns false (On error or if there was no bytes were added).

	=== Remarks ===		=== Remarks ===

UberFoX: Created page with "

 BinaryMidReplace( , , ,  )

=== Description === Replace a section (from start to length) of the binary with the replacemen..."

2014-08-01T23:21:14Z

Created page with "<pre> BinaryMidReplace( <binary-array>, <replacement>, <start>, <length> ) </pre> === Description === Replace a section (from start to length) of the binary with the replacemen..."

New page

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

=== Description ===

Replace a section (from start to length) of the binary with the replacement binary.

=== Parameters ===

==== binary-array ====

The binary variable to use.

==== replacement ====

A variable to replace the section with

(If it is not binary it will cast as binary for the replacement)

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

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 then insert the replacement

<syntaxhighlight lang="sputnik">
// Create the binary
$a = Pack("A*", "Hello World!");
// Create the replacement binary
$b = Pack("A*", "CatDog");
// Print it
say "Before:";
say BinaryExpand($a);
// Remove bytes and insert in its place
BinaryMidReplace($a, $b, 2);
// Print result
say "After:";
say BinaryExpand($a);
// Prints:
// Before:
// 00 | 48 65 6C 6C 6F 20 57 6F 72 6C 64 21 -- -- -- -- Hello World!
// After:
// 00 | 48 65 43 61 74 44 6F 67 -- -- -- -- -- -- -- -- HeCatDog
</syntaxhighlight>

Remove 3 bytes after position 2 then insert the replacement

<syntaxhighlight lang="sputnik">
// Create the binary
$a = Pack("A*", "Hello World!");
// Create the replacement binary
$b = Pack("A*", "CatDog");
// Print it
say "Before:";
say BinaryExpand($a);
// Remove bytes and insert in its place
BinaryMidReplace($a, $b, 2, 3);
// Print result
say "After:";
say BinaryExpand($a);
// Prints:
// Before:
// 00 | 48 65 6C 6C 6F 20 57 6F 72 6C 64 21 -- -- -- -- Hello World!
// After:
// 00 | 48 65 43 61 74 44 6F 67 20 57 6F 72 6C 64 21 -- HeCatDog World!
</syntaxhighlight>

Remove the last 3 bytes then insert the replacement

<syntaxhighlight lang="sputnik">
// Create the binary
$a = Pack("A*", "Hello World!");
// Create the replacement binary
$b = Pack("A*", "CatDog");
// Print it
say "Before:";
say BinaryExpand($a);
// Remove bytes and insert in its place
BinaryMidReplace($a, $b, -3);
// Print result
say "After:";
say BinaryExpand($a);
// Prints:
// Before:
// 00 | 48 65 6C 6C 6F 20 57 6F 72 6C 64 21 -- -- -- -- Hello World!
// After:
// 00 | 48 65 6C 6C 6F 20 57 6F 72 43 61 74 44 6F 67 -- Hello WorCatDog
</syntaxhighlight>

At the end

<syntaxhighlight lang="sputnik">
// Create the binary
$a = Pack("A*", "Test");
// Create the replacement binary
$b = Pack("A*", "CatDog");
// Print it
say "Before:";
say BinaryExpand($a);
// Remove bytes and insert in its place
BinaryMidReplace($a, $b, 4);
// Print result
say "After:";
say BinaryExpand($a);
// Prints:
// Before:
// 00 | 48 65 6C 6C 6F 20 57 6F 72 6C 64 21 -- -- -- -- Hello World!
// After:
// 00 | 54 65 73 74 43 61 74 44 6F 67 -- -- -- -- -- -- TestCatDog
</syntaxhighlight>

At the beginning

<syntaxhighlight lang="sputnik">
// Create the binary
$a = Pack("A*", "Test");
// Create the replacement binary
$b = Pack("A*", "CatDog");
// Print it
say "Before:";
say BinaryExpand($a);
// Remove bytes and insert in its place
BinaryMidReplace($a, $b, 0);
// Print result
say "After:";
say BinaryExpand($a);
// Prints:
// Before:
// 00 | 48 65 6C 6C 6F 20 57 6F 72 6C 64 21 -- -- -- -- Hello World!
// After:
// 00 | 3 61 74 44 6F 67 -- -- -- -- -- -- -- -- -- -- CatDog
</syntaxhighlight>

[[Category:Core Function]]

Core Function BinaryMidReplace - Revision history

UberFoX: 1 revision

UberFoX: 1 revision

UberFoX: /* Return Value */

UberFoX: Created page with "
BinaryMidReplace( , , , )
=== Description === Replace a section (from start to length) of the binary with the replacemen..."