C 庫函數 - sscanf()
描述
C 庫函數 int sscanf(const char *str, const char *format, ...) 從字串讀取格式化輸入。
聲明
下麵是 sscanf() 函數的聲明。
int sscanf(const char *str, const char *format, ...)
參數
- str -- 這是 C 字串,是函數檢索數據的源。
- format -- 這是 C 字串,包含了以下各項中的一個或多個:空格字元、非空格字元 和 format 說明符。
format 說明符形式為 [=%[*][width][modifiers]type=],具體講解如下:
參數 | 描述 |
---|---|
* | 這是一個可選的星號,表示數據是從流 stream 中讀取的,但是可以被忽視,即它不存儲在對應的參數中。 |
width | 這指定了在當前讀取操作中讀取的最大字符數。 |
modifiers | 為對應的附加參數所指向的數據指定一個不同於整型(針對 d、i 和 n)、無符號整型(針對 o、u 和 x)或浮點型(針對 e、f 和 g)的大小: h :短整型(針對 d、i 和 n),或無符號短整型(針對 o、u 和 x) l :長整型(針對 d、i 和 n),或無符號長整型(針對 o、u 和 x),或雙精度型(針對 e、f 和 g) L :長雙精度型(針對 e、f 和 g) |
type | 一個字元,指定了要被讀取的數據類型以及數據讀取方式。具體參見下一個表格。 |
sscanf 類型說明符:
類型 | 合格的輸入 | 參數的類型 |
---|---|---|
c | 單個字元:讀取下一個字元。如果指定了一個不為 1 的寬度 width,函數會讀取 width 個字元,並通過參數傳遞,把它們存儲在數組中連續位置。在末尾不會追加空字元。 | char * |
d | 十進位整數:數字前面的 + 或 - 號是可選的。 | int * |
e,E,f,g,G | 浮點數:包含了一個小數點、一個可選的前置符號 + 或 -、一個可選的後置字元 e 或 E,以及一個十進位數字。兩個有效的實例 -732.103 和 7.12e4 | float * |
o | 八進制整數。 | int * |
s | 字串。這將讀取連續字元,直到遇到一個空格字元(空格字元可以是空白、換行和跳位字元)。 | char * |
u | 無符號的十進位整數。 | unsigned int * |
x,X | 十六進制整數。 | int * |
- 附加參數 -- 這個函數接受一系列的指針作為附加參數,每一個指針都指向一個對象,對象類型由 format 字串中相應的 % 標籤指定,參數與 % 標籤的順序相同。
針對檢索數據的 format 字串中的每個 format 說明符,應指定一個附加參數。如果您想要把 sscanf 操作的結果存儲在一個普通的變數中,您應該在識別字前放置引用運算符(&),例如:
int n; sscanf (str,"%d",&n);
返回值
如果成功,該函數返回成功匹配和賦值的個數。如果到達檔末尾或發生讀錯誤,則返回 EOF。
實例
下麵的實例演示了 sscanf() 函數的用法。
#include <stdio.h> #include <stdlib.h> #include <string.h> int main() { int day, year; char weekday[20], month[20], dtm[100]; strcpy( dtm, "Saturday March 25 1989" ); sscanf( dtm, "%s %s %d %d", weekday, month, &day, &year ); printf("%s %d, %d = %s\n", month, day, year, weekday ); return(0); }
讓我們編譯並運行上面的程式,這將產生以下結果:
March 25, 1989 = Saturday