Rust 編程視頻教程(進階)——007_3 文檔注釋(pub use 導出合適的公有 API)

視頻地址

頭條地址:https://www.ixigua.com/i6775861706447913485
B站地址:https://www.bilibili.com/video/av81202308/

講解內容

使用pub use導出合適的公有API
例子1:

//! # Art
//!
//! 一個描述美術信息的庫。
pub mod kinds {
    /// 采用 RGB 色彩模式的主要顏色蜕企。
    pub enum PrimaryColor {
        Red,
        Yellow,
        Blue,
    }
    /// 采用 RGB 色彩模式的次要顏色。
    pub enum SecondaryColor {
        Orange,
        Green,
        Purple,
    }
}

pub mod utils {
    use crate::kinds::*;
    /// 等量的混合兩個主要顏色
    /// 來創(chuàng)建一個次要顏色。
    pub fn mix(c1: PrimaryColor, c2: PrimaryColor) -> SecondaryColor {
        SecondaryColor::Orange
    }
}

//========================================
例子2:

//! # Art
//!
//! 一個描述美術信息的庫务冕。
//+++++以下為例子2添加部分+++++++++
pub use kinds::PrimaryColor;
pub use kinds::SecondaryColor;
pub use utils::mix;
//+++++++++++++++++++++++++++++++
pub mod kinds {
    /// 采用 RGB 色彩模式的主要顏色硼身。
    pub enum PrimaryColor {
        Red,
        Yellow,
        Blue,
    }
    /// 采用 RGB 色彩模式的次要顏色拇囊。
    pub enum SecondaryColor {
        Orange,
        Green,
        Purple,
    }
}

pub mod utils {
    use crate::kinds::*;
    /// 等量的混合兩個主要顏色
    /// 來創(chuàng)建一個次要顏色迂曲。
    pub fn mix(c1: PrimaryColor, c2: PrimaryColor) -> SecondaryColor {
        SecondaryColor::Orange
    }
}

運行cargo doc --open后觀察兩者的不同

?著作權歸作者所有,轉載或內容合作請聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市寥袭,隨后出現(xiàn)的幾起案子路捧,更是在濱河造成了極大的恐慌,老刑警劉巖传黄,帶你破解...
    沈念sama閱讀 212,686評論 6 492
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件鬓长,死亡現(xiàn)場離奇詭異,居然都是意外死亡尝江,警方通過查閱死者的電腦和手機,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 90,668評論 3 385
  • 文/潘曉璐 我一進店門英上,熙熙樓的掌柜王于貴愁眉苦臉地迎上來炭序,“玉大人,你說我怎么就攤上這事苍日〔涯簦” “怎么了?”我有些...
    開封第一講書人閱讀 158,160評論 0 348
  • 文/不壞的土叔 我叫張陵相恃,是天一觀的道長辜纲。 經常有香客問我,道長拦耐,這世上最難降的妖魔是什么耕腾? 我笑而不...
    開封第一講書人閱讀 56,736評論 1 284
  • 正文 為了忘掉前任,我火速辦了婚禮杀糯,結果婚禮上扫俺,老公的妹妹穿的比我還像新娘。我一直安慰自己固翰,他們只是感情好狼纬,可當我...
    茶點故事閱讀 65,847評論 6 386
  • 文/花漫 我一把揭開白布羹呵。 她就那樣靜靜地躺著,像睡著了一般疗琉。 火紅的嫁衣襯著肌膚如雪冈欢。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 50,043評論 1 291
  • 那天盈简,我揣著相機與錄音凑耻,去河邊找鬼。 笑死送火,一個胖子當著我的面吹牛拳话,可吹牛的內容都是我干的。 我是一名探鬼主播种吸,決...
    沈念sama閱讀 39,129評論 3 410
  • 文/蒼蘭香墨 我猛地睜開眼弃衍,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了坚俗?” 一聲冷哼從身側響起镜盯,我...
    開封第一講書人閱讀 37,872評論 0 268
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎猖败,沒想到半個月后速缆,有當地人在樹林里發(fā)現(xiàn)了一具尸體,經...
    沈念sama閱讀 44,318評論 1 303
  • 正文 獨居荒郊野嶺守林人離奇死亡恩闻,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 36,645評論 2 327
  • 正文 我和宋清朗相戀三年艺糜,在試婚紗的時候發(fā)現(xiàn)自己被綠了。 大學時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片幢尚。...
    茶點故事閱讀 38,777評論 1 341
  • 序言:一個原本活蹦亂跳的男人離奇死亡破停,死狀恐怖,靈堂內的尸體忽然破棺而出尉剩,到底是詐尸還是另有隱情真慢,我是刑警寧澤,帶...
    沈念sama閱讀 34,470評論 4 333
  • 正文 年R本政府宣布理茎,位于F島的核電站黑界,受9級特大地震影響,放射性物質發(fā)生泄漏皂林。R本人自食惡果不足惜朗鸠,卻給世界環(huán)境...
    茶點故事閱讀 40,126評論 3 317
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望础倍。 院中可真熱鬧童社,春花似錦、人聲如沸著隆。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,861評論 0 21
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至弦赖,卻和暖如春项栏,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背蹬竖。 一陣腳步聲響...
    開封第一講書人閱讀 32,095評論 1 267
  • 我被黑心中介騙來泰國打工沼沈, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人币厕。 一個月前我還...
    沈念sama閱讀 46,589評論 2 362
  • 正文 我出身青樓列另,卻偏偏與公主長得像,于是被迫代替她去往敵國和親旦装。 傳聞我的和親對象是個殘疾皇子页衙,可洞房花燭夜當晚...
    茶點故事閱讀 43,687評論 2 351

推薦閱讀更多精彩內容