The opposite day, when I used to be taking a look into which whitespace characters are got rid of through trim(), I got here throughout a Lucee CFML serve as that I hadn’t observed prior to: trimWhitespace(). The Serve as does not have an in-depth description; and, taking a look on the Java code did not straight away explain the serve as’s conduct. As such, I sought after to take a look at it out for myself with the intention to see if the serve as could be helpful to me sooner or later.

To start out increase a psychological fashion, I created a <cfsavecontent> buffer that mixed quite a lot of whitespace and non-space characters in quite a lot of orders. Alternatively, every time I went to avoid wasting the record, SublimeText saved looking to trim some of the areas (which is what I would like it to do generally). So, as a substitute of the usage of whitespace immediately, I used some placeholder characters:

• + → House (Chr 32)
• ~ → Tab (Chr 9)

Then, I changed those with the right kind whitespace persona prior to calling trimWhitespace():

<cfsavecontent variable="buffer">
++~++
+__+~+__~+~__~~__~++++
+++++
+~
+__++__+~+__~+~__~~__~
~++++
</cfsavecontent>
<cfscript>

	wiped clean = buffer
		.exchange( "+", chr( 32 ), "all" )
		.exchange( "~", chr( 9 ), "all" )
		.trimWhitespace()
		.exchange( chr( 9 ), "T", "all" )
		.exchange( chr( 10 ), "N", "all" )
		.exchange( chr( 32 ), "S", "all" )
	;

	echo( wiped clean );

</cfscript>

As you’ll see, I’ve all method of whitespace persona mixtures. And, once we run this Lucee CFML code, we get the next output:

N__S__T__T__N__S__S__T__T__N

After going back-and-forth between the enter and the output, I feel I in any case perceive the foundations:

• Any sequence of whitespace characters that incorporates a Newline is collapsed down right into a unmarried Newline persona.

• And sequence of whitespace characters that does now not include a Newline is collapsed down into the first whitespace persona within the sequence.

Paradoxically, the trimWhitespace() serve as does not in truth “trim” the string (leaving Newlines on each leads to my instance). Truly, it is “collapsing” whitespace, now not trimming it. That mentioned, I do like the truth that it reduces a couple of newlines down right into a unmarried newline. I will be able to see that being useful in quite a lot of text-processing workflows.

Need to use code from this submit?
Take a look at the license.