/ 
Mango-0.18
River stage two • 9 direct dependents • 10 total dependents
/ Mango::BSON

NAME

Mango::BSON - BSON

SYNOPSIS

use Mango::BSON ':bson';

my $bson = bson_encode {
  foo       => 'bar',
  baz       => 0.42,
  unordered => {one => [1, 2, 3], two => bson_time},
  ordered   => bson_doc(one => qr/test/i, two => bson_true)
};
my $doc = bson_decode $bson;

DESCRIPTION

Mango::BSON is a minimalistic implementation of http://bsonspec.org.

In addition to a bunch of custom BSON data types it supports normal Perl data types like Scalar, Regexp, undef, Array reference, Hash reference and will try to call the TO_JSON method on blessed references, or stringify them if it doesn't exist. Scalar references will be used to generate booleans, based on if their values are true or false.

FUNCTIONS

Mango::BSON implements the following functions.

bson_bin

my $bin = bson_bin $bytes;

Create new BSON element of the binary type with Mango::BSON::Binary, defaults to the generic binary subtype.

# Function
bson_bin($bytes)->type('function');

# MD5
bson_bin($bytes)->type('md5');

# UUID
bson_bin($bytes)->type('uuid');

# User defined
bson_bin($bytes)->type('user_defined');

bson_code

my $code = bson_code 'function () {}';

Create new BSON element of the code type with Mango::BSON::Code.

# With scope
bson_code('function () {}')->scope({foo => 'bar'});

bson_dbref

my $dbref = bson_dbref('test', $oid);

Create a new database reference.

bson_decode

my $doc = bson_decode $bson;

Decode BSON into Perl data structures.

bson_doc

my $doc = bson_doc;
my $doc = bson_doc foo => 'bar', baz => 0.42, yada => {yada => [1, 2, 3]};

Create new BSON document with Mango::BSON::Document, which can also be used as a generic ordered hash.

# Order is preserved
my $hash = bson_doc one => 1, two => 2, three => 3;
$hash->{four} = 4;
delete $hash->{two};
say for keys %$hash;

bson_encode

my $bson = bson_encode $doc;
my $bson = bson_encode {};

Encode Perl data structures into BSON.

bson_false

my $false = bson_false;

Create new BSON element of the boolean type false.

bson_length

my $len = bson_length $bson;

Check BSON length prefix.

bson_max

my $max_key = bson_max;

Create new BSON element of the max key type.

bson_min

my $min_key = bson_min;

Create new BSON element of the min key type.

bson_oid

my $oid = bson_oid;
my $oid = bson_oid '1a2b3c4e5f60718293a4b5c6';

Create new BSON element of the object id type with Mango::BSON::ObjectID, defaults to generating a new unique object id.

# Generate object id with specific epoch time
my $oid = bson_oid->from_epoch(1359840145);

bson_time

my $now  = bson_time;
my $time = bson_time time * 1000;

Create new BSON element of the UTC datetime type with Mango::BSON::Time, defaults to milliseconds since the UNIX epoch.

bson_true

my $true = bson_true;

Create new BSON element of the boolean type true.

bson_ts

my $timestamp = bson_ts 23, 24;

Create new BSON element of the timestamp type with Mango::BSON::Timestamp.

decode_int32

my $int32 = decode_int32 $bytes;

Decode 32bit integer.

decode_int64

my $int64 = decode_int64 $bytes;

Decode 64bit integer.

encode_cstring

my $bytes = encode_cstring $cstring;

Encode cstring.

encode_int32

my $bytes = encode_int32 $int32;

Encode 32bit integer.

encode_int64

my $bytes = encode_int64 $int64;

Encode 64bit integer.

SEE ALSO

Mango, Mojolicious::Guides, http://mojolicio.us.