Man pages sections > man3 > BSON::Int64

BSON::Int64 - BSON type wrapper for Int64

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


BSON::Int64 - BSON type wrapper for Int64


version v1.4.0


    use BSON::Types ':all';
    bson_int64( $number );


This module provides a BSON type wrapper for a numeric value that would be represented in BSON as a 64-bit integer.
If the value won't fit in a 64-bit integer, an error will be thrown.
On a Perl without 64-bit integer support, the value must be a Math::BigInt object.



A numeric scalar. It will be coerced to an integer. The default is 0.



On a 64-bit perl, returns the value as an integer. On a 32-bit Perl, it will be returned as a Math::BigInt object, which will fail to serialize unless a "TO_JSON" method is defined for that or in package "universal".
If the "BSON_EXTJSON" option is true, it will instead be compatible with MongoDB's extended JSON <> format, which represents it as a document as follows:
    {"$numberLong" : "223372036854775807"}


The numification operator, "0+" is overloaded to return the "value", the full "minimal set" of overloaded operations is provided (per overload documentation) and fallback overloading is enabled.


David Golden <>
Stefan G. <>
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