JSTL函数库

使用实例：<%@ taglib prefix="fn" uri="http://java.sun.com/jsp/jstl/functions" %> ${fn:length(myCollection)}
其他函数：

函数	描述
fn:contains(string, substring)	如果参数string中包含参数substring，返回true
fn:containsIgnoreCase(string, substring)	如果参数string中包含参数substring（忽略大小写），返回true
fn:endsWith(string, suffix)	如果参数 string 以参数suffix结尾，返回true
fn:escapeXml(string)	将有特殊意义的XML (和HTML)转换为对应的XML character entity code，并返回
fn:indexOf(string, substring)	返回参数substring在参数string中第一次出现的位置
fn:join(array, separator)	将一个给定的数组array用给定的间隔符separator串在一起，组成一个新的字符串并返回。
fn:length(item)	返回参数item中包含元素的数量。参数Item类型是数组、collection或者String。如果是String类型,返回值是String中的字符数。
fn:replace(string, before, after)	返回一个String对象。用参数after字符串替换参数string中所有出现参数before字符串的地方，并返回替换后的结果
fn:split(string, separator)	返回一个数组，以参数separator 为分割符分割参数string，分割后的每一部分就是数组的一个元素
fn:startsWith(string, prefix)	如果参数string以参数prefix开头，返回true
fn:substring(string, begin, end)	返回参数string部分字符串, 从参数begin开始到参数end位置，包括end位置的字符
fn:substringAfter(string, substring)	返回参数substring在参数string中后面的那一部分字符串
fn:substringBefore(string, substring)	返回参数substring在参数string中前面的那一部分字符串
fn:toLowerCase(string)	将参数string所有的字符变为小写，并将其返回
fn:toUpperCase(string)	将参数string所有的字符变为大写，并将其返回
fn:trim(string)	去除参数string 首尾的空格，并将其返回

fn:toLowerCase函数
fn:toLowerCase函数将一个字符串中包含的所有字符转换为小写形式，并返回转换后的字符串，它接收一个字符串类型的参数。
fn:toLowerCase函数的应用举例：
fn:toLowerCase("Www.IT315.org") 的返回值为字符串“www.it315.org”
fn:toLowerCase("")的返回值为空字符串
fn:toUpperCase函数
fn:toUpperCase函数将一个字符串中包含的所有字符转换为大写形式，并返回转换后的字符串，它接收一个字符串类型的参数。
fn:toUpperCase函数的应用举例：
fn:toUpperCase("Www.IT315.org") 的返回值为字符串“WWW.IT315.ORG”
fn:toUpperCase("")的返回值为空字符串
fn:trim函数
fn:trim函数删除一个字符串的首尾的空格，并返回删除空格后的结果字符串，它接收一个字符串类型的参数。需要注意的是，fn:trim函数不能删除字符串中间位置的空格。
例如，fn:trim("www.it 315.org  ") 的返回值为字符串“www.it  315.org”。
fn:escapeXml函数
fn:escapeXml函数将字符串中的需要进行转义的HTML特殊字符按表8.2进行HTML编码转换，并返回转换后的字符串，这样就可以在浏览器中显示出HTML特殊字符。fn:escapeXml函数接收一个字符串类型的参数。
例如，运行包含如下代码的JSP文件后浏览器将跳转到“http://www.it315.org”页面，这是因为这些代码被浏览器作为HTML标签解释执行：
<meta http-equiv="refresh" content="0;url=http://www.it315.org"/>
如果用fn:escapeXml函数处理上面的代码，运行JSP文件后就在浏览器窗口输出这行代码，例程8-54是使用fn:escapeXml函数处理上面的代码的例子程序。
<%@ taglibprefix="fn" uri="http://java.sun.com/jsp/jstl/functions"%>
${fn:escapeXml('<metahttp-equiv="refresh" content="0;url=http://www.it315.org"/>')}
fn:length函数
fn:length函数用于返回一个集合或数组对象中包含的元素的个数，或返回一个字符串中包含的字符的个数，返回值为int类型。fn:length函数接收一个参数，这个参数可以是<c:forEach>标签的items属性支持的任何类型，包括任意类型的数组、java.util.Collection、java.util.Iterator、java.util.Enumeration、java.util.Map等类的实例对象和字符串。
如果fn:length函数的参数为null或者是元素个数为0的集合或数组对象，则函数返回0；如果参数是空字符串，则函数返回0。
<%@ taglibprefix="fn" uri="http://java.sun.com/jsp/jstl/functions"%>
<%@ pagecontentType="text/html;charset=gb2312" %>
<%@ pageimport="java.util.*, org.it315.UserBean" %>
<%
       Collection users = new ArrayList();
       for(int i=0; i<5; i++)
       {
              UserBean user = new UserBean();
              user.setUserName("user"+ i);
              user.setPassword("guest"+ i);
              users.add(user);
       }
       session.setAttribute("users",users);
%>
There are${fn:length(users)} users online.<hr />
字符串“www.it315.org”中包含 ${fn:length("www.it315.org")} 个字符
fn:spilt函数
fn:split函数以指定字符串作为分隔符，将一个字符串分割成字符串数组并返回这个字符串数组。fn:split函数接收两个字符串类型的参数，第一个参数表示要分割的字符串，第二个参数表示作为分隔符的字符串。
fn:split函数实现java.util.StringTokenizer类分割字符串的操作，得到的字符串数组中的各字符串元素不包含分隔符本身，例如，fn:split("www.it315.org",".")[1]的返回值为字符串“it315”。
如果第一个参数是空字符串，则fn:split函数返回的字符串数组中只包含空字符串这一个元素，例如，fn:split("",".")[0]的返回值为空字符串。
如果第二个参数是空字符串，则函数返回的字符串数组中只包含源字符串这一个元素，例如，fn:split("www.it315.org","")[0]的返回值为字符串“www.it315.org”，fn:split("www.it315.org", "")[1]的返回值为空字符串。
fn:join函数
fn:join函数以一个字符串作为分隔符，将一个字符串数组中的所有元素合并为一个字符串并返回合并后的结果字符串。fn:join函数接收两个参数，第一个参数是要操作的字符串数组，第二个参数是作为分隔符的字符串。
如果fn:join函数的第二个参数是空字符串，则fn:join函数的返回值是不使用任何分隔符将字符串数组中的各元素连接起来的结果字符串。
fn:join函数的应用举例：
假设stringArray是保存在Web域中的一个属性，它表示一个{"www","it315","org"}的字符串数组，则fn:join(stringArray, ".")返回字“www.it315.org”
fn:join(fn:split("www,it315,org",","), ".") 的返回值为字符串“www.it315.org”
fn:indexOf函数
fn:indexOf函数返回指定字符串在一个字符串中第一次出现的索引值，返回值为int类型。fn:indexOf函数接收两个字符串类型的参数，如果第一个参数字符串中包含第二个参数字符串，那么，不管第二个参数字符串在第一个参数字符串中出现几次，fn:indexOf函数总是返回第一次出现的索引值；如果第一个参数中不包含第二个参数，则fn:indexOf函数返回-1。如果第二个参数为空字符串，则fn:indexOf函数总是返回0。
fn:indexOf函数的应用举例：
fn:indexOf("www.it315.org","t3")的返回值为5
fn:indexOf("www.it315.org","aaa")的返回值为 -1
fn:indexOf("www.it315.org","")的返回值为0
fn:contains函数
fn:contains函数检测一个字符串中是否包含指定的字符串，返回值为布尔类型。fn:contains函数在比较两个字符串是否相等时是大小写敏感的。
fn:contains函数接收两个字符串类型的参数，如果第一个参数字符串中包含第二个参数字符串，则fn:contains函数返回true，否则返回false。如果第二个参数的值为空字符串，则fn:contains函数总是返回true。实际上，fn:contains(string, substring)等价于fn:indexOf(string, substring) != -1。
fn:contains函数的应用举例：
fn:contains("www.it315.org","org")的返回值为true
fn:contains("www.it315.org","Org")的返回值为false
fn:contains("", "")的返回值为true
fn:containsIgnoreCase函数
fn:containsIgnoreCase函数检测一个字符串中是否包含指定的字符串，在比较两个字符串是否相等时大小写不敏感。fn:containsIgnoreCase函数的参数和返回值的类型都与fn:contains函数相同，只是前者在比较两个字符串是否相等时不考虑字符的大小写，而后者考虑字符的大小写，fn:containsIgnoreCase(string,substring)等价于fn:contains(fn:toUpperCase(string),fn:toUpperCase(substring))。
fn:containsIgnoreCase函数的应用举例：
fn:containsIgnoreCase("www.it315.org","Org") 的返回值为 true
fn:containsIgnoreCase (fn:toUpperCase("www.it315.org"),fn:toUpperCase("Org"))的返回值为true
fn:startsWith函数
fn:startsWith函数用于检测一个字符串是否是以指定字符串开始的，返回值为布尔类型。
fn:startsWith函数接收两个字符串类型的参数，如果第一个参数字符串以第二个参数字符串开始，则函数返回true，否则函数返回false。如果第二个参数为空字符串，则fn:startsWith函数总是返回true。实际上，fn:startsWith(string, prefix)等价于表达式fn:indexOf(string, prefix) == 0。
fn:startsWith函数的应用举例：
fn:startsWith("www.it315.org","it315")的返回值为false
fn:startsWith("www.it315.org","www")的返回值为true
fn:startsWith("www.it315.org","")的返回值为true
fn:endsWith函数
fn:endsWith函数用于检测一个字符串是否是以指定字符串结束的，返回值为布尔类型。
fn:endsWith函数接收两个字符串类型的参数，如果第一个参数字符串以第二个参数字符串结束，则函数返回true，否则函数返回false。如果第二个参数为空字符串，则fn:endsWith函数总是返回true。
fn:endsWith函数的应用举例：
fn:endsWith("www.it315.org","it315")的返回值为false
fn:endsWith("www.it315.org","org")的返回值为true
fn:endsWith("www.it315.org","")的返回值为true
fn:replace函数
fn:replace函数将一个字符串中包含的指定子字符串替换为其它的指定字符串，并返回替换后的结果字符串。fn:replace方法接收三个字符串类型的参数，第一个参数表示要操作的源字符串，第二个参数表示源字符串中要被替换的子字符串，第三个参数表示要被替换成的字符串。
fn:replace函数按照下面的说明执行字符串的替换操作：
（1）源字符串中所有的第二个参数指定的子字符串都被替换成第三个参数指定的字符串，如果替换后的结果字符串中包含第二个参数指定的子字符串，则不再进行替换。例如，
fn:replace("www it315 org", " ", ".")的返回值为字符串“www.it315.org”
fn:replace("ddabccff", "abc", "ab")的返回值为字符串“ddabcff”，这个字符串中还包含字符串“abc”，但不再执行替换操作
（2）如果第一个参数是空字符串，则fn:replace函数返回空字符串，例如，fn:replace("", " ",".")的返回值为空字符串。
（3）如果第二个参数是空字符串，则fn:replace函数不执行任何替换操作，返回第一个参数指定的字符串。例如，fn:replace("www.it315.org","", " ") 的返回值为字符串“www.it315.org”。
（4）如果第三个参数是空字符串，则fn:replace函数删除源字符串中包含的第二个参数指定的子字符串。例如，fn:replace("www.it315.org",".", "")的返回值为字符串“wwwit315org”。
fn:substring函数
fn:substring函数用于截取一个字符串的子字符串并返回截取到的子字符串。fn:substring函数接收三个参数，第一个参数是用于指定要操作的源字符串，第二个参数是用于指定截取子字符串开始的索引值，第三个参数是用于指定截取子字符串结束的索引值，第二个参数和第三个参数都是int类型，其值都从0开始。
fn:substring函数按照下面的说明截取一个字符串的子字符串：
如果第二个参数的值大于或等于源字符串中包含的字符个数，则fn:substring函数返回空字符串；
如果第二个参数的值小于0，则将其值设置为0；
如果第三个参数的值小于0或大于源字符串中包含的字符个数，则截取到源字符串的结尾的字符；
如果第三个参数的值小于第二个参数的值，则fn:substring函数返回空字符串。
fn:substring函数的应用举例（字符串“www.it315.org”中包含13个字符）：
fn:substring("www.it315.org", 4, 9) 的返回值为字符串“it315”
fn:substring("www.it315.org", 13, 14)返回空字符串
fn:substring("www.it315.org", -1, 9) 的返回值为字符串“www.it315”
fn:substring("www.it315.org", 4, -1) 的返回值为字符串“it315.org”
fn:substring("www.it315.org", 4, 13) 的返回值为字符串“it315.org”
fn:substring("www.it315.org", 4, 3) 返回空字符串
fn:substringAfter函数
fn:substringAfter函数用于截取并返回一个字符串中的指定子字符串第一次出现之后的子字符串。fn:substringAfter函数接收两个字符串类型的参数，第一个参数表示要操作的源字符串，第二个参数表示指定的子字符串，例如，fn:substringAfter("www.it315.org",".")的返回值为字符串“it315.org”。
fn:substringAfter函数按照下面的说明截取一个字符串的子字符串：
如果第一个参数是空字符串，则fn:substringAfter函数返回空字符串，例如fn:substringAfter("",".") 的返回值为空字符串；
如果第二个参数是空字符串，则fn:substringAfter函数的返回值为源字符串，例如，fn:substringAfter("www.it315.org","")的返回值为字符串“www.it315.org”；
如果第二个参数不是第一个参数的子字符串，则substringAfter函数返回空字符串，例如，fn:substringAfter("www.it315.org","itorg")的返回值为空字符串。
fn:substringBefore函数
fn:substringBefore函数用于截取并返回一个字符串中的指定子字符串第一次出现之前的子字符串。fn:substringBefore函数接收两个字符串类型的参数，第一个参数表示要操作的源字符串，第二个参数表示指定的子字符串，例如，fn:substringBefore("www.it315.org",".") 的返回值为字符串“www”。
fn:substringBefore函数按照下面的说明截取一个字符串的子字符串：
如果第一个参数是空字符串，则fn:substringBefore函数返回空字符串，例如，fn:substringBefore("",".") 的返回值为空字符串；
如果第二个参数是空字符串，则fn:substringBefore函数返回空字符串，例如，fn:substringBefore("www.it315.org","") 的返回值为空字符串
如果第二个参数不是第一个参数的子字符串，则fn:substringBefore函数返回空字符串，例如，fn:substringBefore("www.it315.org","itorg") 的返回值为空字符串。