PHP - Ds Map::reverse() 函式

PHP 的 Ds\Map::reverse() 函式會就地反轉對映中元素的順序。“就地”表示它會修改原始對映，而不會建立或儲存任何新的記憶體。

反轉對映中元素的順序意味著第一個元素將被放置在最後一個位置，最後一個元素被放置在第一個位置。例如，如果對映是 ([1, 2])，則反轉後的對映將是 ([2, 1])。

語法

以下是 PHP Ds\Map::reverse() 函式的語法：

public Ds\Map::reverse(): void

引數

此函式不接受任何引數。

返回值

此函式不返回值，但會反轉對映元素的順序。

示例 1

以下是 PHP Ds\Map::reverse() 函式的基本示例：

<?php 
   $map = new \Ds\Map([1, 2, 3]); 
   echo "The original map elements are: \n";
   print_r($map);
   echo "The map elements are reversing: \n";
   #using reverse() function
   $map->reverse();
   print_r($map);
?>

輸出

以上程式產生以下輸出：

The original map elements are:
Ds\Map Object
(
    [0] => Ds\Pair Object
        (
            [key] => 0
            [value] => 1
        )

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

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

)
The map elements are reversing:
Ds\Map Object
(
    [0] => Ds\Pair Object
        (
            [key] => 2
            [value] => 3
        )

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

    [2] => Ds\Pair Object
        (
            [key] => 0
            [value] => 1
        )

)

示例 2

以下是 PHP Ds\Map::reverse() 函式的另一個示例。我們使用此函式來反轉此對映 (["Tutorials", "Point", "India"]) 元素的順序：

<?php 
   $map = new \Ds\Map(["Tutorials", "Point", "India"]);
   echo "The map elements before reversing: \n";
   foreach($map as $key=>$value){
	   echo "[".$key."] = ".$value."\n";
   }
   echo "The map elements after reversing: \n";
   #using reverse() function
   $map->reverse();
   foreach($map as $key=>$value){
	   echo "[".$key."] = ".$value."\n";
   }
?>

輸出

執行上述程式後，將生成以下輸出：

The map elements before reversing:
[0] = Tutorials
[1] = Point
[2] = India
The map elements after reversing:
[2] = India
[1] = Point
[0] = Tutorials