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

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

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

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

void Foo(void);

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

void Bar(void)

{

…

}

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

extern Bar(void)

{

…

}

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

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

指針是危險的，如果它們在執行過程中意外地以某種意想不到的方式遞增、遞減或修改，它們很容易導致災難。我經常會遇到如下所示的函數聲明：

void Foo(uint32_t * Param1);

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

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

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

void Foo(uint32_t * const Param1);

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

Param++;

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

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

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

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

void Foo(uint32_t Param1);

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

void Foo(const uint32_t Param1);

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

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