JSTL函数

JSTL函数

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") 的返回值为空字符串。