getstring詳解

1. 功能介紹

getstring函數是一個用於從輸入流中讀取字元串的函數，常被用於C語言、C++等語言中。它的功能是讀取由用戶在終端輸入的字元串，保存在指定的字元數組中。

getstring函數通過循環讀入單個字元，直到讀入一個換行符為止。在讀取過程中，它會忽略行首的空格，並在遇到第一個非空格字元時開始讀取直到無法讀入更多字元或遇到換行符為止。

在讀取過程中，如果到達讀入字元數組的大小限制，或者讀入過程發生錯誤，getstring函數會返回一個錯誤碼。

2. 使用方法

getstring的調用方式如下所示：

char str[100];
int success = getstring(str, 100);
if (success == -1) {
  printf("讀取失敗。");
} else {
  printf("讀取成功，輸入內容為：%s", str);
}

上述代碼中，我們首先定義了一個字元數組str，用於存放讀入的字元串。然後調用getstring函數，傳入兩個參數：str和100。其中，str是一個字元指針，指向字元數組，表示要將讀入的字元串保存到這個數組中；100表示要讀取的最大字元數。

如果getstring函數調用成功，它將返回0，表示讀取成功，並且讀入的字元串已經保存在str中。如果getstring函數返回-1，表示讀取失敗。

3. 參數說明

getstring函數定義如下：

int getstring(char *str, int maxsize);

函數中有兩個參數：

• str：表示要保存讀入字元串的字元數組指針；
• maxsize：表示要讀取的最大字元數。

4. 代碼示例

下面是一個完整的getstring函數的代碼示例：

#include <stdio.h>

int getstring(char *str, int maxsize) {
  int i = 0;
  char ch = getchar();
  while (ch != '\n' && ch != EOF) {
    if (i < maxsize - 1) {
      str[i++] = ch;
    }
    ch = getchar();
  }
  str[i] = '\0';
  if (i == 0 && ch == EOF) {
    return -1;
  } else {
    return 0;
  }
}

int main() {
  char str[100];
  int success = getstring(str, 100);
  if (success == -1) {
    printf("讀取失敗。");
  } else {
    printf("讀取成功，輸入內容為：%s", str);
  }
  return 0;
}

5. 注意事項

在使用getstring函數時，需要注意以下幾點：

• 調用getchar函數讀取一個字元時，需要按下回車鍵才能將字元輸入到輸入流中。
• 在讀取過程中，如果輸入流中的字元數超過了maxsize-1，getstring函數會截斷讀取並將最後一個字元置為’\0’，這意味著讀取的字元串可能不會包含所有用戶輸入的內容。
• 在讀取過程中，如果輸入流中的字元數達到了maxsize-1，並且下一個字元不是換行符，getstring函數仍然會一直讀取，直到遇到換行符為止。