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: Created page with "

 BinaryJoin( , , ,  )

=== Description === Join together a ton of Binary variables in an extremely fast and efficient way. === Para..."

2014-07-27T08:32:21Z

Created page with "<pre> BinaryJoin( <separator>, <values>, <start>, <count> ) </pre> === Description === Join together a ton of Binary variables in an extremely fast and efficient way. === Para..."

New page

<pre>
BinaryJoin( <separator>, <values>, <start>, <count> )
</pre>

=== Description ===

Join together a ton of Binary variables in an extremely fast and efficient way.

=== Parameters ===

==== separator ====

A value to use as the separator.

==== values ====

One of more values to be joined.

To send more than one value create an array()

==== start ====

Optional; Position of the first array element in values to use.

==== length ====

Optional; Number of elements in values to use.

=== Return Value ===

Success: Returns a new binary variable.

Failure: Returns empty binary variable.

=== Remarks ===

Use NULL as the separator to join with an empty separator.

This function is generic similar to the arrays Join() function so you can use anything you want in as the parameters and it will be converted into binary on the fly.

=== Example ===

<syntaxhighlight lang="sputnik">
// Create some binary variables
$binary1 = Pack("A*", "The");
$binary2 = Pack("A*", "quick");
$binary3 = Pack("A*", "FoX");
// Create a separator
$binarySep = Pack("A*", " ");

// Join them together
my $Joined = BinaryJoin($binarySep, array($binary1, $binary2, $binary3));

// Print result
say BinaryExpand($Joined);
// Prints:
// 54 68 65 20 71 75 69 63 6B 20 46 6F 58 -- -- -- The quick FoX
</syntaxhighlight>

Same as above but this time with no separator

<syntaxhighlight lang="sputnik">
// Create some binary variables
$binary1 = Pack("A*", "The");
$binary2 = Pack("A*", "quick");
$binary3 = Pack("A*", "FoX");

// Join them together
my $Joined = BinaryJoin(null, array($binary1, $binary2, $binary3));

// Print result
say BinaryExpand($Joined);
// Prints:
// 54 68 65 71 75 69 63 6B 46 6F 58 -- -- -- -- -- ThequickFoX
</syntaxhighlight>

Since this is a generic function like the array Join() function you can use anything as the parameters and it will be converted into binary on the fly for example here we use a string for the separator

<syntaxhighlight lang="sputnik">
// Create some binary variables
$binary1 = Pack("A*", "The");
$binary2 = Pack("A*", "quick");
$binary3 = Pack("A*", "FoX");

// Join them together
my $Joined = BinaryJoin(",", array($binary1, $binary2, $binary3));
my $Joined2 = BinaryJoin("?!", array($binary1, $binary2, $binary3));

// Print result
say BinaryExpand($Joined);
say BinaryExpand($Joined2);
// Prints:
// 54 68 65 2C 71 75 69 63 6B 2C 46 6F 58 -- -- -- The,quick,FoX
// 54 68 65 3F 21 71 75 69 63 6B 3F 21 46 6F 58 -- The?!quick?!FoX
</syntaxhighlight>

[[Category:Core Function]]

Core Function BinaryJoin - Revision history

UberFoX: 1 revision

UberFoX: 1 revision

UberFoX: Created page with "
BinaryJoin( , , , )
=== Description === Join together a ton of Binary variables in an extremely fast and efficient way. === Para..."