Core Function BinaryFromStr

From Sputnik Wiki
(Difference between revisions)
Jump to: navigation, search
(Created page with "<pre> BinaryFromStr( <string> ) </pre> === Description === Returns a new binary variable created from a strings raw bytes === Parameters === ==== string ==== The string to ...")
 
m (1 revision)
 
(7 intermediate revisions by one user not shown)
Line 1: Line 1:
 
<pre>
 
<pre>
−
BinaryFromStr( <string> )
+
BinaryFromStr( <string>, <flag> )
 
</pre>
 
</pre>
  
Line 12: Line 12:
  
 
The string to use.  
 
The string to use.  
 +
 +
==== flag ====
 +
 +
Optional; Encoding to use.
 +
 +
Choices are:
 +
 +
"RAW" = Forces each character in the string to become a byte regardless of if the character contains a number higher than a byte (casts it)
 +
 +
"ASCII"
 +
 +
"UNICODE" = Alias to UTF8 (or whatever Sputnik is using for Unicode strings)
 +
 +
"UTF8"
 +
 +
"UTF7"
 +
 +
"UTF32"
 +
 +
Default: "RAW"
  
 
=== Return Value ===
 
=== Return Value ===
Line 22: Line 42:
  
 
=== Example ===
 
=== Example ===
 +
 +
 +
ASCII Example
  
 
<syntaxhighlight lang="sputnik">
 
<syntaxhighlight lang="sputnik">
−
$binary = Pack("z0iii", "Hello World!", 100, 200, 300);
+
$binary = Pack("A*", "Hello World!");
−
echo "First binary variable printed BELOW\n";
+
−
printr($binary);
+
−
echo "First binary variable printed ABOVE\n";
+
 
$binStr = BinaryToStr($binary);
 
$binStr = BinaryToStr($binary);
 
echo "String Content: $binStr\n";
 
echo "String Content: $binStr\n";
−
echo "Second binary variable printed BELOW\n";
+
// Prints:
−
printr(BinaryFromStr($binStr));
+
// String Content: Hello World!
−
echo "Second binary variable printed ABOVE\n";
+
</syntaxhighlight>
−
/*
+
 
−
Prints:
+
UNICODE (UTF8) Example
−
First binary variable printed BELOW
+
 
−
{BINARY:24}
+
<syntaxhighlight lang="sputnik">
−
{
+
$binary = BinaryFromStr("ふふふ", "UTF8");
−
        [0] => 72
+
printr $binary;
−
        [1] => 101
+
$binStr = BinaryToStr($binary, "UTF8");
−
        [2] => 108
+
echo "String Content: $binStr\n";
−
        [3] => 108
+
// Prints:
−
        [4] => 111
+
// String Content: ふふふ
−
        [5] => 32
+
−
        [6] => 87
+
−
        [7] => 111
+
−
        [8] => 114
+
−
        [9] => 108
+
−
        [10] => 100
+
−
        [11] => 33
+
−
        [12] => 100
+
−
        [13] => 0
+
−
        [14] => 0
+
−
        [15] => 0
+
−
        [16] => 200
+
−
        [17] => 0
+
−
        [18] => 0
+
−
        [19] => 0
+
−
        [20] => 44
+
−
        [21] => 1
+
−
        [22] => 0
+
−
        [23] => 0
+
−
}
+
−
First binary variable printed ABOVE
+
−
String Content: Hello World!d  È  ,☺
+
−
Second binary variable printed BELOW
+
−
{BINARY:24}
+
−
{
+
−
        [0] => 72
+
−
        [1] => 101
+
−
        [2] => 108
+
−
        [3] => 108
+
−
        [4] => 111
+
−
        [5] => 32
+
−
        [6] => 87
+
−
        [7] => 111
+
−
        [8] => 114
+
−
        [9] => 108
+
−
        [10] => 100
+
−
        [11] => 33
+
−
        [12] => 100
+
−
        [13] => 0
+
−
        [14] => 0
+
−
        [15] => 0
+
−
        [16] => 200
+
−
        [17] => 0
+
−
        [18] => 0
+
−
        [19] => 0
+
−
        [20] => 44
+
−
        [21] => 1
+
−
        [22] => 0
+
−
        [23] => 0
+
−
}
+
−
Second binary variable printed ABOVE
+
−
*/
+
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
[[Category:Core Function]]
 
[[Category:Core Function]]

Latest revision as of 12:37, 14 June 2015

BinaryFromStr( <string>, <flag> )

Contents

Description

Returns a new binary variable created from a strings raw bytes

Parameters

string

The string to use.

flag

Optional; Encoding to use.

Choices are:

"RAW" = Forces each character in the string to become a byte regardless of if the character contains a number higher than a byte (casts it)

"ASCII"

"UNICODE" = Alias to UTF8 (or whatever Sputnik is using for Unicode strings)

"UTF8"

"UTF7"

"UTF32"

Default: "RAW"

Return Value

Returns a new binary variable created from a strings raw bytes

Remarks

None.

Example

ASCII Example 

$binary = Pack("A*", "Hello World!");
$binStr = BinaryToStr($binary);
echo "String Content: $binStr\n";
// Prints:
// String Content: Hello World!

UNICODE (UTF8) Example 

$binary = BinaryFromStr("ふふふ", "UTF8");
printr $binary;
$binStr = BinaryToStr($binary, "UTF8");
echo "String Content: $binStr\n";
// Prints:
// String Content: ふふふ
Retrieved from "http://ubersoft.org/Sputnik/wiki/index.php/Core_Function_BinaryFromStr"
Personal tools
Namespaces
Variants
Actions
Navigation
Toolbox