HOWTO · C
在 C 語言中獲取字元陣列的長度
本文演示瞭如何在 C 語言中獲取一個 char 陣列的長度。
本頁內容
在 C 中,「長度」可能指 char 陣列預留的元素數,也可能指字串終止空字元之前的字元數。只要仍能取得陣列型別,就可以用 sizeof 查詢陣列的儲存大小與元素數。只有在字串確實以空字元終止時,才使用 strlen。 (空字元終止符)
使用 sizeof 運算子取得 C 字元陣列的長度
sizeof array 會傳回陣列占用的 C 位元組數。將結果除以 sizeof array[0],即可取得元素數。對 char 陣列而言,每個元素占用一個 C 位元組;但 C 位元組不一定等於八位元組(octet)。
執行以下範例:
本節中的程式碼以及顯示的標籤或輸出仍為英文。
#include <stdio.h>
int main(void) {
char letters[] = {'C', 'o', 'd', 'e'};
char word[] = "Code";
size_t letters_count = sizeof letters / sizeof letters[0];
size_t word_capacity = sizeof word / sizeof word[0];
size_t word_length = word_capacity - 1;
printf("letters: %zu elements, %zu bytes\n", letters_count, sizeof letters);
printf("word: %zu characters, %zu elements including '\\0'\n",
word_length, word_capacity);
return 0;
}
letters: 4 elements, 4 bytes
word: 4 characters, 5 elements including '\0'
letters 的初始設定值預留了四個元素,且不含終止符。字串常值會將 word 初始化為五個元素:四個可見字元,以及結尾的 \0。只有在已知陣列包含該終止符,而且要取得字串長度時,才減去一。%zu 是 size_t 對應的 printf 格式指定符。
只有在可取得陣列型別的地方,sizeof 才會測量整個陣列。在 char text[] 這類函式參數中,陣列參數會調整為指標,因此 sizeof text 測量的是指標大小。如果函式需要陣列長度,請另外傳入元素數。size_t 是用來表示大小的無號型別,詳見 size_t。
使用 strlen 函式取得 C 字元陣列的長度
在 <string.h> 宣告的 strlen 會計算第一個 \0 之前的字元數,不包含該終止符。傳給它的引數必須指向有效且以空字元終止的字串。strlen 不知道陣列的容量,也無法安全地找出缺少終止符之陣列的結尾。空字元終止字串的繁體中文連結目標目前不存在,因此以下連結保留原有路徑:空字元終止字串。
例如,strlen("Code") 會傳回四:這個字串常值有五個陣列元素,但終止符不計入長度。這個呼叫是安全的,因為字串常值包含終止符。除非確定可存取的陣列範圍內有終止符,否則不要對明確指定大小的陣列呼叫 strlen。
手動計數 C 字元陣列的長度
已知陣列界限或有有效終止符時,手動計數就很實用。若陣列的元素數已知為 count,請依序查看索引 0 到 count - 1;不要讀取 array[count]。如果要取得陣列中所存字串的長度,請在遇到 \0 時停止,並確保掃描不會超出陣列界限。
此範例以陣列元素數作為界限,也會在遇到終止符時停止。text 是由字串常值初始化,因此陣列內一定有終止符。迴圈會在讀取元素前檢查界限,所以不會存取 text[sizeof text]。範例會為 Code 的四個字元印出 4。
本節中的程式碼以及顯示的標籤或輸出仍為英文。
#include <stdio.h>
int main(void) {
char text[] = "Code";
size_t length = 0;
size_t capacity = sizeof text / sizeof text[0];
while (length < capacity && text[length] != '\0') {
++length;
}
printf("%zu\n", length);
return 0;
}
若資料沒有終止符,請使用另外提供的元素數,且只處理這些元素;除非能保證界限內有終止符,否則不要一直掃描到 \0。
使用指標取得 C 字元陣列的長度
指標可以逐一走訪字串,但不會攜帶陣列容量。對有效且以空字元終止的字串,可以在 *ptr != '\0' 時繼續移動指標;這和 strlen 一樣,必須有終止符。此範例取得由字串常值建立之陣列的位址,因此已知界限內一定有終止符。它會在解參照前檢查結尾指標,也會在遇到終止符時停止。範例會為 Code 的四個字元印出 4。
本節中的程式碼以及顯示的標籤或輸出仍為英文。
#include <stdio.h>
int main(void) {
char text[] = "Code";
char *ptr = text;
char *end = text + sizeof text / sizeof text[0];
while (ptr < end && *ptr != '\0') {
++ptr;
}
printf("%zu\n", (size_t)(ptr - text));
return 0;
}
若資料沒有終止符,請保留另外的計數值或結尾指標,並在已知界限處停止。如果函式接收指向第一個元素的指標,而它需要走訪長度未由字串終止符表示的陣列,請將元素數作為另一個引數傳入。光靠指標運算無法判定陣列在哪裡結束。陣列大小相關的差異請參閱 C 陣列長度。
結論
請依照需求選擇測量方式:只要完整陣列型別仍可取得,sizeof array / sizeof array[0] 就能得出陣列的元素數;只有在已知陣列包含終止符、且要取得字串長度時,才減去終止符。strlen 會計算有效且以空字元終止的字串中,\0 之前的字元數。手動或透過指標走訪時,必須有有效終止符或明確界限。將陣列傳入函式時,請一併保留其長度,因為這類參數會是指標。