MongoDB\BSON\Regex
PHP-Handbuch

MongoDB\BSON\Regex::__construct

Construct a new Regex

Beschreibung

final public MongoDB\BSON\Regex::__construct ( string $pattern [, string $flags = "" ] )

Parameter-Liste

pattern (string)

The regular expression pattern.

Hinweis:

The pattern should not be wrapped with delimiter characters.

flags (string)

The » regular expression flags. Characters in this argument will be sorted alphabetically.

Fehler/Exceptions

  • Throws MongoDB\Driver\InvalidArgumentException on argument parsing errors.
  • Throws MongoDB\Driver\Exception\InvalidArgumentException if pattern or flags contain null bytes.

Changelog

Version Beschreibung
1.2.0

The flags argument is optional and defaults to an empty string.

Characters in the flags argument will be sorted alphabetically when a Regex is constructed. Previously, the characters were stored in the order provided.

MongoDB\Driver\Exception\InvalidArgumentException is thrown if pattern or flags contain null bytes. Previously, values would be truncated at the first null byte.

Beispiele

Beispiel #1 MongoDB\BSON\Regex::__construct example

<?php

$regex = new MongoDB\BSON\Regex('^foo', 'i');
var_dump($regex);

?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

object(MongoDB\BSON\Regex)#1 (2) {
  ["pattern"]=>
  string(4) "^foo"
  ["flags"]=>
  string(1) "i"
}