Caution: Java String::Split() Does Not Create A ColdFusion Array

Posted January 26, 2007 at 10:41 PM

Tags: ColdFusion

This has been covered before, but you can call the Java string methods on ColdFusion string objects. One of those methods is the String::Split() method. In the Java documentation, it says that it splits this string around matches of the given regular expression. The return value is an array of String objects. When dumped out, these arrays look just like ColdFusion arrays, but they are NOT ColdFusion arrays. ColdFusion arrays are actually Vectors.

To demonstrate that, here are two arrays, one built by ColdFusion and one built by Java:

 Launch code in new window » Download code as text file »

  • <!--- Set up the words list. --->
  • <cfset strWords = "I like to move it, move it!" />
  •  
  • <!---
  • Create the words array using the underlying
  • Java method, String::Split().
  • --->
  • <cfset arrWordsJava = strWords.Split( " {1}" ) />
  •  
  •  
  • <!---
  • Create the words array using the ColdFusion
  • function ListToArray().
  • --->
  • <cfset arrWordsCF = ListToArray( strWords, " " ) />

Dumping out the Java String::Split() array, we see:


 
 
 

 
CFDump Java String::Split()  
 
 
 

Dumping out the ColdFusion ListToArray() array, we see:


 
 
 

 
CFDump ColdFusion ListToArray()  
 
 
 

They look exactly the same, right??? Maybe, but they are quite different. From what I can see, the Array returned by the Split() method is read only. If you look at the class methods:


 
 
 

 
CFDump - Java String::Split() Java Class Methods  
 
 
 

... you can see there are no methods about altering it. In fact, if you try to use ArrayResize() on this array, you get the error:

null null

... and if you try to update one of the values (as in arrWordsJava[ 1 ] = "Ben") you get the error:

You have attempted to dereference a scalar variable of type class coldfusion.runtime.Cast$1 as a structure with members.

Seems like this is read only. The Split() method is really awesome, especially since it splits on a Regular Expression, but just BE CAREFUL, the resultant array is pretty much only for reference.

Download Code Snippet ZIP File

Post Comment  |  Ask Ben  |  Other Searches  |  Print Page




Learning ColdFusion 9 - ColdFusion 9 tutorials, samples, examples, demos

Reader Comments

Jan 27, 2007 at 12:09 AM // reply »
45 Comments

I came acrossed this _exact_ issue yesterday. This explains it.

Consider the following code:

<cfset tzObj=createObject("java","java.util.TimeZone")>
<cfset tzs = tzObj.getAvailableIDs()>
<cfdump var="#tzs#">

<!--- uncomment the next line and you'll get the funky error --->
<!--- <cfset arraySort(tzs, "textnocase")> --->

<!--- rebuild the array manually and the arraySort() works....WEIRD! --->
<cfset foo = arrayNew(1)>
<cfloop from="1" to="#arrayLen(tzs)#" index="i">
<cfset arrayAppend(foo, tzs[i])>
</cfloop>
<!--- no error here --->
<cfset arraySort(foo, "textnocase")>
<cfdump var="#foo#">

So why to some of the array functions work? For example, arrayToList(tzs) works. I ultimately used arrayToList() and listSort() to achieve the desired result.

PS. Noob question - how did you dump the class methods?


Jan 27, 2007 at 1:37 PM // reply »
7,210 Comments

Todd,

Yeah, what you are saying makes sense. ArrayToList() must actually iterate over the array to get the value (hence it works with the read-only properties of the array). I guess it is not doing any kind of Join or anything like that.

As far as getting the class methods, I use reflection to get the information about the Java object (works also with ColdFusion objects). Take a look at the ColdFusion User Defined Function I wrote for this:

http://bennadel.com/index.cfm?dax=blog:206.view

It works 95% of the time. I have to add a try/catch in there for special cases, but so far it's been pretty great.


Jun 5, 2007 at 10:41 PM // reply »
1 Comments

Read Only !!! That explains why <cfparam name=array[i] wont work on an array created with split...Any other solutions?


Jun 7, 2007 at 9:41 AM // reply »
7,210 Comments

@Rob,

You inspired me to finally go think it out:

http://www.bennadel.com/index.cfm?dax=blog:760.view


Feb 3, 2009 at 2:19 PM // reply »
6 Comments

ack! this totally bit my arse this morning... grrrr

good to see I'm not the only one that has run into it..


Aug 11, 2009 at 1:45 PM // reply »
1 Comments

Thanks for the post,
I was looking for this piece of code for ages


Post Comment  |  Ask Ben

Recent Blog Comments
Feb 9, 2010 at 7:57 AM
Ask Ben: Converting a Query to an Array
@Stju, Did you actually test this? I ask because there is a fatal flaw in it - you are using the same Row struct for every row. Since Structs are passed by reference, every subsequent update you ma ... read »
Feb 9, 2010 at 7:50 AM
Using jQuery's SlideUp() and SlideDown() Methods With Bottom-Positioned Elements
@Thomas, Not bad. I suppose you could do the same with Top as well as margin. ... read »
Feb 9, 2010 at 7:47 AM
Ask Ben: Creating A PDF And Attaching It To An Email Using ColdFusion
@Johan, I don't think I have one off hand. Basically, you'd just want to use the File attribute of CFDocument to save the PDF to disk. Then, you'd want to use the File attribute of CFMailParam to a ... read »
Feb 9, 2010 at 5:34 AM
Creating A "Remember Me" Login System In ColdFusion
Any change you could show how to take advantage how the J2ee session stuff in your code? http://kb2.adobe.com/cps/182/tn_18232.html ... read »
Feb 9, 2010 at 5:32 AM
Creating A "Remember Me" Login System In ColdFusion
This may help: http://bugs.farcrycms.org/browse/FC-79 Its the session variables' option being selected in the CF Admin ... read »
Feb 9, 2010 at 4:14 AM
Ask Ben: Converting a Query to an Array
Exellent script! [code removed] ... read »
Feb 9, 2010 at 3:16 AM
Using jQuery's SlideUp() and SlideDown() Methods With Bottom-Positioned Elements
Just a quick fix for the code example above: $('.panel').height() should instead be... $('.panel').outerHeight() ... read »
Feb 9, 2010 at 3:09 AM
Using jQuery's SlideUp() and SlideDown() Methods With Bottom-Positioned Elements
I came across this page because I was searching for a certain behavior. I didn't just want the element to slide up; I wanted it's contents to slide up with it. As if the contents were written on a p ... read »