2010-04-14 - Jakarta Taglibs has been retired.

Will output: "Some Form Of Lower Case Sentence"
 
<str:capitalizeAllWords>some form of lower case sentence</str:capitalizeAllWords>
       
       

Outputs a header with 'The Title' embedded in a bunch of - characters.
 
<str:center width="40" delimiter="-">The Title</str:center>
       
        

One use could be to remove # and // comments from code when outputted.
 
<str:chomp delimiter="#">Some code; # A comment</str:chomp>
       
        

There is 1 a, 2 e's and no f's. So the result is 3.
 
<str:count set="aef">Some sample text to count</count>
       
        

The substring 'world' is repeated four times in the body.
 
<str:countMatches substring="world">Hello world programs are rife in this world due to their worldy view of how to program a world of code</str:countMatches>
       
        

Useful in parallel with its counterpart. If a database contains the URL in 
encoded form, then this could be used to show a human readable version.
 
<str:decodeUrl>http://www.apache.org/some+file%20/page.html</str:decodeUrl>
       
        

If the inner tag (db:get) return null (or the string "null") then an empty 
string will be printed out.
 
<str:default><db:get value="Name"></str:default>
       
        

Will output: 'Som smpl txt to dlt rom'
 
<str:delete set="aef">Some sample text to delete from</str:delete>
       
        

Especially useful if database output is being put into an <a href="..">
 
<str:encodeUrl>http://www.apache.org/some file//page.html</str:encodeUrl>
       
        

Similarily to its counterpart, this could be used to get the comments from a 
piece of code.
 
<str:getChomp delimiter="#">Some code; # A comment</str:getChomp>
       
        

In the code comment theme, this would return the code but include the comment 
character itself.
 
<str:getPrechomp delimiter="#">Some code; # A comment</str:getPrechomp>
       
        

Useful to join elements of a list.

<% String[] users = new String[] { "john", "bob", "alice", "felipe" }; %>
<str:join items="<%=users%>" separator=" - "/>
       
        

Will output:  '<A long piece of>'
 
&lt;<str:left count="15">A long piece of text which will get cut.</str:rightPad>
       
        

Will output:  '<-------An arrow>'
 
&lt;<str:leftPad width="15" delimiter="-">An arrow</str:rightPad>
       
        

Will output:  '<text which>'
 
&lt;<str:mid count="10">A long piece of text which will get cut.</str:rightPad>
       
        

Pluck's 'Bob' from out of the square brackets.
 
<str:nestedString open="[" close="]">[Bob]</str:nestedString>
       
        

'pond' will be replaced by 'tree'
 
<str:overlay with="tree" start="4" end="8">The pond was wet.</str:overlay>
       
        

Again, this could be used to get the comment from a piece of code. However it 
would not include the delimiter as getChomp would.
 
<str:prechomp delimiter="#">Some code; # A comment</str:prechomp>
       
        

The random tag has a lot of options. The easiest way is to just use the type 
field, as in the example. The second example shows how the developer can 
specify the characters to use, for example, random vowels. The last example 
is merely demonstrative, no one would want to do this, but it shows how the 
developer may specify the range of characters, in this example, all the 
control characters.
 
<str:random count="10" type="alphanumeric"/>
<str:random count="1">aeiou</str:random>
<str:random count="5" start="1" end="32"/>
       
        

All it currently does is strip any <xx> tags out. It doesn't check that 
the tags are correct xml and it would be confused by < or > signs 
inside a tag attribute.
 
<str:removeXml><name>John Brown</name></str:removeXml>
       
        

Will output 'xxxxx'
 
<str:repeat count="5">x</str:repeat>
       
        

One use of the replace tag is to change newlines to html br's. Note that real 
newlines need to be entered into the JSP.
 
<str:replace replace="
" with="&lt;br&gt;
">A sentence.
Another sentence.
Some more to test. And insert Br's into.
Hopefully.</str:replace>
       
_or_ with 1.0.1:
 
<str:replace replace="NL" with="&lt;br&gt;NL" newlineToken="NL">
A sentence.
Another sentence.
Some more to test. And insert Br's into.
Hopefully.</str:replace>
       
        

Major use is to turn domain names into java package names. Bound to be other uses.
 
<str:reverseDelimitedString delimiter=".">org.apache.taglib.string.String</str:reverseDelimitedString>
       
        

Will output:  '<will get cut.>'
 
&lt;<str:right count="13">A long piece of text which will get cut.</str:rightPad>
       
        

Will output:  'An arrow------->'
 
<str:rightPad width="15" delimiter="-">An arrow</str:rightPad>&gt;
       
        

This is the reverse of join and is the equivalent of StringTokenizer in a tag.

<%
<str:split separator=" - " var="users">john - bob - alice - felipe</str:split>
       
        

Will output: 'Some sample text to squeeze'
 
<str:squeeze set="xo">Some sample texxxt toooo squeeze</str:squeeze>
       
        

Default is isWhitespace, that is tab or newline or space character.
 
<str:strip delimiter="-">---A Title---</str:strip>
       
        

 
<str:stripEnd delimiter="-">A Title---</str:stripEnd>
       
        

 
<str:stripStart delimiter="-">---A Title</str:stripStart>
       
        

Will get the substring 'tree' from the body.
 
<str:substring start="4" end="8">The tree is green.</str:substring>
       
        

Will output:  '<The quick brown...>'
 
&lt;<str:truncateNicely lower="13" upper="20">The quick brown fox jumped over the lazy dog.</str:truncateNicely>
       
        

 
<str:wordWrap width ="50" delimiter="&lt;br&gt;">Word-wrap a String. This involves formatting a long String to fit within a certain character width of page. A delimiter may be passed in to put at the end of each line and a splitting character can be specified for when a word has to be cut in half.</str:wordWrap>