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

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

时间字符串的转换符
 
转 换 符说 明示 例
H2位数字24时制的小时(不足2位前面补0)15
I2位数字12时制的小时(不足2位前面补0)03
k2位数字24时制的小时(前面不补0)15
l2位数字12时制的小时(前面不补0)3
M2位数字的分钟(不足2位前面补0)03
S2位数字的秒(不足2位前面补0)09
L3位数字的毫秒(不足3位前面补0)015
N9位数字的毫秒数(不足9位前面补0)562000000
p小写字母的上午或下午标记中:下午
英:pm
z相对于GMT的RFC822时区的偏移量+0800
Z时区缩写字符串CST
s1970-1-1 00:00:00 到现在所经过的秒数1193468128
Q1970-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 等这类格式化符号,必须在中间加个转义符"$",而不是平时常用的转义符"\"

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



作者:捡淑
链接:http://www.jianshu.com/p/e9fd92fd0951
來源:简书
著作权归作者所有。商业转载请联系作者获得授权,非商业转载请注明出处。
  • 0
    点赞
  • 3
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
E/AndroidRuntime: FATAL EXCEPTION: Thread-3 Process: com.example.zfang.course2_1, PID: 31755 android.view.ViewRootImpl$CalledFromWrongThreadException: Only the original thread that created a view hierarchy can touch its views. at android.view.ViewRootImpl.checkThread(ViewRootImpl.java:6855) at android.view.ViewRootImpl.invalidateChildInParent(ViewRootImpl.java:1075) at android.view.ViewGroup.invalidateChild(ViewGroup.java:5242) at android.view.View.invalidateInternal(View.java:13574) at android.view.View.invalidate(View.java:13538) at android.view.View.invalidate(View.java:13522) at android.widget.TextView.checkForRelayout(TextView.java:7354) at android.widget.TextView.setText(TextView.java:4479) at android.widget.TextView.setText(TextView.java:4336) at android.widget.TextView.setText(TextView.java:4311) at com.example.zfang.course2_1.fragment.MineFragment$1$1.showProgress(MineFragment.java:89) at com.example.zfang.course2_1.service.DownloadService$1.run(DownloadService.java:86) at java.lang.Thread.run(Thread.java:761) D/EGL_emulation: eglMakeCurrent: 0xa9d850c0: ver 2 0 (tinfo 0xa9d831d0) D/OpenGLRenderer: endAllActiveAnimators on 0x8c994500 (RippleDrawable) with handle 0xa9dff550 W/System.err: java.net.SocketTimeoutException: connect timed out W/System.err: at java.net.PlainSocketImpl.socketConnect(Native Method) W/System.err: at java.net.AbstractPlainSocketImpl.doConnect(AbstractPlainSocketImpl.java:334) W/System.err: at java.net.AbstractPlainSocketImpl.connectToAddress(AbstractPlainSocketImpl.java:196) W/System.err: at java.net.AbstractPlainSocketImpl.connect(AbstractPlainSocketImpl.java:178) W/System.err: at java.net.SocksSocketImpl.connect(SocksSocketImpl.java:356) W/System.err: at java.net.Socket.connect(Socket.java:586) W/System.err: at com.android.okhttp.internal.Platform.connectSocket(Platform.java:113) W/System.err:
06-12

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值