跳转到内容

关键字参考

语言参考Zig 0.17.0官方原文
关键字 说明
addrspace
addrspace 关键字。
  • 待补充:addrspace 文档
align
align 可以指定指针对齐要求,也可以放在变量或函数声明之后,指定指向该变量或函数的指针的对齐要求。
allowzero
指针属性 allowzero 允许指针地址为零。
and
布尔运算符 and。
anyframe
anyframe 可以作为保存函数帧指针的变量类型。
anytype
函数参数可以使用 anytype 代替类型,实际类型在函数调用时推导。
asm
asm 开始一个内联汇编表达式,允许直接控制编译生成的机器码。
break
break 可以结合块标签从块中返回值,也可以在迭代自然完成之前退出循环。
callconv
callconv 可以指定函数类型的调用约定。
catch
如果 catch 之前的表达式求值为错误,就可以使用它求值后面的表达式。catch 后的表达式可以选择捕获错误值。
comptime
在声明前使用 comptime,可以将变量或函数参数标记为编译时已知;也可以保证表达式在编译时执行。
const
const 声明不可修改的变量。用作指针属性时,表示指针引用的值不可修改。
continue
continue 可以在循环中跳回循环开头。
defer
控制流离开当前块时,defer 会执行一个表达式。
else
else 可以为 if、switch、while 和 for 表达式提供备用分支。
  • 用于 if 表达式之后时,如果测试值为 false、null 或错误,就执行 else 分支。
  • 用于 switch 表达式内部时,如果测试值未匹配其他任何情况,就执行 else 分支。
  • 用于循环表达式之后时,如果循环没有通过 break 提前退出而是正常结束,就执行 else 分支。
  • 另见 if、switch、while、for
enum
enum 定义枚举类型。
errdefer
当函数返回错误且控制流离开当前块时,errdefer 会执行一个表达式。
error
error 定义错误类型。
export
export 使函数或变量在生成的目标文件中对外可见。导出函数默认采用 C 调用约定。
extern
extern 可以声明函数或变量;静态链接时在链接阶段解析,动态链接时在运行时解析。
fn
fn 声明函数。
for
for 表达式可用于遍历切片、数组或元组中的元素。
if
if 表达式可以检查布尔表达式、可选值或错误联合。对于可选值与错误联合,if 表达式可以捕获解包后的值。
  • 另见 if
inline
inline 可以标记循环表达式,使其在编译时展开;也可以强制函数在所有调用点内联。
linksection
linksection 关键字可以指定函数或全局变量应放入的节,例如 .text。
noalias
noalias 关键字。
  • 待补充:noalias 文档
noinline
noinline 禁止函数在任何调用点内联。
nosuspend
nosuspend 关键字可用于块、语句或表达式之前,标记一个不会到达挂起点的作用域。具体而言,在 nosuspend 作用域内:
  • 使用 suspend 关键字会产生编译错误。
  • 对尚未完成的函数帧使用 await,会引发带安全检查的非法行为。
  • 调用异步函数可能导致带安全检查的非法行为,因为它等价于包含 await 的 await async some_async_fn()。
nosuspend 作用域内的代码不会使外围函数变为异步函数。
opaque
opaque 定义不透明类型。
or
布尔运算符 or。
orelse
如果 orelse 之前的表达式求值为 null,就使用它求值后面的表达式。
packed
结构体定义之前的 packed 关键字,将其内存布局改为有明确保证的 packed 布局。
pub
顶层声明前的 pub 使其他文件可以引用该声明。
resume
resume 从函数此前挂起的位置继续执行函数帧。
return
return 退出函数并返回一个值。
struct
struct 定义结构体。
suspend
suspend 使控制流返回函数调用点或恢复者。也可以在函数内的块前使用 suspend,使函数在控制流返回调用点之前访问自己的函数帧。
switch
switch 表达式可检查同一种公共类型的值。switch 匹配项可以捕获标记联合的字段值。
test
test 关键字表示顶层代码块,用于确保行为符合预期。
threadlocal
threadlocal 可以将变量指定为线程局部变量。
try
try 对错误联合表达式求值。如果为错误,就从当前函数返回同一个错误;否则表达式结果为解包后的值。
union
union 定义联合。
unreachable
unreachable 可以断言控制流永远不会到达某个特定位置。根据构建模式,unreachable 可能触发 panic。
var
var 声明可修改的变量。
volatile
volatile 可以表示通过指针进行的读取或写入具有副作用;也可以修饰内联汇编表达式,表示该表达式具有副作用。
while
while 表达式可以反复检查布尔、可选值或错误联合表达式;分别在表达式求值为 false、null 或错误时停止循环。