在公共C++ API中的類型

Question

我正在編寫一個庫，並想知道公共API中使用的數據類型的最佳做法是什麼。

鑑於功能

void foo (int bar) 

它期望的索引一些內部陣列/容器。應該是什麼類型？因爲索引永遠不會是負數，所以我可以使用unsigned int或size_t。或者，如果提供了一些無效值，我應該堅持使用純int和斷言/拋出？

一般情況：我應該根據有效的數據範圍選擇一種類型（例如爲了避免負面檢查）嗎？

編輯：另一個例子，假設我的庫提供了打印文件的功能。用戶可以選擇要打印的頁面範圍：

void print (int page_from, int page_to) 

Answer 1

如果您正在討論的數組/容器只是一個通用的抽象應用程序無關數組，那麼最適合的類型將是size_t。當然，您可以在界面中爲該類型提供一個typedef名稱。再次，這隻適用於使用抽象數組（如通用容器庫或通用排序函數等）。

您進入應用程序特定區域時，size_t不再是適當的類型。在您的應用程序特定區域，該索引通常會有一些特定於應用程序的語義不與數組直接相關。例如，它可以是某種類型的「員工ID」，或「單元號」或「顏色索引」或其他。在這種情況下，您通常會有一個預選的整數類型來表示相應的數量。 （而且選擇通常與數組無關。）這正是您應該在界面中使用的類型。

至於類型的符號/無符號...我堅信無符號數應該用無符號類型表示，即正常數組索引應該是無符號的。

Answer 2

這裏最好的建議很可能會去與現行做法（即什麼C++標準庫這樣做）。一般來說，這意味着至少在這裏使用unsigned類型;如果實際上直接使用該類型作爲數組/指針索引（並且抽象在這方面是透明的），那麼可能會調用size_t。

如果foo是一些類容器類的成員函數，那麼你也可以考慮typedef就像size_type一樣，並使用它。

Answer 3

我投票使用無符號。更好的是，使用stdint.h並使用像uint32_t之類的東西。