LiveDocs Comments - coldfusion - 6 - CFML_Reference - functions-pt2102.htm

coldfusion/6/CFML_Reference/functions-pt2102.htm

m c d — 2004-01-06T07:26:19

Please note that non-English characters are not sorted correctly. For example, "Ö" comes after "Z".

coldfusion/6/CFML_Reference/functions-pt2102.htm

tedmasterweb — 2003-04-22T11:18:00

This function is actually just misnamed. It should be StructKeyArraySorted(). This is because this function functions exactly the same as StructKeyArray() with the exception that the array elements can be sorted according to one of the members of the structure parameter.

coldfusion/6/CFML_Reference/functions-pt2102.htm

tedmasterweb — 2003-04-22T09:56:00

There is no way to "permanently" sort a structure, not even with a recursive cfscript function. As soon as you call the structure, it reverts to whatever internal sort state the cf engine decides the structure should have. I've read somewhere that this is a desired behavior, but I find it to be counter productive as I rarely output the contents of a structure in an unsorted list.

The work-around is to include something along the lines of the following in your code:

// get an array of the structure keys, sorted by whatever subkey you need. In this case the subkey is "name"
sorted = structsort ( structs, "textnocase", "ASC", "name" );

// walk through each element of sorted, calling the corresponding structure and doing something with its content
for ( x = 1; x lte ArrayLen ( sorted ); x = x + 1 )
{
result = result & structs[sorted[x]].name & "
";
}

// return the sorted list of names...
return result;

coldfusion/6/CFML_Reference/functions-pt2102.htm

hotwater — 2003-01-09T13:48:00

It doesn't return an array of structures, it returns an array of strings.