Whatever message this page gives is out now! Go check it out!
contains
Last update:
May 18, 2026
Returns whether the set contains a given element.
Description
Tests whether an element is present in the set. In many set APIs, .contains(element) is equivalent to .has(element) (Java-style naming).
Returns
Boolean.
Category
ColdFusion Set member methods
Function syntax
set.contains(element)Parameters
| Parameter | Description |
|---|---|
| element | Value to test. |
See also
Example
The following example uses this API in
cfscript (syntax: set.contains(element)).
<cfscript>
s = setNew();
s.add("beta");
// check data
writeOutput(s.contains("beta")); // true
// check if data is present
writeOutput(s.has("beta")); // true
</cfscript>
Real-world example
Portable guard: use has() if contains() is not yet available in your build.
<cfscript>
function ensureMember(required any bag, required string id) {
if (bag.contains(id)) { // or .has(id)
return false;
}
bag.add(id);
return true;
}
members = setNew();
writeOutput(ensureMember(members, "user1")); // true (added)
writeOutput(ensureMember(members, "user1")); // false (already present)
</cfscript>
We're glad. Tell us how this page helped.
We're sorry. Can you tell us what didn't work for you?
Share additional feedback to help us improve.
0/255
|
