CFLib.org – Common Function Library Project

Description:
Converts a list to a single-column query.

Return Values:
Returns a query.

Example:

<cfset my_list = 'one,two'>
<cfset my_query = listToQuery(my_list)>
<cfdump var="#my_query#">

Parameters:

Full UDF Source:

<!---
 Converts a list to a single-column query.
 
 @param list 	 List of items. (Required)
 @param delimiters 	 List delimiters. Defaults to a comma. (Optional)
 @param column_name 	 Name to use for column. Defaults to column. (Optional)
 @return Returns a query. 
 @author Russ Spivey (&#114;&#117;&#115;&#115;&#101;&#108;&#108;&#115;&#112;&#105;&#118;&#101;&#121;&#64;&#103;&#109;&#97;&#105;&#108;&#46;&#99;&#111;&#109;) 
 @version 0, September 9, 2009 
--->
<cffunction name="listToQuery" access="public" returntype="query" output="false" 
	hint="Converts a list to a single-column query.">
    <cfargument name="list" type="string" required="yes" hint="List to convert.">
    <cfargument name="delimiters" type="string" required="no" default="," hint="Things that separate list elements.">
    <cfargument name="column_name" type="string" required="no" default="column" hint="Name to give query column.">
    
    <cfset var query = queryNew(arguments.column_name)>
    <cfset var index = ''>
    
    <cfloop list="#arguments.list#" index="index" delimiters="#arguments.delimiters#">
        <cfset queryAddRow(query)>
        <cfset querySetCell(query,arguments.column_name,index)>
    </cfloop>
    
    <cfreturn query>
</cffunction>