ibexa

Caution: This documentation is for eZ Publish legacy, from version 3.x to 5.x.

contains

Summary

Checks if an array contains a specific element.

Usage

input|contains( element )

Parameters

NameTypeDescriptionRequired
element any The element that should be matched. Yes.

Returns

TRUE if the element is found, FALSE if not.

Description

This operator checks if the input array contains a specific element (specified using the first parameter). If it does, the operator will return TRUE, otherwise FALSE will be returned.

Examples

Example 1

{array( 1, 2, 3, 4, 5 )|contains( 3 )}

Returns TRUE.

Example 2

{array( 1, array( 3, 4 ), 5 )|contains( array( 3, 4 ) )}

Returns TRUE.

Example 3

{array( 1, array( 3, 4 ), 5 )|contains( 3 )}

Returns FALSE.

Balazs Halasy (05/02/2004 9:30 am)

Balazs Halasy (04/05/2005 1:28 pm)

Comments

  • doesn't work when "element" is a node

    Wednesday 19 July 2006 6:33:35 pm

    Mindshare Tech

    When using this function to see if an array contains a node, it always comes back false. It seems that "element" has to be a simpler datatype.

  • works exactly as documented

    Thursday 28 May 2009 6:01:15 pm

    pike

    It should be noted, this operators works only exactly as documented here (in 4.0.1). iow
    contains(array,value)

    does not (seem to) work.

    $2c,
    *-pike