/usr/share/perl5/BSON/String.pm is in libbson-perl 1.4.0-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 | use 5.010001;
use strict;
use warnings;
package BSON::String;
# ABSTRACT: BSON type wrapper for strings
use version;
our $VERSION = 'v1.4.0';
use Moo;
#pod =attr value
#pod
#pod A scalar value, which will be stringified during construction. The default
#pod is the empty string.
#pod
#pod =cut
has 'value' => (
is => 'ro'
);
use namespace::clean -except => 'meta';
sub BUILDARGS {
my $class = shift;
my $n = scalar(@_);
my %args;
if ( $n == 0 ) {
$args{value} = '';
}
elsif ( $n == 1 ) {
$args{value} = shift;
}
elsif ( $n % 2 == 0 ) {
%args = @_;
$args{value} = '' unless defined $args{value};
}
else {
croak("Invalid number of arguments ($n) to BSON::String::new");
}
# normalize all to internal PV type
$args{value} = "$args{value}";
return \%args;
}
#pod =method TO_JSON
#pod
#pod Returns value as a string.
#pod
#pod =cut
sub TO_JSON { return "$_[0]->{value}" }
use overload (
# Unary
q{""} => sub { $_[0]->{value} },
q{0+} => sub { 0+ $_[0]->{value} },
q{~} => sub { ~( $_[0]->{value} ) },
# Binary
( map { $_ => eval "sub { return \$_[0]->{value} $_ \$_[1] }" } qw( + * ) ), ## no critic
(
map {
$_ => eval ## no critic
"sub { return \$_[2] ? \$_[1] $_ \$_[0]->{value} : \$_[0]->{value} $_ \$_[1] }"
} qw( - / % ** << >> x <=> cmp & | ^ )
),
(
map { $_ => eval "sub { return $_(\$_[0]->{value}) }" } ## no critic
qw( cos sin exp log sqrt int )
),
q{atan2} => sub {
return $_[2] ? atan2( $_[1], $_[0]->{value} ) : atan2( $_[0]->{value}, $_[1] );
},
# Special
fallback => 1,
);
1;
=pod
=encoding UTF-8
=head1 NAME
BSON::String - BSON type wrapper for strings
=head1 VERSION
version v1.4.0
=head1 SYNOPSIS
use BSON::Types ':all';
bson_string( $string );
=head1 DESCRIPTION
This module provides a BSON type wrapper for a string value.
Since Perl does not distinguish between numbers and strings, this module
provides an explicit string type for a scalar value.
=head1 ATTRIBUTES
=head2 value
A scalar value, which will be stringified during construction. The default
is the empty string.
=head1 METHODS
=head2 TO_JSON
Returns value as a string.
=for Pod::Coverage BUILDARGS
=head1 OVERLOADING
The stringification operator (C<"">) is overloaded to return the C<value>,
the full "minimal set" of overloaded operations is provided (per L<overload>
documentation) 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 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
=cut
__END__
# vim: set ts=4 sts=4 sw=4 et tw=75:
|