XU XUv0.8.8
EN

API

#testing

import: #testing

counts: 4 函数, 22 方法, 2 类型, 0 常量, 0 方法集

T：error/fatal/skip/run 与 *f 格式化。cleanup LIFO。非测试构建不能 import。

struct T

XuAPI
pub struct T {
    pub failed int
    pub skipped int
    pub name string
    pub cleanups []fn()
}

用途

`testing` 常用面（蛇形）。套具是语言层 `fn test_*` / `xu test`，不是本包。 测试体里 `mut t := testing.t`。errorf 软失败（harness 在返回后记 FAIL）； fatalf / fail_now 走 assert → --test 下 longjmp。skip_now 走 test_skip。

参数

failed int
字段（int）
skipped int
字段（int）
name string
名字
cleanups []fn()
字段（[]fn()）

t

XuAPI
pub fn t() T

用途

t，返回 T。

参数

无

返回

T — 该类型的值

t_named

XuAPI
pub fn t_named(name string) T

用途

tnamed。

参数

name string
名字（string）

返回

T — 该类型的值

(T) name

XuAPI
pub fn (t T) name() string

用途

`T` 上的方法：名称。

参数

t T
接收者 T（值接收者）

返回

string — 结果字符串

(T) helper

XuAPI
pub fn (t T) helper()

用途

在 `T` 上调用 `helper`。

参数

t T
接收者 T（值接收者）

(T) failed

XuAPI
pub fn (t T) failed() bool

用途

在 `T` 上调用 `failed`。

参数

t T
接收者 T（值接收者）

返回

bool — 是否成立

(T) skipped

XuAPI
pub fn (t T) skipped() bool

用途

在 `T` 上调用 `skipped`。

参数

t T
接收者 T（值接收者）

返回

bool — 是否成立

(&mut T) log

XuAPI
pub fn (t &mut T) log(msg &string)

用途

`&mut T` 上的方法：自然对数。

参数

t &mut T
接收者 &mut T（可变借用）
msg &string
消息（借用，调用方仍持有；类型 &string）

(&mut T) logf

XuAPI
pub fn (t &mut T) logf(f string, args <-> fmt.Arg)

用途

在 `&mut T` 上调用 `logf`。

参数

t &mut T
接收者 &mut T（可变借用）
f string
回调或格式串（string）
args <-> fmt.Arg
可变参数，类型 fmt.Arg，在函数体内是 []fmt.Arg

(&mut T) fail

XuAPI
pub fn (t &mut T) fail()

用途

`&mut T` 上的方法：失败。

参数

t &mut T
接收者 &mut T（可变借用）

(&mut T) error

XuAPI
pub fn (t &mut T) error(msg &string)

用途

`&mut T` 上的方法：错误。

参数

t &mut T
接收者 &mut T（可变借用）
msg &string
消息（借用，调用方仍持有；类型 &string）

(&mut T) errorf

XuAPI
pub fn (t &mut T) errorf(f string, args <-> fmt.Arg)

用途

`&mut T` 上的方法：按格式串构造错误。

参数

t &mut T
接收者 &mut T（可变借用）
f string
回调或格式串（string）
args <-> fmt.Arg
可变参数，类型 fmt.Arg，在函数体内是 []fmt.Arg

(&mut T) fail_now

XuAPI
pub fn (t &mut T) fail_now()

用途

`&mut T` 上的方法：失败当前时间。

参数

t &mut T
接收者 &mut T（可变借用）

(&mut T) fatal

XuAPI
pub fn (t &mut T) fatal(msg &string)

用途

`&mut T` 上的方法：打印后退出。

参数

t &mut T
接收者 &mut T（可变借用）
msg &string
消息（借用，调用方仍持有；类型 &string）

(&mut T) fatalf

XuAPI
pub fn (t &mut T) fatalf(f string, args <-> fmt.Arg)

用途

在 `&mut T` 上调用 `fatalf`。

参数

t &mut T
接收者 &mut T（可变借用）
f string
回调或格式串（string）
args <-> fmt.Arg
可变参数，类型 fmt.Arg，在函数体内是 []fmt.Arg

(&mut T) skip_now

XuAPI
pub fn (t &mut T) skip_now()

用途

`&mut T` 上的方法：跳过当前时间。

参数

t &mut T
接收者 &mut T（可变借用）

(&mut T) skip

XuAPI
pub fn (t &mut T) skip(msg &string)

用途

`&mut T` 上的方法：跳过。

参数

t &mut T
接收者 &mut T（可变借用）
msg &string
消息（借用，调用方仍持有；类型 &string）

(&mut T) skipf

XuAPI
pub fn (t &mut T) skipf(f string, args <-> fmt.Arg)

用途

在 `&mut T` 上调用 `skipf`。

参数

t &mut T
接收者 &mut T（可变借用）
f string
回调或格式串（string）
args <-> fmt.Arg
可变参数，类型 fmt.Arg，在函数体内是 []fmt.Arg

(&mut T) cleanup

XuAPI
pub fn (t &mut T) cleanup(f fn())

用途

`&mut T` 上的方法：清理回调。

参数

t &mut T
接收者 &mut T（可变借用）
f fn()
字节回调：参数为字节值 0..255，返回是否命中

(&mut T) run_cleanup

XuAPI
pub fn (t &mut T) run_cleanup()

用途

`&mut T` 上的方法：运行清理回调。

参数

t &mut T
接收者 &mut T（可变借用）

(T) run

XuAPI
pub fn (t T) run(name string) T

用途

返回子 T（不吃闭包：函数类型写不出 `mut &T`）。子测试 fail_now/skip_now 仍走同一 jmpbuf。

参数

t T
接收者 T（值接收者）
name string
名字（string）

返回

T — 该类型的值

short

XuAPI
pub fn short() bool

用途

short，返回 bool。

参数

无

返回

bool — 是否成立

struct B

XuAPI
pub struct B {
    pub n int
    pub failed int
    pub name string
}

用途

公开结构体 `B`。

参数

n int
数量、长度或上限
failed int
字段（int）
name string
名字

b

XuAPI
pub fn b(n int) B

用途

b，返回 B。

参数

n int
数量、长度或上限（int）

返回

B — 该类型的值

(&mut B) fail

XuAPI
pub fn (b &mut B) fail()

用途

`&mut B` 上的方法：失败。

参数

b &mut B
接收者 &mut B（可变借用）

(&mut B) errorf

XuAPI
pub fn (b &mut B) errorf(f string, args <-> fmt.Arg)

用途

`&mut B` 上的方法：按格式串构造错误。

参数

b &mut B
接收者 &mut B（可变借用）
f string
回调或格式串（string）
args <-> fmt.Arg
可变参数，类型 fmt.Arg，在函数体内是 []fmt.Arg

(&mut B) fatalf

XuAPI
pub fn (b &mut B) fatalf(f string, args <-> fmt.Arg)

用途

在 `&mut B` 上调用 `fatalf`。

参数

b &mut B
接收者 &mut B（可变借用）
f string
回调或格式串（string）
args <-> fmt.Arg
可变参数，类型 fmt.Arg，在函数体内是 []fmt.Arg

(B) failed

XuAPI
pub fn (b B) failed() bool

用途

在 `B` 上调用 `failed`。

参数

b B
接收者 B（值接收者）

返回

bool — 是否成立