mirror of
https://github.com/gnu4cn/rust-lang-zh_CN.git
synced 2025-03-14 03:10:44 +08:00
Update Ch14
This commit is contained in:
parent
77ec6d6333
commit
13ffbea2df
@ -293,7 +293,7 @@ art = { path = "../art" }
|
||||
|
||||
清单 14-4 中用到 `art` 代码箱代码的作者,不得不搞清楚 `PrimaryColor` 是在 `kinds` 模组中,及 `mix` 函数是在 `utils` 模组中。`art` 代码箱的模组结构(即模组树),相比于用到该代码箱的开发者,与在 `art` 代码箱上编写代码的开发者要更为密切。对于试图搞清楚怎样使用 `art` 代码箱的人来说,其内部组织结构并未包含任何有用信息,而因为要用到他的开发者,不得不搞明白要在那里去查看,且必须在 `use` 语句中指明那些模组名字,这反而会造成混乱。
|
||||
|
||||
要从公开 API 中移除内部组织结构,咱们可把清单 14-3 中 `art` 代码箱的代码,修改为添加一些 `pub use` 语句,来在顶层处重导出程序项目,to re-export the iems at the top level,如下清单 14-5 中所示:
|
||||
要从公开 API 中移除内部组织结构,咱们可把清单 14-3 中 `art` 代码箱的代码,修改为添加一些 `pub use` 语句,来在顶层处重导出程序项目,to re-export the items at the top level,如下清单 14-5 中所示:
|
||||
|
||||
文件名:`src/lib.rs`
|
||||
|
||||
@ -312,11 +312,11 @@ pub mod utils;
|
||||
|
||||
*清单 14-5:添加 `pub use` 语句来重导出程序项目*
|
||||
|
||||
如下图 14-04 中所示,`cargo doc` 为此代码箱所产生出的 API 文档,现在就会在首页上,列出并链接到那些重导出的程序项目,令到 `PrimaryColor` 与 `SecondaryColor` 两个类型,以及那个 `mix` 函数更易于找到。
|
||||
如下图 14-04 中所示,`cargo doc` 为此代码箱所产生出的 API 文档,现在将在首页上列出并链接到重导出项,从而令到 `PrimaryColor` 与 `SecondaryColor` 两个类型及 `mix` 函数更易于找到。
|
||||
|
||||

|
||||
|
||||
*图 14-4:列出了重导出项目的 `art` 代码箱文档首页*
|
||||
*图 14-4:列出重导出项的 `art` 代码箱文档首页*
|
||||
|
||||
这个 `art` 代码箱的用户,仍然能象下面清单 14-4 中所演示的那样,看到并使用清单 14-3 中的内部结构,抑或他们可以使用清单 14-5 中那种更为便利的结构,如下清单 14-6 中所示:
|
||||
|
||||
|
Binary file not shown.
Before Width: | Height: | Size: 142 KiB After Width: | Height: | Size: 219 KiB |
Loading…
Reference in New Issue
Block a user