```php
int preg_match (cadena $patrón, cadena $asunto, matriz &$coincidencias [, int $banderas =0 [, int $desplazamiento =0]])
```
Dónde,
- $patrón: El patrón a buscar. Puede ser una cadena simple o una expresión regular.
- $asunto: La cadena a buscar.
- &$coincidencias: Una matriz que se completará con los resultados de la búsqueda.
- $banderas: Banderas opcionales que se pueden utilizar para modificar el comportamiento de la función.
- $compensación: Desplazamiento opcional en el que debe comenzar la búsqueda.
Ejemplo 1:búsqueda de cadena simple
```php
$subject ="El veloz zorro marrón salta sobre el perro perezoso.";
$patrón ="/zorro/";
preg_match($patrón, $asunto, $coincidencias);
print_r($coincidencias);
```
Producción:
```
Formación
(
[0] => zorro
)
```
En este ejemplo, `$patrón` es una cadena simple "zorro". La matriz `$matches` contendrá la primera aparición del patrón en la cadena `$subject`.
Ejemplo 2:búsqueda de expresiones regulares
```php
$subject ="El veloz zorro marrón salta sobre el perro perezoso.";
$patrón ="/^El.*$/";
preg_match($patrón, $asunto, $coincidencias);
print_r($coincidencias);
```
Producción:
```
Formación
(
[0] => El rápido zorro marrón salta sobre el perro perezoso.
)
```
En este ejemplo, `$pattern` es una expresión regular que coincide con cualquier cadena que comience con "The" y termine con un punto. La matriz `$matches` contendrá la cadena coincidente completa.
Ejemplo 3:Banderas
El argumento `$flags` se puede utilizar para modificar el comportamiento de la función `preg_match()`. Algunas banderas comunes son:
- PREG_OFFSET_CAPTURE: Esta bandera hace que `preg_match()` devuelva el desplazamiento inicial de cada coincidencia en la matriz `$matches`.
- PREG_IGNORE_CASE: Esta bandera hace que `preg_match()` ignore mayúsculas y minúsculas al hacer coincidir el patrón.
- PREG_MULTILINE: Este indicador hace que `preg_match()` trate la cadena `$subject` como varias líneas.
A continuación se muestra un ejemplo del uso del indicador `PREG_OFFSET_CAPTURE`:
```php
$subject ="El veloz zorro marrón salta sobre el perro perezoso.";
$patrón ="/zorro/";
preg_match($patrón, $asunto, $coincidencias, PREG_OFFSET_CAPTURE);
print_r($coincidencias);
```
Producción:
```
Formación
(
[0] => Matriz
(
[0] => zorro
[1] => 16
)
)
```
En este ejemplo, la matriz `$matches` contiene el desplazamiento inicial de la coincidencia en la cadena `$subject`.
Conclusión
La función `preg_match()` es una poderosa herramienta para buscar patrones en cadenas. Al utilizar expresiones regulares, puede buscar y extraer información del texto fácilmente.