Man pages sections > man3 > BSON::Bytes

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

BSON::Bytes(3pm) User Contributed Perl Documentation BSON::Bytes(3pm)

NAME

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

VERSION

version v1.4.0

SYNOPSIS

    use BSON::Types ':all';
    $bytes = bson_bytes( $bytestring );
    $bytes = bson_bytes( $bytestring, $subtype );

DESCRIPTION

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

ATTRIBUTES

data

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

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".

METHODS

TO_JSON

Returns Base64 encoded string equivalent to the data attribute.
If the "BSON_EXTJSON" option is true, it will instead be compatible with MongoDB's extended JSON <https://docs.mongodb.org/manual/reference/mongodb-extended-json/> format, which represents it as a document as follows:
    {"$binary" : "<base64 data>", "$type" : "<type>"}

OVERLOADING

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

AUTHORS

David Golden <david@mongodb.com>
Stefan G. <minimalist@lavabit.com>
This software is Copyright (c) 2017 by Stefan G. and MongoDB, Inc.
This is free software, licensed under:
  The Apache License, Version 2.0, January 2004
2017-09-06 perl v5.26.0