【Android技巧之相见恨晚系列】-TextView/string.xml冷门小技巧:占位转换符%1$s、%1$d等的用法

技巧比较冷门,我今天用到才了解到,以前都没接触过。。。然而却发现这是很早就已经有的技巧。。。

引子:

如果一段文字需要多段TextView拼接而成,比如:“我叫XXX,今年XX岁了,身高X.X米”。
拿到这样的需求可能我们第一反应就是StringBuilder的append(也许是因为我比较low的原因).然而这次需求是在PreferenceFragment 中监听preference的变化动态设置该preference的summary,此时要求的时效性比较高,用append拼那么多行,总感觉有些消耗,所以在搜寻有没有其他的办法来实现,果不其然,发现之后回头看看自己的代码简直low爆了。。。

这里可以考虑用另外一种方法实现:引用string.xml文件中占位转换符来完成string的format来实现。

Usage:

1.在string.xml中先定义好格式:

<string name="hello">String.xml占位转换符:我叫%1$s,今年%2$d岁了,身高%3$f米。</string>

2.代码中这样实现

TextView tv=(TextView)findViewById(R.id.textView);
String format = getResources().getString(R.string.hello);  
String result= String.format(format ,"[Android]" , 7 , 7.0);//对应xml中定义的123顺序
Log.e("tag", result);
tv.setText(result);

输出结果如下:

String.xml字符转义拼接: 我叫[Android],今年7岁了,身高7.000000米.

Holly Crap! That's what I'm talking about.
优雅度甩开以前的"append append"几个星球。

所以我接下来对占位转换符稍微研究了一下,这里我只是稍微总结一下,相当于做笔记而已,毕竟资料都是零散的。不是自己的博文,老鸟轻喷啊。。。

首先要从Java里String的format()说起:

一、常规类型的格式化

String类的format()方法用于创建格式化的字符串以及连接多个字符串对象。熟悉C语言的同学应该记得C语言的sprintf()方法,两者有类似之处。format()方法有两种重载形式。

  • format(String format, Object... args) 新字符串使用本地语言环境,制定字符串格式和参数生成格式化的新字符串。
  • format(Locale locale, String format, Object... args) 使用指定的语言环境,制定字符串格式和参数生成格式化的字符串。
    源码如下:
/**
 * Returns a localized formatted string, using the supplied format and arguments,
 * using the user's default locale.
 *
 * <p>If you're formatting a string other than for human
 * consumption, you should use the {@code format(Locale, String, Object...)}
 * overload and supply {@code Locale.US}. See
 * "<a href="../util/Locale.html#default_locale">Be wary of the default locale</a>".
 *
 * @param format the format string (see {@link java.util.Formatter#format})
 * @param args
 *            the list of arguments passed to the formatter. If there are
 *            more arguments than required by {@code format},
 *            additional arguments are ignored.
 * @return the formatted string.
 * @throws NullPointerException if {@code format == null}
 * @throws java.util.IllegalFormatException
 *             if the format is invalid.
 * @since 1.5
 */
public static String format(String format, Object... args) {
    return format(Locale.getDefault(), format, args);
}

/**
 * Returns a formatted string, using the supplied format and arguments,
 * localized to the given locale.
 *
 * @param locale
 *            the locale to apply; {@code null} value means no localization.
 * @param format the format string (see {@link java.util.Formatter#format})
 * @param args
 *            the list of arguments passed to the formatter. If there are
 *            more arguments than required by {@code format},
 *            additional arguments are ignored.
 * @return the formatted string.
 * @throws NullPointerException if {@code format == null}
 * @throws java.util.IllegalFormatException
 *             if the format is invalid.
 * @since 1.5
 */
public static String format(Locale locale, String format, Object... args) {
    if (format == null) {
        throw new NullPointerException("format == null");
    }
    int bufferSize = format.length() + (args == null ? 0 : args.length * 10);
    Formatter f = new Formatter(new StringBuilder(bufferSize), locale);
    return f.format(format, args).toString();
}
不同转换符实现不同数据类型到字符串的转换
转 换 符 说 明 示 例
%s 字符串类型 "mingrisoft"
%c 字符类型 'm'
%b 布尔类型 true
%d 整数类型(十进制) 99
%x 整数类型(十六进制) FF
%o 整数类型(八进制) 77
%f 浮点类型 99.99
%a 十六进制浮点类型 FF.35AE
%e 指数类型 9.38e+5
%g 通用浮点类型(f和e类型中较短的) ——
%h 散列码 ——
%% 百分比类型
%n 换行符 ——
%tx 日期与时间类型(x代表不同的日期与时间转换符) ——

测试用例

public static void main(String[] args) {
    String str=null;
    str=String.format("Hi,%s", "王力");
    System.out.println(str);
    str=String.format("Hi,%s:%s.%s", "王南","王力","王张");          
    System.out.println(str);                         
    System.out.printf("字母a的大写是:%c %n", 'A');
    System.out.printf("3>7的结果是:%b %n", 3>7);
    System.out.printf("100的一半是:%d %n", 100/2);
    System.out.printf("100的16进制数是:%x %n", 100);
    System.out.printf("100的8进制数是:%o %n", 100);
    System.out.printf("50元的书打8.5折扣是:%f 元%n", 50*0.85);
    System.out.printf("上面价格的16进制数是:%a %n", 50*0.85);
    System.out.printf("上面价格的指数表示:%e %n", 50*0.85);
    System.out.printf("上面价格的指数和浮点数结果的长度较短的是:%g %n", 50*0.85);
    System.out.printf("上面的折扣是%d%% %n", 85);
    System.out.printf("字母A的散列码是:%h %n", 'A');
}

输出结果

Hi,王力
Hi,王南:王力.王张
字母a的大写是:A
3>7的结果是:false
100的一半是:50
100的16进制数是:64
100的8进制数是:144
50元的书打8.5折扣是:42.500000 元
上面价格的16进制数是:0x1.54p5
上面价格的指数表示:4.250000e+01
上面价格的指数和浮点数结果的长度较短的是:42.5000
上面的折扣是85%
字母A的散列码是:41

[%n起换行作用]

搭配转换符的标志
标 志 说 明 示 例 结 果
+ 为正数或者负数添加符号 ("%+d",15) +15
左对齐 ("%-5d",15) ¦15 ¦
0 数字前面补0 ("%04d", 99) 0099
空格 在整数之前添加指定数量的空
("% 4d", 99) ¦ 99¦
, 以","对数字分组 ("%,f", 9999.99) 9,999.990000
( 使用括号包含负数 ("%(f", -99.99) (99.990000)
# 如果是浮点数则包含小数点
如果是16进制或8进制
则添加0x或0
("%#x", 99)
("%#o", 99)
0x63
0143
< 格式化前一个转换符所描述的
参数
("%f和%<3.2f", 99.45) 99.450000
和99.45
$ 被格式化的参数索引 ("%1$d,%2$s", 99,"abc") 99,abc

测试用例

public static void main(String[] args) {
    String str=null;
    //$使用
    str=String.format("格式参数$的使用:%1$d,%2$s", 99,"abc");           
    System.out.println(str);                     
    //+使用
    System.out.printf("显示正负数的符号:%+d与%d%n", 99,-99);
    //补O使用
    System.out.printf("最牛的编号是:%03d%n", 7);
    //空格使用
    System.out.printf("Tab键的效果是:% 8d%n", 7);
    //.使用
    System.out.printf("整数分组的效果是:%,d%n", 9989997);
    //空格和小数点后面个数
    System.out.printf("一本书的价格是:% 50.5f元%n", 49.8);
}

输出结果

格式参数$的使用:99,abc
显示正负数的符号:+99与-99
最牛的编号是:007
Tab键的效果是: 7
整数分组的效果是:9,989,997
一本书的价格是: 49.80000元

二、日期和事件字符串格式化

在程序界面中经常需要显示时间和日期,但是其显示的 格式经常不尽人意,需要编写大量的代码经过各种算法才得到理想的日期与时间格式。字符串格式中还有%tx转换符没有详细介绍,它是专门用来格式化日期和时 间的。%tx转换符中的x代表另外的处理日期和时间格式的转换符,它们的组合能够将日期和时间格式化成多种格式。

常见日期和时间组合的格式转换符:
转 换 符 说 明 示 例
c 包括全部日期和时间信息 星期六 十月 27 14:21:20 CST 2007
F “年-月-日”格式 2007-10-27
D “月/日/年”格式 10/27/07
r “HH:MM:SS PM”格式(12时制) 02:25:51 下午
T “HH:MM:SS”格式(24时制) 14:28:16
R “HH:MM”格式(24时制) 14:28

测试用例

    public static void main(String[] args) {
        Date date=new Date();                                
        //c的使用
        System.out.printf("全部日期和时间信息:%tc%n",date);        
        //f的使用
        System.out.printf("年-月-日格式:%tF%n",date);
        //d的使用
        System.out.printf("月/日/年格式:%tD%n",date);
        //r的使用
        System.out.printf("HH:MM:SS PM格式(12时制):%tr%n",date);
        //t的使用
        System.out.printf("HH:MM:SS格式(24时制):%tT%n",date);
        //R的使用
        System.out.printf("HH:MM格式(24时制):%tR",date);
    }

输出结果

全部日期和时间信息:星期一 九月 10 10:43:36 CST 2012
年-月-日格式:2012-09-10
月/日/年格式:09/10/12
HH:MM:SS PM格式(12时制):10:43:36 上午
HH:MM:SS格式(24时制):10:43:36
HH:MM格式(24时制):10:43

定义日期格式的转换符可以使日期通过指定的转换符生成新字符串。这些日期转换符如图所示。

    public static void main(String[] args) {
        Date date=new Date();                                    
        //b的使用,月份简称
        String str=String.format(Locale.US,"英文月份简称:%tb",date);     
        System.out.println(str);                                                                            
        System.out.printf("本地月份简称:%tb%n",date);
        //B的使用,月份全称
        str=String.format(Locale.US,"英文月份全称:%tB",date);
        System.out.println(str);
        System.out.printf("本地月份全称:%tB%n",date);
        //a的使用,星期简称
        str=String.format(Locale.US,"英文星期的简称:%ta",date);
        System.out.println(str);
        //A的使用,星期全称
        System.out.printf("本地星期的简称:%tA%n",date);
        //C的使用,年前两位
        System.out.printf("年的前两位数字(不足两位前面补0):%tC%n",date);
        //y的使用,年后两位
        System.out.printf("年的后两位数字(不足两位前面补0):%ty%n",date);
        //j的使用,一年的天数
        System.out.printf("一年中的天数(即年的第几天):%tj%n",date);
        //m的使用,月份
        System.out.printf("两位数字的月份(不足两位前面补0):%tm%n",date);
        //d的使用,日(二位,不够补零)
        System.out.printf("两位数字的日(不足两位前面补0):%td%n",date);
        //e的使用,日(一位不补零)
        System.out.printf("月份的日(前面不补0):%te",date);
    }

输出结果

英文月份简称:Sep
本地月份简称:九月
英文月份全称:September
本地月份全称:九月
英文星期的简称:Mon
本地星期的简称:星期一
年的前两位数字(不足两位前面补0):20
年的后两位数字(不足两位前面补0):12
一年中的天数(即年的第几天):254
两位数字的月份(不足两位前面补0):09
两位数字的日(不足两位前面补0):10
月份的日(前面不补0):10

和日期格式转换符相比,时间格式的转换符要更多、更精确。它可以将时间格式化成时、分、秒甚至时毫秒等单位。

时间字符串的转换符
转 换 符 说 明 示 例
H 2位数字24时制的小时(不足2位前面补0) 15
I 2位数字12时制的小时(不足2位前面补0) 03
k 2位数字24时制的小时(前面不补0) 15
l 2位数字12时制的小时(前面不补0) 3
M 2位数字的分钟(不足2位前面补0) 03
S 2位数字的秒(不足2位前面补0) 09
L 3位数字的毫秒(不足3位前面补0) 015
N 9位数字的毫秒数(不足9位前面补0) 562000000
p 小写字母的上午或下午标记 中:下午
英:pm
z 相对于GMT的RFC822时区的偏移量 +0800
Z 时区缩写字符串 CST
s 1970-1-1 00:00:00 到现在所经过的秒数 1193468128
Q 1970-1-1 00:00:00 到现在所经过的毫秒数 1193468128984

测试代码

public static void main(String[] args) {
    Date date = new Date();
    //H的使用
    System.out.printf("2位数字24时制的小时(不足2位前面补0):%tH%n", date);
    //I的使用
    System.out.printf("2位数字12时制的小时(不足2位前面补0):%tI%n", date);
    //k的使用
    System.out.printf("2位数字24时制的小时(前面不补0):%tk%n", date);
    //l的使用
    System.out.printf("2位数字12时制的小时(前面不补0):%tl%n", date);
    //M的使用
    System.out.printf("2位数字的分钟(不足2位前面补0):%tM%n", date);
    //S的使用
    System.out.printf("2位数字的秒(不足2位前面补0):%tS%n", date);
    //L的使用
    System.out.printf("3位数字的毫秒(不足3位前面补0):%tL%n", date);
    //N的使用
    System.out.printf("9位数字的毫秒数(不足9位前面补0):%tN%n", date);
    //p的使用
    String str = String.format(Locale.US, "小写字母的上午或下午标记(英):%tp", date);
    System.out.println(str); 
    System.out.printf("小写字母的上午或下午标记(中):%tp%n", date);
    //z的使用
    System.out.printf("相对于GMT的RFC822时区的偏移量:%tz%n", date);
    //Z的使用
    System.out.printf("时区缩写字符串:%tZ%n", date);
    //s的使用
    System.out.printf("1970-1-1 00:00:00 到现在所经过的秒数:%ts%n", date);
    //Q的使用
    System.out.printf("1970-1-1 00:00:00 到现在所经过的毫秒数:%tQ%n", date);
}

输出结果

2位数字24时制的小时(不足2位前面补0):11
2位数字12时制的小时(不足2位前面补0):11
2位数字24时制的小时(前面不补0):11
2位数字12时制的小时(前面不补0):11
2位数字的分钟(不足2位前面补0):03
2位数字的秒(不足2位前面补0):52
3位数字的毫秒(不足3位前面补0):773
9位数字的毫秒数(不足9位前面补0):773000000
小写字母的上午或下午标记(英):am
小写字母的上午或下午标记(中):上午
相对于GMT的RFC822时区的偏移量:+0800
时区缩写字符串:CST
1970-1-1 00:00:00 到现在所经过的秒数:1347246232
1970-1-1 00:00:00 到现在所经过的毫秒数:1347246232773


以上是Java语言里本身就已经对String这个类做好了format的API开放出来,可以给开发者自由使用。更详细的说明,可以参考源码里Formater的注释,有兴趣可以深入研究。
此处放一张缩略图:

Java Formatter 类注释缩影图 [解注后就成了一个html]

这算是Java里基本的知识吧,现在用到算是mark一下。。。

然后在Android里使用,可以配合spannable做一些高级的文字展示了

暂时先写到这。。。有空回头再完善

另外markdown怎么作页面内跳转,希望markdown高手指教一下,网上搜到用<span>标签的方法仍然没效果。。。按道理是可以的,先放书签,然后做个超链跳书签,试了一下并没有用


参考文献:
首先收藏一个HTML特殊转义字符对照表,文章中多处不能转义的地方都亏了它
HTML特殊转义字符对照表
文章中的那些个表格和示例都是摘自这里,用markdown改了下格式:
JAVA字符串格式化-String.format()的使用
这里介绍了个新奇特<xliff:g>,没有尝试过,我觉得就用%1$s、%1$d这种好:
android中string.xml中%1$s、%1$d等的用法
然后最开始其实是看的这篇文章,里面是有毒的。。。
Android string.xml文件中整型和string型代替以及特殊转义符
文章中说

特别注意:
在string.xml中无法直接写成 %d,%s,%f 等这类格式化符号,必须在中间加个转义符"$",而不是平时常用的转义符""

实际上并不是这个原理。。。可以看到前文里介绍了$符是表示多个转换符在一起时起到参数索引作用。

写在最后

我在简书也就是个无脑马克流,经常留言后有人问我头像。。。好吧,我现在就放出来吧。


}EOLWOC8884ZT{0KSJ{VYQ7.gif

推荐阅读更多精彩内容

  • longaaaa =14200666; Console.WriteLine(aaaa.ToString("N0")...
    鱼落于天阅读 396评论 0 1
  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 119,234评论 16 133
  • 第5章 引用类型(返回首页) 本章内容 使用对象 创建并操作数组 理解基本的JavaScript类型 使用基本类型...
    大学一百阅读 1,515评论 0 4
  • 熊志军~【日精进打卡第407天】 6月26号卡 付达新商贸~众德营销 沈阳盛和塾道盛组/稻芽七组 【知~学习】 诵...
    熊志军阅读 44评论 0 0
  • 周日,一大早,我和我十多位小伙伴一起出发去图书馆,在路上我们一起聊天,一起唱歌,无比的愉悦。到了图书馆后和一位大哥...
    吨吨儿阅读 1,504评论 8 8