第6章 项

译文 · 基于 The Rust Reference

原文链接: https://doc.rust-lang.org/reference/items.html

r[items]

项

r[items.syntax]

Item ->
    OuterAttribute* ( VisItem | MacroItem )

VisItem ->
    Visibility?
    (
        Module
      | ExternCrate
      | UseDeclaration
      | Function
      | TypeAlias
      | Struct
      | Enumeration
      | Union
      | ConstantItem
      | StaticItem
      | Trait
      | Implementation
      | ExternBlock
    )

MacroItem ->
      MacroInvocationSemi
    | MacroRulesDefinition

r[items.intro] 项（item）是 crate 的组成部分。项通过嵌套的[模块]集合组织在 crate 中。每个 crate 都有一个最外层的匿名模块；crate 中的所有其他项都在该 crate 的模块树中拥有[路径]。

r[items.static-def] 项完全在编译期确定，执行期间通常保持不变，并且可以驻留在只读内存中。

r[items.kinds] 项有若干种类：

• 模块
• extern crate 声明
• use 声明
• 函数定义
• 类型别名定义
• 结构体定义
• 枚举定义
• 联合体定义
• 常量项
• 静态项
• trait 定义
• 实现
• extern 块

r[items.locations] 项可以在 crate 根、模块 或块表达式中声明。

r[items.associated-locations] 一部分项称为关联项，可以在 trait 和实现中声明。

r[items.extern-locations] 一部分项称为外部项，可以在 extern 块中声明。

r[items.decl-order] 项可以按任意顺序定义，但 macro_rules 例外，它有自己的作用域规则。

r[items.name-resolution] 项名称的名称解析允许项在模块或块中被引用之前或之后定义。

关于项的作用域规则，参见项作用域。