Attached is the java file and the doc file (with a .txt attached to the end
to make sure it gets through.)
-- Larry
<html>
<head>
<meta http-equiv="Content-Language" content="en-us">
<title>propertyformatter Task</title>
</head>
<body>
<h2><a name="propertyformatter">propertyformatter</a></h2>
<h3>Description</h3>
<p>Formats a string to a paticular format.</p>
<h3>Parameters</h3>
<table border="1" cellpadding="2" cellspacing="0">
<tr>
<td valign="top"><b>Attribute</b></td>
<td valign="top"><b>Description</b></td>
<td align="center" valign="top"><b>Required</b></td>
</tr>
<tr>
<td valign="top">property</td>
<td valign="top">Property to set new formatted string to.</td>
<td valign="top" align="center">Yes</td>
</tr>
<tr>
<td valign="top">string</td>
<td valign="top">Either a current property or text to be formatted.</td>
<td valign="top" align="center">Yes</td>
</tr>
<tr>
<td valign="top">format</td>
<td valign="top">One of the following: "<code>trim</code>",
"<code>strip</code>", "<code>deletewhitespace</code>",
"<code>chomp</code>", "<code>chop</code>",
"<code>uppercase</code>", "<code>lowercase</code>",
"<code>swapcase</code>", "<code>capitalize</code>",
"<code>uncapitalize</code>", "<code>reverse</code>",
"<code>catitalizewords</code>",
"<code>capipalizewordsfully</code>",
"<code>uncapitalizewords</code>"</td>
<td valign="top" align="center">Yes</td>
</tr>
</table>
<h3>Formats</h3>
<table border="1" cellpadding="2" cellspacing="0">
<tr>
<td valign="top">Format Name</td>
<td valign="top">Format Description</td>
</tr>
<tr>
<td valign="top">trim</td>
<td valign="top">Removes control characters (<code>char < 32</code>)
from both ends of the string.</td>
</tr>
<tr>
<td valign="top">strip</td>
<td valign="top">Similar to <code>trim</code>, but removes whitespace
instead. Whitespace is defined by <code><a
href="http://java.sun.com/products/jdk/1.2/docs/api/java/lang/Character.html#isWhitespace(char)">Character.isWhiteSpace(char)</a></code></td>
</tr>
<tr>
<td valign="top">deletewhitespace</td>
<td valign="top">Deletes all whitespace from the string, not just from the
front or end. Whitespace is defined by <code><a
href="http://java.sun.com/products/jdk/1.2/docs/api/java/lang/Character.html#isWhitespace(char)">Character.isWhiteSpace(char)</a></code></td>
</tr>
<tr>
<td valign="top">chomp</td>
<td valign="top">removes one newline from the end of the string, if it's
there, otherwise leave it alone. A newline is "<code>\n</code>",
"<code>\r</code>" or "<code>\r\n</code>". Closely matches
Perl's <code><a
href="http://perldoc.com/perl5.8.0/pod/func/chomp.html";>chomp</a></code>.</td>
</tr>
<tr>
<td valign="top">chop</td>
<td valign="top">Removes the last character from the string. If the string
ends with "<code>\r\n</code>", then both of them are removed.</td>
</tr>
<tr>
<td valign="top">uppercase</td>
<td valign="top">Converts the string to uppercase, per <a
href="http://java.sun.com/products/jdk/1.2/docs/api/java/lang/String.html#toUpperCase()"><code>String.toUpperCase()</code></a>.</td>
</tr>
<tr>
<td valign="top">lowercase</td>
<td valign="top">Converts the string to lowercase, per <a
href="http://java.sun.com/products/jdk/1.2/docs/api/java/lang/String.html#toLowerCase()"><code>String.toLowerCase()</code></a>.</td>
</tr>
<tr>
<td valign="top">swapcase</td>
<td valign="top">Swaps the case of the string changing upper and title case
to lower case, and lower case to upper case.</td>
</tr>
<tr>
<td valign="top">capitalize</td>
<td valign="top">Capitalizes the string by changing the first letter to
title case, per <a
href="http://java.sun.com/products/jdk/1.2/docs/api/java/lang/Character.html#toTitleCase(char)"><code>Character.toTitleCase(char)</code></a>.
No other letters are changed.</td>
</tr>
<tr>
<td valign="top">uncapitalize</td>
<td valign="top">Uncapitalizes the string by changing the first letter
lowercase, per <a
href="http://java.sun.com/products/jdk/1.2/docs/api/java/lang/Character.html#toLowerCase(char)"><code>Character.toLowerCase(char)</code></a>.
No other letters are changed.</td>
</tr>
<tr>
<td valign="top">reverse</td>
<td valign="top">Reverses the string, per <a
href="http://java.sun.com/products/jdk/1.2/docs/api/java/lang/StringBuffer.html#reverse()">StringBuffer.reverse()</code></a>.</td>
</tr>
<tr>
<td valign="top">capitalizewords</td>
<td valign="top">Capitalizes all the whitespace separated words in the
string. Only the first letter of each word is changed. To change all letters to
the capitalized case, use <code>capitalizewordsfully</code>. Whitespace is
defined by <code><a
href="http://java.sun.com/products/jdk/1.2/docs/api/java/lang/Character.html#isWhitespace(char)">Character.isWhiteSpace(char)</a></code></td>
</tr>
<tr>
<td valign="top">capitalizewordsfully</td>
<td valign="top">Capitalizes all the whitespace separated words in the
string. All letters are changed. Whitespace is defined by <code><a
href="http://java.sun.com/products/jdk/1.2/docs/api/java/lang/Character.html#isWhitespace(char)">Character.isWhiteSpace(char)</a></code></td>
</tr>
<tr>
<td valign="top">uncapitalizewords</td>
<td valign="top">Uncapitalizes all the whitespace separated words in the
string. Uncapitalizes all the whitespace separated words. Whitespace is defined
by <code><a
href="http://java.sun.com/products/jdk/1.2/docs/api/java/lang/Character.html#isWhitespace(char)">Character.isWhiteSpace(char)</a></code></td>
</tr>
</table>
<h3>Examples</h3>
<p><b>Convert a property into all uppercase</b></p>
<pre>
<propertyformatter property="hostname.upper"
value="${hostname}" format="uppercase"/>
</pre>
<!-- TODO: more examples -->
<hr><p align="center">Copyright © 2003 Apache Software Foundation.
All rights Reserved.</p>
</body>
</html>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
