XU XUv0.8.8
EN

API

#fmt

import: #fmt

counts: 14 函数, 0 方法, 1 类型, 0 常量, 0 方法集

格式化:Arg 装箱(i/s/b/f/c),sprintf/sprint/print/printf/errorf。标志 -+#0、宽度、精度;无扫描、无反射动词。

struct Arg

XuAPI
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

XuAPI
pub fn i(x int) Arg

用途

把 int 装箱为 Arg(kind=0)。

参数

x int
要装箱的整数

返回

装箱后的 Arg

s

XuAPI
pub fn s(x string) Arg

用途

把 string 装箱为 Arg(kind=1)。

参数

x string
要装箱的字符串

返回

装箱后的 Arg

b

XuAPI
pub fn b(x bool) Arg

用途

把 bool 装箱为 Arg(kind=2)。

参数

x bool
要装箱的布尔值

返回

装箱后的 Arg

f

XuAPI
pub fn f(x f64) Arg

用途

把 f64 装箱为 Arg(kind=3)。

参数

x f64
要装箱的浮点数

返回

装箱后的 Arg

c

XuAPI
pub fn c(x int) Arg

用途

把字符码(int 字节/rune)装箱为 Arg(kind=4)。

参数

x int
字符码(int)

返回

装箱后的 Arg

sprintf

XuAPI
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

XuAPI
pub fn sprintf_args(f string, args []Arg) string

用途

与 sprintf 相同,但实参是 []Arg 切片而不是可变参。

参数

f string
格式串(支持 %- + # 0 宽 精度,与本包实现一致)
args []Arg
已装箱的 Arg 切片

返回

格式化后的 string

sprint

XuAPI
pub fn sprint(args <-> Arg) string

用途

把各 Arg 默认格式化后用空格拼接成字符串,末尾不加换行。

参数

args <-> Arg
可变 Arg(用 fmt.i/s/b/f/c 装箱)

返回

拼接后的 string

sprintln

XuAPI
pub fn sprintln(args <-> Arg) string

用途

与 sprint 相同,但结果末尾加一个换行。

参数

args <-> Arg
可变 Arg(用 fmt.i/s/b/f/c 装箱)

返回

拼接后并带换行的 string

sprint_args

XuAPI
pub fn sprint_args(args []Arg) string

用途

与 sprint 相同,但实参是 []Arg 切片。

参数

args []Arg
已装箱的 Arg 切片

返回

拼接后的 string

print

XuAPI
pub fn print(args <-> Arg)

用途

把各 Arg 默认格式化后打印。经内建 println 输出,行尾带换行。

参数

args <-> Arg
可变 Arg(用 fmt.i/s/b/f/c 装箱)

println

XuAPI
pub fn println(args <-> Arg)

用途

把各 Arg 默认格式化后打印。经内建 println 输出,行尾带换行。

参数

args <-> Arg
可变 Arg(用 fmt.i/s/b/f/c 装箱)

printf

XuAPI
pub fn printf(f string, args <-> Arg)

用途

按格式串格式化后打印。经内建 println 输出,行尾带换行。格式错误时打印错误信息。

参数

f string
格式串(支持 %- + # 0 宽 精度,与本包实现一致)
args <-> Arg
可变 Arg(用 fmt.i/s/b/f/c 装箱)

errorf

XuAPI
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 为格式化结果