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 之前的字元數。手動或透過指標走訪時,必須有有效終止符或明確界限。將陣列傳入函式時,請一併保留其長度,因為這類參數會是指標。