User Guide Cancel

ArrayDeleteNoCase

 

Note:

As of ColdFusion (2021 release), CORBA has been removed. You can no longer use CORBA-related features, functions, and tags.

Description

Searches an array for the first position of a specified object and deletes it. The function searches for simple objects such as strings and numbers. Simple object string searches are case-insensitive. This function does not support searches for COM and CORBA objects.

Returns

The updated array after deleting the specified element.

Category

History

ColdFusion (2018 release): Introduced named parameters.

ColdFusion (2016 release): Added this function

Function syntax

ArrayDeleteNoCase(array,value)
ArrayDeleteNoCase(array,value)
ArrayDeleteNoCase(array,value)

See also

Parameters

Parameter

Description

array

(Required) Array to search in.

value

(Required) A string, numeric, or boolean value on which to search. Case insensitive. If the object does not match any member in the array, the function returns false.

Example

<cfscript>
myArray=ArrayNew(1);
myArray=["Analyze","Analyse","Analysis","analyse","analysis","analyze"];
WriteOutput(ArrayDeleteNoCase(myArray,"analyze")); // Returns true because object matches an element in the array
WriteOutput(SerializeJSON(myArray)); // Returns array after deleting the first element in the array
</cfscript>
<cfscript> myArray=ArrayNew(1); myArray=["Analyze","Analyse","Analysis","analyse","analysis","analyze"]; WriteOutput(ArrayDeleteNoCase(myArray,"analyze")); // Returns true because object matches an element in the array WriteOutput(SerializeJSON(myArray)); // Returns array after deleting the first element in the array </cfscript>
<cfscript>
       myArray=ArrayNew(1);
       myArray=["Analyze","Analyse","Analysis","analyse","analysis","analyze"];
       WriteOutput(ArrayDeleteNoCase(myArray,"analyze")); // Returns true because object matches an element in the array
       WriteOutput(SerializeJSON(myArray)); // Returns array after deleting the first element in the array
</cfscript>

Output

["Analyse","Analysis","analyse","analysis","analyze"]

Using member function

<cfscript>
myArray=ArrayNew(1);
myArray=["Analyze","Analyse","Analysis","analyse","analysis","analyze"];
WriteDump(myArray.DeleteNoCase("analyze"));
</cfscript>
<cfscript> myArray=ArrayNew(1); myArray=["Analyze","Analyse","Analysis","analyse","analysis","analyze"]; WriteDump(myArray.DeleteNoCase("analyze")); </cfscript>
<cfscript>
       myArray=ArrayNew(1);
       myArray=["Analyze","Analyse","Analysis","analyse","analysis","analyze"];
       WriteDump(myArray.DeleteNoCase("analyze"));
</cfscript>

Get help faster and easier

New user?