GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
BSON::Regex(3) User Contributed Perl Documentation BSON::Regex(3)

BSON::Regex - BSON type wrapper for regular expressions

version v1.12.2

    use BSON::Types ':all';

    $regex = bson_regex( $pattern );
    $regex = bson_regex( $pattern, $flags );

This module provides a BSON type wrapper for a PCRE regular expression and optional flags.

A string containing a PCRE regular expression pattern (not a "qr" object and without slashes). Default is the empty string.

A string with regular expression flags. Flags will be sorted and duplicates will be removed during object construction. Supported flags include "imxlsu". Invalid flags will cause an exception. Default is the empty string.

    my $qr = $regexp->try_compile;

Tries to compile the "pattern" and "flags" into a reference to a regular expression. If the pattern or flags can't be compiled, a exception will be thrown.

SECURITY NOTE: Executing a regular expression can evaluate arbitrary code if the re 'eval' pragma is in force. You are strongly advised to read re and never to use untrusted input with "try_compile".

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

    {"$regularExpression" : { pattern: "<pattern>", "options" : "<flags>"} }

If the "BSON_EXTJSON" option is false, an error is thrown, as this value can't otherwise be represented in JSON.

  • David Golden <david@mongodb.com>
  • Stefan G. <minimalist@lavabit.com>

This software is Copyright (c) 2020 by Stefan G. and MongoDB, Inc.

This is free software, licensed under:

  The Apache License, Version 2.0, January 2004
2020-08-13 perl v5.32.1

Search for    or go to Top of page |  Section 3 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.