explode

explode(string $separator, string $string, [int $limit]): array
```php

`explode` retorna un array de strings, cada una de ellas siendo una substring del parámetro `string` extraída utilizando el separador `separator`.

## Parámetros

`separator`  
El separador.

`string`  
La string inicial.

`limit`  
Si `limit` está definido y es positivo, el array retornado contiene, como máximo, `limit` elementos, y el último elemento contendrá el resto de la string.

Si el parámetro `limit` es negativo, todos los elementos, excepto los últimos -`limit` elementos, son retornados.

Si `limit` vale cero, es tratado como si valiera 1.

> [!NOTE]
> Antes de PHP 8.0, `implode` aceptaba sus parámetros en cualquier orden. `explode` nunca ha soportado esto: se debe asegurar que el parámetro `separator` esté colocado antes del parámetro `string`.

## Valores devueltos

Retorna un `array` de strings creadas al dividir la string del parámetro `string` en varios trozos siguiendo el parámetro `separator`.

Si `separator` es una string vacía (""), `explode` lanzará una `ValueError`. Si `separator` contiene un valor que no está contenido en `string` así como un valor negativo para el parámetro `limit`, entonces `explode` retornará un `array` vacío, de lo contrario, un `array` conteniendo la string `string` entera. Si los valores de `separator` aparecen al inicio o al final de `string`, estos valores serán añadidos como un valor de un `array` vacío ya sea en la primera o última posición del `array` retornado respectivamente.

## Historial de cambios

| Versión | Descripción |
|----|----|
| 8.0.0 | `explode` lanzará ahora una `ValueError` cuando el parámetro `separator` es una string vacía (`""`). Anteriormente, `explode` retornaba `false`. |

## Ejemplos

Ejemplo con `explode`

Ejemplo de valores retornados por la función `explode`

El ejemplo anterior mostrará:

    array(1)
    (
        [0] => string(5) "hello"
    )
    array(2)
    (
        [0] => string(5) "hello"
        [1] => string(5) "there"
    )
    array(2)
    (
        [0] => string(0) ""
        [1] => string(0) ""
    )

Ejemplo con `explode` y el parámetro `limit`

Array
(
    [0] => one
    [1] => two|three|four
)
Array
(
    [0] => one
    [1] => two
    [2] => three
)