API
#fmt
Xu 0.8.8 API
import: #fmt
counts: 14 函数, 0 方法, 1 类型, 0 常量, 0 方法集
格式化:Arg 装箱(i/s/b/f/c),sprintf/sprint/print/printf/errorf。标志 -+#0、宽度、精度;无扫描、无反射动词。
struct Arg
pub struct Arg {
pub kind int
pub iv int
pub sv string
pub bv bool
pub fv f64
}
用途
格式化实参的装箱结构。kind 区分载荷:0 int、1 string、2 bool、3 f64、4 字节/字符。
参数
kind int- 载荷标签:0 int / 1 string / 2 bool / 3 f64 / 4 字符
iv int- 整数或字符码(kind 0 或 4)
sv string- 字符串载荷(kind 1)
bv bool- 布尔载荷(kind 2)
fv f64- 浮点载荷(kind 3)
i
用途
把 int 装箱为 Arg(kind=0)。
参数
x int- 要装箱的整数
返回
装箱后的 Arg
s
用途
把 string 装箱为 Arg(kind=1)。
参数
x string- 要装箱的字符串
返回
装箱后的 Arg
b
用途
把 bool 装箱为 Arg(kind=2)。
参数
x bool- 要装箱的布尔值
返回
装箱后的 Arg
f
用途
把 f64 装箱为 Arg(kind=3)。
参数
x f64- 要装箱的浮点数
返回
装箱后的 Arg
c
用途
把字符码(int 字节/rune)装箱为 Arg(kind=4)。
参数
x int- 字符码(int)
返回
装箱后的 Arg
sprintf
pub fn sprintf(f string, args <-> Arg) string
用途
按格式串组装字符串。支持标志 - + # 0 与空格、宽度、精度(* 会再吃一个 int Arg)。动词含 %v %s %d %b %o %x %X %c %q %f %g 以及 %%。未写精度的 %f/%g/%v 用最短十进制。
参数
f string- 格式串(支持 %- + # 0 宽 精度,与本包实现一致)
args <-> Arg- 可变 Arg(用 fmt.i/s/b/f/c 装箱)
返回
格式化后的 string
sprintf_args
pub fn sprintf_args(f string, args []Arg) string
用途
与 sprintf 相同,但实参是 []Arg 切片而不是可变参。
参数
f string- 格式串(支持 %- + # 0 宽 精度,与本包实现一致)
args []Arg- 已装箱的 Arg 切片
返回
格式化后的 string
sprint
pub fn sprint(args <-> Arg) string
用途
把各 Arg 默认格式化后用空格拼接成字符串,末尾不加换行。
参数
args <-> Arg- 可变 Arg(用 fmt.i/s/b/f/c 装箱)
返回
拼接后的 string
sprintln
pub fn sprintln(args <-> Arg) string
用途
与 sprint 相同,但结果末尾加一个换行。
参数
args <-> Arg- 可变 Arg(用 fmt.i/s/b/f/c 装箱)
返回
拼接后并带换行的 string
sprint_args
pub fn sprint_args(args []Arg) string
用途
与 sprint 相同,但实参是 []Arg 切片。
参数
args []Arg- 已装箱的 Arg 切片
返回
拼接后的 string
print
pub fn print(args <-> Arg)
用途
把各 Arg 默认格式化后打印。经内建 println 输出,行尾带换行。
参数
args <-> Arg- 可变 Arg(用 fmt.i/s/b/f/c 装箱)
println
pub fn println(args <-> Arg)
用途
把各 Arg 默认格式化后打印。经内建 println 输出,行尾带换行。
参数
args <-> Arg- 可变 Arg(用 fmt.i/s/b/f/c 装箱)
printf
pub fn printf(f string, args <-> Arg)
用途
按格式串格式化后打印。经内建 println 输出,行尾带换行。格式错误时打印错误信息。
参数
f string- 格式串(支持 %- + # 0 宽 精度,与本包实现一致)
args <-> Arg- 可变 Arg(用 fmt.i/s/b/f/c 装箱)
errorf
pub fn errorf(f string, args <-> Arg) errors.StrErr
用途
按格式串组装字符串,并包成 errors.StrErr。
参数
f string- 格式串(支持 %- + # 0 宽 精度,与本包实现一致)
args <-> Arg- 可变 Arg(用 fmt.i/s/b/f/c 装箱)
返回
errors.StrErr,message 为格式化结果