Función PHP Ds\\Map slice()

La función Ds\Map::slice() de la clase PHP Ds\Map se usa para obtener un subconjunto de la instancia de Map especificada. El método devuelve el subconjunto que contiene elementos a partir de un índice específico hasta una longitud específica de la instancia del Mapa.

Sintaxis:

public Ds\Map::slice(int $index, int $length)

Parámetro: Esta función acepta dos parámetros como se describe a continuación:

• $index: este parámetro especifica el índice desde el cual se devolverán los elementos en el subconjunto. Este parámetro puede ser tanto positivo como negativo. Si el índice $es positivo, el rango se calcula desde el frente del mapa y si es negativo, el índice se posiciona desde el final.
• $longitud: Este es un parámetro opcional. Si no se especifica $longitud, los elementos del subconjunto estarán desde el índice inicial hasta el final del mapa. Si se especifica la longitud, el subconjunto devuelto contendrá elementos a partir de $index en el mapa hasta la longitud especificada. Por ejemplo, si $índice = 2 y $longitud = 4, el subconjunto contendrá 4 elementos a partir del elemento presente en el índice 2 en la instancia de Mapa real.

Valor de retorno: el método devuelve el subconjunto que contiene elementos a partir de un índice específico hasta una longitud específica de la instancia del mapa.

Los siguientes programas ilustran la función Ds\Map::slice() :

Programa 1:

<?php
// PHP program to illustrate slice() function
  
$map = new \Ds\Map([1 => 10, 2 => 20, 3 => 30,
                    4 => 40, 5 => 50, 6 => 60]);
  
// When index is positive and length is not 
// specified
print_r($map->slice(4));
  
// When index is negative and length is not 
// specified
print_r($map->slice(-4));
  
?>

Producción:

Ds\Map Object
(
    [0] => Ds\Pair Object
        (
            [key] => 5
            [value] => 50
        )

    [1] => Ds\Pair Object
        (
            [key] => 6
            [value] => 60
        )

)
Ds\Map Object
(
    [0] => Ds\Pair Object
        (
            [key] => 3
            [value] => 30
        )

    [1] => Ds\Pair Object
        (
            [key] => 4
            [value] => 40
        )

    [2] => Ds\Pair Object
        (
            [key] => 5
            [value] => 50
        )

    [3] => Ds\Pair Object
        (
            [key] => 6
            [value] => 60
        )

)

Programa 2:

<?php
// PHP program to illustrate slice() function
  
$map = new \Ds\Map([1 => 10, 2 => 20, 3 => 30,
                    4 => 40, 5 => 50, 6 => 60]);
  
// When index is positive and length is  
// specified
print_r($map->slice(2, 2));
  
// When index is negative and length is 
// specified
print_r($map->slice(-2, 2));
  
?>

Producción:

Ds\Map Object
(
    [0] => Ds\Pair Object
        (
            [key] => 3
            [value] => 30
        )

    [1] => Ds\Pair Object
        (
            [key] => 4
            [value] => 40
        )

)
Ds\Map Object
(
    [0] => Ds\Pair Object
        (
            [key] => 5
            [value] => 50
        )

    [1] => Ds\Pair Object
        (
            [key] => 6
            [value] => 60
        )

)

Referencia : http://php.net/manual/en/ds-map.slice.php