一、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 ‘改为’