PHP - Ds Sequence::contains() 函式

PHP 的Ds\Sequence::contains() 函式用於確定指定的值是否在序列中或包含這些值的序列中。

如果該值存在於序列中，則此函式返回布林值'true'，否則返回'false'。它允許您一次檢查單個值或多個值。

語法

以下是 PHP Ds\Sequence::contains() 函式的語法：

public abstract bool Ds\Sequence::contains([ mixed $...values ] )

引數

以下是此函式的引數：

• values - 需要檢查的單個值或多個值。

返回值

如果提供的任何值都不在序列中，則此函式返回 false，否則返回 true。

示例 1

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

<?php
   $seq = new \Ds\Vector([1, 2, 3, 4, 5]);
   echo "The sequence elements are: \n";
   print_r($seq);
   $val = 2;
   echo "The value needs to be checked: ".$val;
   
   #using contains() function
   echo "\nIs value ".$val." present in a sequence: ";
   var_dump($seq->contains($val));
?>

輸出

執行上述程式後，將顯示以下輸出：

The sequence elements are:
Ds\Vector Object
(
    [0] => 1
    [1] => 2
    [2] => 3
    [3] => 4
    [4] => 5
)
The value needs to be checked: 2
Is value 2 present in a sequence: bool(true)

示例 2

如果序列不包含指定的值，則此函式返回“false”。

以下是 PHP Ds\Sequence::contains() 函式的另一個示例。我們使用此函式來確定此序列（["Tutorials", "Point", "India"]）是否包含值“Tutorix”：

<?php
   $seq = new \Ds\Vector(["Tutorials", "Point", "India"]);
   echo "The sequence elements are: \n";
   print_r($seq);
   $val = "Tutorix";
   echo "The value needs to be checked: ".$val;
   #using contains() function
   echo "\nIs value ".$val." present in a sequence: ";
   var_dump($seq->contains($val));
?>

輸出

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

The sequence elements are:
Ds\Vector Object
(
    [0] => Tutorials
    [1] => Point
    [2] => India
)
The value needs to be checked: Tutorix
Is value Tutorix present in a sequence: bool(false)

示例 3

一次檢查多個值。

在下面的示例中，我們使用contains() 函式來確定指定的值是否存在於序列中：

<?php
   $seq = new \Ds\Vector(['a', 'b', 'c', 'd', 'e']);
   echo "The sequence elements are: \n";
   print_r($seq);
   echo "Is values 'a', 'b' and 'c' present in a sequence: ";
   var_dump($seq->contains('a', 'b', 'c'));
?>

輸出

上述程式產生以下輸出：

The sequence elements are:
Ds\Vector Object
(
    [0] => a
    [1] => b
    [2] => c
    [3] => d
    [4] => e
)
Is values 'a', 'b' and 'c' present in a sequence: bool(true)