Core Function BinaryCompare - Revision history

UberFoX: 1 revision

2015-06-14T12:37:14Z

1 revision

← Older revision

Revision as of 12:37, 14 June 2015

UberFoX: 1 revision

2014-08-11T21:40:54Z

1 revision

← Older revision

Revision as of 21:40, 11 August 2014

UberFoX: /* Remarks */

2014-08-04T08:56:27Z

Remarks

← Older revision		Revision as of 08:56, 4 August 2014
Line 77:		Line 77:
	If( $Binary1 === $Binary2 )		If( $Binary1 === $Binary2 )
	{		{
−	println("Both binary variables ~~contain~~ the same ~~data~~");	+	println("Both binary variables are exactly the same");
	}		}
	Else		Else

UberFoX: /* Remarks */

2014-08-04T08:56:08Z

Remarks

← Older revision		Revision as of 08:56, 4 August 2014
Line 68:		Line 68:

	If you wish to make sure both variables are the same size before doing the compare check their size.		If you wish to make sure both variables are the same size before doing the compare check their size.
		+
		+	Or use the direct === to check if both binary variables are 100% the same
		+
		+	<syntaxhighlight lang="sputnik">
		+	my $Binary1 = Pack("A*", "Hello world!!!");
		+	my $Binary2 = Pack("A*", "Hello world!!!");
		+
		+	If( $Binary1 === $Binary2 )
		+	{
		+	println("Both binary variables contain the same data");
		+	}
		+	Else
		+	{
		+	println("No match");
		+	}
		+	</syntaxhighlight>

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

UberFoX: /* Remarks */

2014-08-04T06:28:57Z

Remarks

← Older revision		Revision as of 06:28, 4 August 2014
Line 62:		Line 62:

	If ignoreCase is true, the result is equivalent to performing a case-sensitive comparison after converting the uppercase ASCII letters A-Z in both binary variables to lowercase.		If ignoreCase is true, the result is equivalent to performing a case-sensitive comparison after converting the uppercase ASCII letters A-Z in both binary variables to lowercase.
		+
		+	Warning this function will compare the source to the needle to the LENGTH of the source... This means if the needle is the same as the source to the full length of the compare then you will receive a true even if immediately after that position the needle changes drastically.
		+
		+	The reason for that is because its checked the full size of the source against everything it can in the needle and it was all a match so naturally the compare should be true.
		+
		+	If you wish to make sure both variables are the same size before doing the compare check their size.

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

UberFoX at 00:48, 4 August 2014

2014-08-04T00:48:34Z

← Older revision		Revision as of 00:48, 4 August 2014
Line 12:		Line 12:

	The a binary variable to use.		The a binary variable to use.
		+
		+	(Or any value that will be cast as binary)

	==== offset ====		==== offset ====
Line 22:		Line 24:

	The a binary variable to be comparing to.		The a binary variable to be comparing to.
		+
		+	(Or any value that will be cast as binary)

	==== needleOffset ====		==== needleOffset ====
Line 94:		Line 98:

	If( BinaryCompare($Binary1, 0, $Binary2, 3, 3) == 0 )		If( BinaryCompare($Binary1, 0, $Binary2, 3, 3) == 0 )
		+	{
		+	println("Both binary variables contain the same data");
		+	}
		+	Else
		+	{
		+	println("No match");
		+	}
		+	</syntaxhighlight>
		+
		+	Example of the casting
		+	<syntaxhighlight lang="sputnik">
		+	my $Binary1 = Pack("A*", "Hello world!!!");
		+
		+	If( BinaryCompare($Binary1, 0, "Hello world!!!") == 0 )
	{		{
	println("Both binary variables contain the same data");		println("Both binary variables contain the same data");

UberFoX at 00:44, 4 August 2014

2014-08-04T00:44:07Z

← Older revision		Revision as of 00:44, 4 August 2014
Line 17:		Line 17:
	Optional; Start position to begin comparing. (0 = first byte)		Optional; Start position to begin comparing. (0 = first byte)

−	If the ~~start~~ is a negative value the ~~byte~~ position will work backwards from the length of the ~~shortest~~ binary ~~variable~~.	+	If the offset is a negative value the position will work backwards from the length of the binary.

	==== needle ====		==== needle ====
Line 26:		Line 26:

	Optional; Start position to begin comparing in the needle. (0 = first byte)		Optional; Start position to begin comparing in the needle. (0 = first byte)
		+
		+	If the needleOffset is a negative value the position will work backwards from the length of the needle binary.

	==== length ====		==== length ====

−	Optional; Maximal number of bytes to compare. ~~By default~~ the entire remainder of the shortest binary variable.	+	Optional; Maximal number of bytes to compare.
		+
		+	Default is the entire remainder of the shortest binary variable.
		+
		+	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 ~~length is given and is negative~~, ~~then the compare will begin with many bytes~~ will be ~~omitted from the end of shortest binary variable~~ (~~after the offset position has been calculated when a offset is negative~~).	+	If start denotes the position of this truncation or beyond, failure will be returned ( -2 ).

−	~~If offset denotes~~ the ~~position~~ of ~~this truncation or beyond, failure~~ will be ~~returned ( -2 )~~.	+	The length will be calculated separately for the binary and the needle then the shortest of the two will be used.

	==== ignoreCase ====		==== ignoreCase ====

UberFoX: /* Example */

2014-08-02T09:41:27Z

Example

← Older revision		Revision as of 09:41, 2 August 2014
Line 59:		Line 59:
	my $Binary2 = Pack("A*", "Hello world!!!");		my $Binary2 = Pack("A*", "Hello world!!!");

−	If( BinaryCompare($Binary1, $Binary2) == 0 )	+	If( BinaryCompare($Binary1, 0, $Binary2) == 0 )
	{		{
	println("Both binary variables contain the same data");		println("Both binary variables contain the same data");
Line 71:		Line 71:
	println("Lets try again now now that one was changed");		println("Lets try again now now that one was changed");
	my $Binary1 = Pack("A*", "Test");		my $Binary1 = Pack("A*", "Test");
−	If( BinaryCompare($Binary1, $Binary2) == 0 )	+	If( BinaryCompare($Binary1, 0, $Binary2) == 0 )
	{		{
	println("Both binary variables contain the same data");		println("Both binary variables contain the same data");
Line 87:		Line 87:
	my $Binary2 = Pack("A*", "DatFoXNP");		my $Binary2 = Pack("A*", "DatFoXNP");

−	If( BinaryCompare($Binary1, $Binary2, 3, 3) == 0 )	+	If( BinaryCompare($Binary1, 0, $Binary2, 3, 3) == 0 )
	{		{
	println("Both binary variables contain the same data");		println("Both binary variables contain the same data");

UberFoX at 21:04, 27 July 2014

2014-07-27T21:04:22Z

← Older revision		Revision as of 21:04, 27 July 2014
Line 1:		Line 1:
	<pre>		<pre>
−	BinaryCompare( <binary-array>, <~~binary-array2~~>, <~~offset~~>, <length> )	+	BinaryCompare( <binary-array>, <offset>, <needle, <needleOffset>, <length>, <ignoreCase> )
	</pre>		</pre>

Line 10:		Line 10:

	==== binary-array ====		==== binary-array ====
−
−	~~The a binary variable to use.~~
−
−	~~==== binary-array2 ====~~

	The a binary variable to use.		The a binary variable to use.
Line 22:		Line 18:

	If the start is a negative value the byte position will work backwards from the length of the shortest binary variable.		If the start is a negative value the byte position will work backwards from the length of the shortest binary variable.
		+
		+	==== needle ====
		+
		+	The a binary variable to be comparing to.
		+
		+	==== needleOffset ====
		+
		+	Optional; Start position to begin comparing in the needle. (0 = first byte)

	==== length ====		==== length ====
Line 30:		Line 34:

	If offset denotes the position of this truncation or beyond, failure will be returned ( -2 ).		If offset denotes the position of this truncation or beyond, failure will be returned ( -2 ).
		+
		+	==== ignoreCase ====
		+
		+	Optional; if true the comparison is case-insensitive

	=== Return Value ===		=== Return Value ===
Line 43:		Line 51:
	=== Remarks ===		=== Remarks ===

−	~~None~~.	+	If ignoreCase is true, the result is equivalent to performing a case-sensitive comparison after converting the uppercase ASCII letters A-Z in both binary variables to lowercase.

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

UberFoX: /* Example */

2013-09-27T14:03:28Z

Example

← Older revision		Revision as of 14:03, 27 September 2013
Line 64:		Line 64:
	my $Binary1 = Pack("A*", "Test");		my $Binary1 = Pack("A*", "Test");
	If( BinaryCompare($Binary1, $Binary2) == 0 )		If( BinaryCompare($Binary1, $Binary2) == 0 )
		+	{
		+	println("Both binary variables contain the same data");
		+	}
		+	Else
		+	{
		+	println("No match");
		+	}
		+	</syntaxhighlight>
		+
		+	Check from the 4th byte to the 6th byte
		+
		+	<syntaxhighlight lang="sputnik">
		+	my $Binary1 = Pack("A*", "TheFoXok");
		+	my $Binary2 = Pack("A*", "DatFoXNP");
		+
		+	If( BinaryCompare($Binary1, $Binary2, 3, 3) == 0 )
	{		{
	println("Both binary variables contain the same data");		println("Both binary variables contain the same data");