FreeMarker内置命令(字符串命令)
80183053 2011-08-17
一、substring
NOTE: 这个内置以来2.3.7 FreeMarker的存在
语法exp?substring(from,toExclusive)，也可以是exp?substring(from)
简介：一个字符串，form是第一个字符(A substring of the string.from is the index of the first character.)，它必须是一个数字，而且至少是0和小于0或者具有相 同的 toExclusive.进行截取操作的最后字符的索引，该值必须为数字，如果该 值省略，默认为从from到字符串的结束。
例：
表达式 | 输出 |
${‘abc’?substring(0)} | Abc |
${‘abc’?substring(1)} | Bc |
${‘abc’?substringf(2)} | C |
${‘abc’?substring(3)} | |
${‘abc’?substring(0,0)} | |
${‘abc’?substring(0,1)} | A |
${‘abc’?substring(0,1)} | Ab |
二、cap_first:将字符串的第一个字符或者字母(仅前几个字符是空格的情况)大写(如果第一个字符是字母);如果字符串的第一个字符不是字母(空格除外)，将按照原来字符串的格式返回;若第一个字符是字母并且是大写的情况，结果同上。
表达式 | 结果 |
${‘ green mouse’?cap_first} | Green mouse |
${‘GreEN mouse’?cap_first} | GreEN mouse |
${‘- green mouse’? cap_first} | - green mouse |
In the case of "-green mouse", thefirst word is the -.
三、uncap_first:功能和cap_first相反
四、capitalize:将一个字符串的首字母大写，其他字母全小写
表达式 | 结果 |
${ green mouse}?capitalize | Green Mouse |
${‘GreEN mouse’?capitalize} | Green Mouse |
五、chop_linebreak:如果一个字符串的末尾有换行，将换行打断；否则不变
六、date,time,datetime:将字符串转换成日期，建议提供一个参数指定格式
表达式 | 结果 |
<#assign test1 = ‘10/25/1995’?date(‘MM/ddyyyy’)>${test1} | Oct 25,1955 |
七、ends_with:判断字符串是否以指定的字符结尾，如果是返回true；否则返回false
表达式 | 结果 |
${‘read head’?ends_width(‘head’)} | true |
八、html:作为HTML标记的字符串。也就是说，所有的字符串
l <取代<
l >替换>
l &替换为&
l ＂改为＂
如果在某个字符串中存在一些HTML特色字符的话，可以使用这种方式来避免与HTML的冲突
九、groups
十、index_of:返回指定字符在字符串中第一次出现的索引。也可以指定从那个索引开始进行查找如${‘abcabc’?index_of(‘bc’,2)}将指定从索引为2的地方开始进行查找匹配字符.如果没有找到批评的字符将返回-1
表达式 | 结果 |
${‘abcabc’?index_of(‘bc’)} | 1 |
${‘abcabc’?index_of(‘bc’,2)} | 4 |
十一、 j_string:java中的转义字符
十二、 js_string: 脱JavaScript语言文字的字符串字符串的转义规则，因此它是安全的插入文本值转换为字符串。两个引号（“）和单引号- quoate（'）被转义。2.3.1起价FreeMarker的，它也逃脱 > 为“\> （ 避免 </脚本>）。此外，在所有字符的UCS 码点0x20，即JavaScript语言中没有专门的转义序列，将被替换为十六进制转义（\ x二十）。（当然，根据JavaScript语言的字符串的语法，反斜杠（\）会被转义也换行会被转义为 \ ?，...等等）
如：
<#assignuser = "Big Joe's \"right hand\"">
<script>
alert("Welcome${user?js_string}!");
</script>
将返回
<script>
alert("Welcome Big Joe\'s \"right hand\"!");</script>
十三、 last_index_of:最后一个匹配的索引
十四、 length:字符串的长度
十五、 lower_case:全部转换为小写
十六、 left_pad
十七、 right_pad
十八、 contains这个内置对象在2.3.1版本中有，但2.3版本中没有：用于判段在一个字符串是否存在指定的字符
表达式 | 结果 |
<#if ‘maple’?contains(‘ap’)>maple</#if> | maple |
十九、 matches：只能在java2平台1.4或更高版本上使用,否则将以错误来处理
使用正则进行匹配，返回的是一个序列(SimpleSequence)，序列的大小可能是0
表达式 | 结果 |
<#if "fxo"?matches("f.?o")>Matches.<#else>Does not match.</#if> | Matches. |
<#assign res = "foo bar fyo"?matches("f.?o")> <#if res>Matches.<#else>Does not match.</#if> Matching sub-strings: <#list res as m> - ${m} </#list> | Does not match. Matching sub-strings: - foo - fyo |
返回的序列不能直接通过${}输入，而应该通过<#list>进行迭代
二十、 number:将String转换为数值，这个数字必须在FTL指定的格式
二十一、 replace:它用来取代原来的字符串与另一个字符串中所有出现的字符串。它不涉及字边界
表达式 | 结果 |
${‘this is a car acarus’?replae(‘car’,’maple’)} | this is a maple amapleus |
${‘aaaa’?replace(‘aaa’,’X’)} | Xa |
${‘maple’?replce(‘’,’|’)} | |m|a|p|l|e| |
二十二、 rtf：作为富文本（RTF）字符串
l \替换\\
l {替换\{
l }替换\}
二十三、 split:”分割
分割方式可以指定为标点符号或者字符
表达式 | 结果 |
<#list ‘yangyang,do you know my heart’?split(‘,’) as m> - ${m} </#list> | -yangyang -do you know my heart |
二十四、 starts_with：以什么开始，与ends_with向对应
二十五、 string:什么也不做，只是返回的字符串原样。唯一的例外is，如果该值是一个多类型的值(例如，它是两个字符串，在同一个时间顺序)，然后将得到的值只是一个简单的字符串，而不是一个多类型的值。
二十六、 trim：去掉前后空格
二十七、 upper_case：将所有的字母转换为大写，与lower_case向对应
二十八、 word_list:返回的是一个序列，其中包含的是命令字符串中的所有字，因为他们出现在字符串中，语言是通过以“空格”为标准进行分割
表达式 | 结果 |
<#assign words = " a bcd, . 1-2-3"?word_list> <#list words as word>[${word}]</#list> | [a] [bcd,][.] [1-2-3] |
二十九、 xhtml:作为XHTML的文本字符串,类似于html
l <取代<
l >取代>
l &取代&
l “取代”
l ‘取代’
三十、 xml：作为XML文本字符串
l <取代<
l >替换>
l &替换为&
l “改为”
l ‘改为’
