嵌入式系統(tǒng)開發(fā)人員應(yīng)盡可能明確，以避免 ASSUME 綜合癥并在其系統(tǒng)中產(chǎn)生意外行為。在今天的文章中，讓我們來看看嵌入式開發(fā)人員可以通過更明確的方式清理代碼的幾個領(lǐng)域。

顯式編程技巧 #1 – 將 extern 與公共函數(shù)一起使用

我們都知道我們不應(yīng)該使用 extern，因為它會創(chuàng)建全局變量，進而可能導(dǎo)致各種問題。但是，實際使用 extern 的一個好地方是在創(chuàng)建公共函數(shù)時。

當你定義一個公開的函數(shù)時，你可以使用以下命令在標頭中創(chuàng)建聲明或原型：

void Foo(void);

它在標題中，所以很明顯它是一個公共的外部函數(shù)。但是，我遇到過這樣的情況，你正在維護一個別人編寫的模塊，并且在像 Bar 這樣的函數(shù)的標頭中沒有公共 API，但它的定義如下：

void Bar(void)

{

…

}

這個函數(shù)的目的是什么？ 它應(yīng)該是私有的并且前面有一個靜電嗎？它應(yīng)該是公開的并在標題中定義嗎？如果嵌入式開發(fā)人員將 Bar 定義為：

extern Bar(void)

{

…

}

我們會知道它是公開的并且在 API 中缺失，盡管有人調(diào)用它，鏈接器仍然能夠找到它。

顯式編程技巧 #2 – 將指針作為 const 傳遞給函數(shù)，除非它們改變

指針是危險的，如果它們在執(zhí)行過程中意外地以某種意想不到的方式遞增、遞減或修改，它們很容易導(dǎo)致災(zāi)難。我經(jīng)常會遇到如下所示的函數(shù)聲明：

void Foo(uint32_t * Param1);

這個聲明是如此含蓄，我讀了這個聲明，其目的是將一個指針傳遞給一個 uint32_t，其中指針和指向的 uint32_t 內(nèi)存位置都允許更改！

這是嵌入式開發(fā)人員的本意嗎？ 如果他們只是想傳遞一個指向變量的指針，以便它通過引用傳遞并且可以被函數(shù)修改怎么辦？ 這個函數(shù)可以做到這一點，但他們也打開了修改指針的選項！

下面的陳述對我來說非常清楚，指針不會改變，指向的值可以改變：

void Foo(uint32_t * const Param1);

參數(shù)是指向 uint32_t 內(nèi)存位置的 const 指針。指針在函數(shù)中不能改變，但指向的東西可以。因此，如果有人在函數(shù)中執(zhí)行以下操作：

Param++;

編譯器會說“不！ 錯誤！”，讓維護者明白他們不應(yīng)該這樣做。

顯式編程技巧 #3 – 將“no reference”變量作為 const 傳遞

現(xiàn)在，這通常會讓嵌入式開發(fā)人員興奮不已，而且不是很好。有人告訴我這是無稽之談，但同樣，它使包括新手在內(nèi)的任何開發(fā)人員都清楚代碼。

這里的想法是我可能有一個聲明如下的函數(shù)：

void Foo(uint32_t Param1);

在這種情況下，我通過副本而不是引用傳遞參數(shù)，以供函數(shù)使用。該函數(shù)理論上可以對本地副本執(zhí)行任何操作。但同樣，如果有人在維護這段代碼，他們是否知道我們想要接收參數(shù)并將其用作常量？ 對我來說，除非聲明是這樣寫的，否則我不會有任何線索：

void Foo(const uint32_t Param1);

這告訴我，該參數(shù)預(yù)計不會在副本中更改或修改以供本地使用。

這些提示有助于使代碼更清晰，并有助于嵌入式開發(fā)人員理解代碼的真正意圖。現(xiàn)在，這些可能不是導(dǎo)致所有這些損失的隱式代碼的最佳做法，但它們確實讓你認為你應(yīng)該編寫盡可能清晰的軟件。