Documentación offline PHP master

MongoDB\BSON\Regex::__construct

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

MongoDB\BSON\Regex::__construct

Construye una nueva REGEX

Descripción#

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

## Parámetros

`pattern` (`string`)  
La máscara de la expresión regular.

> [!NOTE]
> La máscara no debe estar rodeada de caracteres delimitadores.

`flags` (`string`)  
Los [ flags de la expresión regular](https://www.mongodb.com/docs/manual/reference/operator/query/regex/#op._S_options).

## Errores/Excepciones

Lanza una excepción

MongoDB\Driver\Exception\InvalidArgumentException

en caso de error durante el análisis de un argumento.

Lanza una excepción

MongoDB\Driver\Exception\InvalidArgumentException

si

pattern

o

flags

contiene un byte nulo.

## Historial de cambios

<table>
<thead>
<tr>
<th>Versión</th>
<th>Descripción</th>
</tr>
</thead>
<tbody>
<tr>
<td>PECL mongodb 1.2.0</td>
<td><p>El argumento <code>flags</code> es opcional y el valor por omisión es una cadena vacía.</p>
<p>Los caracteres en el argumento <code>flags</code> serán ordenados alfabéticamente cuando se construya una Regex. Anteriormente, los caracteres se almacenaban en el orden proporcionado.</p>
<p><code>MongoDB\Driver\Exception\InvalidArgumentException</code> es lanzada si <code>pattern</code> o <code>flags</code> contiene un byte nulo. Anteriormente, los valores eran truncados en el primer byte nulo.</p></td>
</tr>
</tbody>
</table>

## Ejemplos

`MongoDB\BSON\Regex::__construct` ejemplo

```php

El ejemplo anterior mostrará:

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

Véase también#

Los tipos BSON

Los flags soportados para las expresiones regulares