Core Function BinaryReplace - Revision history

UberFoX: 1 revision

2015-06-14T12:37:51Z

1 revision

← Older revision

Revision as of 12:37, 14 June 2015

UberFoX: 1 revision

2014-08-11T21:41:10Z

1 revision

← Older revision

Revision as of 21:41, 11 August 2014

UberFoX: /* Remarks */

2014-08-11T07:17:11Z

Remarks

← Older revision		Revision as of 07:17, 11 August 2014
Line 45:		Line 45:
	=== Remarks ===		=== Remarks ===

−	~~None~~.	+	If you want to replace single bytes you SHOULD cast the find and replace as byte (see example) this is because if you don't do that then it will use a normal search and replace which involves splitting and remaking the binary.
		+
		+	Doing that on a single byte? Could potentially take a long time and would be rather silly when you can just simply cast to byte and replace on the spot with no need to break up and remake the binary.

	=== Example ===		=== Example ===

UberFoX: /* Example */

2014-08-11T07:15:32Z

Example

← Older revision		Revision as of 07:15, 11 August 2014
Line 48:		Line 48:

	=== Example ===		=== Example ===
		+
		+	How to do a single byte replace for another byte
		+
		+	<syntaxhighlight lang="sputnik">
		+	// To replace single bytes you must cast
		+	// your find AND replace as a byte
		+
		+	// Assign a value to do the replace on
		+	$subject = Pack("A*", "Hello world!!!");
		+	// Print unchanged
		+	say $subject; // "Hello world!!!"
		+	// Do the replacement
		+	BinaryReplace($subject, (byte)108, (byte)74);
		+	// Print changed
		+	say $subject; // HeJJo worJd!!!
		+	</syntaxhighlight>
		+
		+	Single byte replace using chars
		+
		+	<syntaxhighlight lang="sputnik">
		+	// To replace single bytes you must cast
		+	// your find AND replace as a byte
		+	// to do this with chars is easy example
		+
		+	// Assign a value to do the replace on
		+	$subject = Pack("A*", "Hello world!!!");
		+	// Print unchanged
		+	say $subject; // "Hello world!!!"
		+	// Do the replacement
		+	BinaryReplace($subject, (byte)@'!', (byte)@'?');
		+	// Print changed
		+	say $subject; // Hello world???
		+	</syntaxhighlight>

	Simple replacement		Simple replacement

UberFoX: /* Example */

2014-08-11T07:05:26Z

Example

← Older revision		Revision as of 07:05, 11 August 2014
Line 147:		Line 147:
	// Print changed		// Print changed
	say $subject; // Hello Spuntik ok Spuntik hehe world!!!		say $subject; // Hello Spuntik ok Spuntik hehe world!!!
		+	</syntaxhighlight>
		+
		+	Using the offset to not replace the first match
		+
		+	<syntaxhighlight lang="sputnik">
		+	// Assign a value to do the replace on
		+	$subject = Pack("A*", "Hello world ok world hehe world!!!");
		+	// Assign a value to find
		+	$find = Pack("A*", "world");
		+	// Assign a value to replace the found with
		+	$replace = Pack("A*", "Spuntik");
		+
		+	// Print unchanged
		+	say $subject; // Hello world ok world hehe world!!!
		+
		+	// Do the replacement
		+	BinaryReplace($subject, $find, $replace, 10, 1);
		+
		+	// Print changed
		+	say $subject; // Hello world ok Spuntik hehe world!!!
	</syntaxhighlight>		</syntaxhighlight>

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

UberFoX at 07:01, 11 August 2014

2014-08-11T07:01:59Z

← Older revision		Revision as of 07:01, 11 August 2014
Line 1:		Line 1:
	<pre>		<pre>
−	BinaryReplace( <binary-array>, <needle>, <replacement>, <maxReplacements> )	+	BinaryReplace( <binary-array>, <needle>, <replacement>, <offset>, <maxReplacements> )
	</pre>		</pre>

Line 24:		Line 24:

	(It will be cast as binary if it isn't already)		(It will be cast as binary if it isn't already)
		+
		+	==== offset ====
		+
		+	Optional; Position to begin the search
		+
		+	Default: 0 (beginning)

	==== maxReplacements ====		==== maxReplacements ====

	Optional; The max allowed replacements to do		Optional; The max allowed replacements to do
		+
		+	Default: -1 (replace all)

	=== Return Value ===		=== Return Value ===
Line 115:		Line 123:

	// Do the replacement		// Do the replacement
−	BinaryReplace($subject, $find, $replace, 1);	+	BinaryReplace($subject, $find, $replace, 0, 1);

	// Print changed		// Print changed
Line 135:		Line 143:

	// Do the replacement		// Do the replacement
−	BinaryReplace($subject, $find, $replace, 1);	+	BinaryReplace($subject, $find, $replace, 0, 1);

	// Print changed		// Print changed

UberFoX at 06:57, 11 August 2014

2014-08-11T06:57:36Z

← Older revision		Revision as of 06:57, 11 August 2014
Line 1:		Line 1:
	<pre>		<pre>
−	BinaryReplace( <binary-array>, <needle>, <replacement> )	+	BinaryReplace( <binary-array>, <needle>, <replacement>, <maxReplacements> )
	</pre>		</pre>

Line 24:		Line 24:

	(It will be cast as binary if it isn't already)		(It will be cast as binary if it isn't already)
		+
		+	==== maxReplacements ====
		+
		+	Optional; The max allowed replacements to do

	=== Return Value ===		=== Return Value ===
Line 95:		Line 99:
	// Print changed		// Print changed
	say $subject; // Hello Spuntik ok Spuntik hehe Spuntik!!!		say $subject; // Hello Spuntik ok Spuntik hehe Spuntik!!!
		+	</syntaxhighlight>
		+
		+	Only allow one replacement
		+
		+	<syntaxhighlight lang="sputnik">
		+	// Assign a value to do the replace on
		+	$subject = Pack("A*", "Hello world ok world hehe world!!!");
		+	// Assign a value to find
		+	$find = Pack("A*", "world");
		+	// Assign a value to replace the found with
		+	$replace = Pack("A*", "Spuntik");
		+
		+	// Print unchanged
		+	say $subject; // Hello world ok world hehe world!!!
		+
		+	// Do the replacement
		+	BinaryReplace($subject, $find, $replace, 1);
		+
		+	// Print changed
		+	say $subject; // Hello Spuntik ok world hehe world!!!
		+	</syntaxhighlight>
		+
		+	Only allow two replacements
		+
		+	<syntaxhighlight lang="sputnik">
		+	// Assign a value to do the replace on
		+	$subject = Pack("A*", "Hello world ok world hehe world!!!");
		+	// Assign a value to find
		+	$find = Pack("A*", "world");
		+	// Assign a value to replace the found with
		+	$replace = Pack("A*", "Spuntik");
		+
		+	// Print unchanged
		+	say $subject; // Hello world ok world hehe world!!!
		+
		+	// Do the replacement
		+	BinaryReplace($subject, $find, $replace, 1);
		+
		+	// Print changed
		+	say $subject; // Hello Spuntik ok Spuntik hehe world!!!
	</syntaxhighlight>		</syntaxhighlight>

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

UberFoX: /* Example */

2014-08-11T06:51:29Z

Example

← Older revision		Revision as of 06:51, 11 August 2014
Line 75:		Line 75:
	// Print changed		// Print changed
	say $subject; // Hello Spuntik!!!		say $subject; // Hello Spuntik!!!
		+	</syntaxhighlight>
		+
		+	Of course it will replace all it finds
		+
		+	<syntaxhighlight lang="sputnik">
		+	// Assign a value to do the replace on
		+	$subject = Pack("A*", "Hello world ok world hehe world!!!");
		+	// Assign a value to find
		+	$find = Pack("A*", "world");
		+	// Assign a value to replace the found with
		+	$replace = Pack("A*", "Spuntik");
		+
		+	// Print unchanged
		+	say $subject; // Hello world ok world hehe world!!!
		+
		+	// Do the replacement
		+	BinaryReplace($subject, $find, $replace);
		+
		+	// Print changed
		+	say $subject; // Hello Spuntik ok Spuntik hehe Spuntik!!!
	</syntaxhighlight>		</syntaxhighlight>

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

UberFoX: Created page with "

 BinaryReplace( , ,  )

=== Description === Search for a byte or string of bytes in a binary variable and replace it. === Paramet..."

2014-08-11T06:48:55Z

Created page with "<pre> BinaryReplace( <binary-array>, <needle>, <replacement> ) </pre> === Description === Search for a byte or string of bytes in a binary variable and replace it. === Paramet..."

New page

<pre>
BinaryReplace( <binary-array>, <needle>, <replacement> )
</pre>

=== Description ===

Search for a byte or string of bytes in a binary variable and replace it.

=== Parameters ===

==== binary-array ====

The binary variable to do the replacement on.

==== needle ====

The needle to find.

(It will be cast as binary if it isn't already)

==== replacement ====

The replacement to use.

(It will be cast as binary if it isn't already)

=== Return Value ===

Success: Returns true.

Failure: Returns false.

=== Remarks ===

None.

=== Example ===

Simple replacement

<syntaxhighlight lang="sputnik">
// Assign a value to do the replace on
$subject = Pack("A*", "Hello world!!!");
// Assign a value to find
$find = Pack("A*", "world");
// Assign a value to replace the found with
$replace = Pack("A*", "cat");

// Print unchanged
say $subject; // Hello world!!!

// Do the replacement
BinaryReplace($subject, $find, $replace);

// Print changed
say $subject; // Hello cat!!!
</syntaxhighlight>

This time the replacement is bigger than what is being replaced

<syntaxhighlight lang="sputnik">
// Assign a value to do the replace on
$subject = Pack("A*", "Hello world!!!");
// Assign a value to find
$find = Pack("A*", "world");
// Assign a value to replace the found with
$replace = Pack("A*", "Spuntik");

// Print unchanged
say $subject; // Hello world!!!

// Do the replacement
BinaryReplace($subject, $find, $replace);

// Print changed
say $subject; // Hello Spuntik!!!
</syntaxhighlight>

[[Category:Core Function]]