Caution: This documentation is for eZ Publish legacy, from version 3.x to 6.x.
For 5.x documentation covering Platform see eZ Documentation Center, for difference between legacy and Platform see 5.x Architecture overview.

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

  • Recursively?

    Monday 15 May 2006 7:45:22 am

    Richard Tuin

    In example 3 is told recursive searching through arrays is not possible.
    Is this going to be supported in some way?

    In my specific situation it comes very handy when checking the validation array which comes involved with form processing.