Gecko [ fernandoquevedodop.com ]

Name	Size	Permission
Array.pm	1.14 KB	-rw-r--r--
Binary.pm	1.99 KB	-rw-r--r--
Bool.pm	1.19 KB	-rw-r--r--
Bytes.pm	3.23 KB	-rw-r--r--
Code.pm	3.59 KB	-rw-r--r--
DBPointer.pm	1.49 KB	-rw-r--r--
DBRef.pm	7.07 KB	-rw-r--r--
Decimal128.pm	9.54 KB	-rw-r--r--
Doc.pm	1.51 KB	-rw-r--r--
Double.pm	5.37 KB	-rw-r--r--
Int32.pm	3.49 KB	-rw-r--r--
Int64.pm	5.42 KB	-rw-r--r--
MaxKey.pm	1.89 KB	-rw-r--r--
MinKey.pm	1.89 KB	-rw-r--r--
OID.pm	10.64 KB	-rw-r--r--
ObjectId.pm	1.67 KB	-rw-r--r--
PP.pm	29.54 KB	-rw-r--r--
Raw.pm	1.81 KB	-rw-r--r--
Regex.pm	4.81 KB	-rw-r--r--
String.pm	2.91 KB	-rw-r--r--
Symbol.pm	871 B	-rw-r--r--
Time.pm	9.38 KB	-rw-r--r--
Timestamp.pm	4.41 KB	-rw-r--r--
Types.pm	14.35 KB	-rw-r--r--

Code Editor : Bytes.pm

use 5.010001;
use strict;
use warnings;

package BSON::Bytes;
# ABSTRACT: BSON type wrapper for binary byte strings

use version;
our $VERSION = 'v1.12.2';

use MIME::Base64 ();
use Tie::IxHash;

use Moo;

#pod =attr data
#pod
#pod A scalar, interpreted as bytes.  (I.e. "character" data should be encoded
#pod to bytes.)  It defaults to the empty string.
#pod
#pod =attr subtype
#pod
#pod A numeric BSON subtype between 0 and 255.  This defaults to 0 and generally
#pod should not be modified.  Subtypes 128 to 255 are "user-defined".
#pod
#pod =cut

has [qw/data subtype/] => (
    is      => 'ro',
);

use namespace::clean -except => 'meta';

sub BUILD {
    my ($self) = @_;
    $self->{data} = '' unless defined $self->{data};
    $self->{subtype} = 0 unless defined $self->{subtype};
}

#pod =method TO_JSON
#pod
#pod Returns Base64 encoded string equivalent to the data attribute.
#pod
#pod If the C<BSON_EXTJSON> option is true, it will instead be compatible with
#pod MongoDB's L<extended JSON|https://github.com/mongodb/specifications/blob/master/source/extended-json.rst>
#pod format, which represents it as a document as follows:
#pod
#pod     {"$binary" : { "base64": "<base64 data>", "subType" : "<type>"} }
#pod
#pod =cut

sub TO_JSON {
    return MIME::Base64::encode_base64($_[0]->{data}, "") unless $ENV{BSON_EXTJSON};

my %data;
    tie( %data, 'Tie::IxHash' );
    $data{base64} = MIME::Base64::encode_base64($_[0]->{data}, "");
    $data{subType} = sprintf("%02x",$_[0]->{subtype});

return {
        '$binary' => \%data,
    };
}

use overload (
    q{""}    => sub { $_[0]->{data} },
    fallback => 1,
);

# backwards compatibility alias
*type = \&subtype;

=pod

=encoding UTF-8

=head1 NAME

BSON::Bytes - BSON type wrapper for binary byte strings

=head1 VERSION

version v1.12.2

=head1 SYNOPSIS

use BSON::Types ':all';

$bytes = bson_bytes( $bytestring );
    $bytes = bson_bytes( $bytestring, $subtype );

=head1 DESCRIPTION

This module provides a BSON type wrapper for binary data represented
as a string of bytes.

=head1 ATTRIBUTES

=head2 data

A scalar, interpreted as bytes.  (I.e. "character" data should be encoded
to bytes.)  It defaults to the empty string.

=head2 subtype

A numeric BSON subtype between 0 and 255.  This defaults to 0 and generally
should not be modified.  Subtypes 128 to 255 are "user-defined".

=head1 METHODS

=head2 TO_JSON

Returns Base64 encoded string equivalent to the data attribute.

If the C<BSON_EXTJSON> option is true, it will instead be compatible with
MongoDB's L<extended JSON|https://github.com/mongodb/specifications/blob/master/source/extended-json.rst>
format, which represents it as a document as follows:

{"$binary" : { "base64": "<base64 data>", "subType" : "<type>"} }

=for Pod::Coverage BUILD type

=head1 OVERLOADING

The stringification operator (C<"">) is overloaded to return the binary data
and fallback overloading is enabled.

=head1 AUTHORS

=over 4

=item *

David Golden <david@mongodb.com>

=item *

Stefan G. <minimalist@lavabit.com>

=back

=head1 COPYRIGHT AND LICENSE

This is free software, licensed under:

The Apache License, Version 2.0, January 2004

=cut

__END__

# vim: set ts=4 sts=4 sw=4 et tw=75:

${this.title}

Code Editor : Bytes.pm