sscanf

sscanf 讀取格式化的字元串中的數據。

swscanf 是 sscanf 的寬字元版本；swscanf 的參數是寬字元串。 swscanf不處理 Unicode 全形十六進制或"兼容性區"字元。 除此以外，swscanf 和 sscanf 的行為完全相同。

基本介紹

• 外文名：sscanf
• 類別：C 數據輸入
• 解釋：字元串中讀進相符的數據
• 參數：寬字元串

函式語法

int sscanf(     const char *buffer,     const char *format, [ argument ] ...   ); 

參數

buffer
存儲的數據

format
窗體控制項字元串。 有關詳細信息，請參閱"格式規範"。

argument
可選自變數

locale
要使用的區域設定

要求

例程	必須的頭檔案
sscanf	<stdio.h>
_sscanf_l
swscanf	<stdio.h>; <wchar.h>
_swscanf_l

說明

sscanf與scanf類似，都是用於輸入的，只是後者以鍵盤(stdin)為輸入源，前者以固定字元串為輸入源。

第二個參數可以是一個或多個 {%[*] [width] [{h | I | I64 | L}]type | ' ' | '\t' | '\n' | 非%符號}

註：

1、 * 亦可用於格式中, (即 %*d 和 %*s) 加了星號 (*) 表示跳過此數據不讀入. (也就是不把此數據讀入參數中)

2、{a|b|c}表示a,b,c中選一，[d],表示可以有d也可以沒有d。

3、width表示讀取寬度。

4、{h | l | I64 | L}:參數的size,通常h表示單位元組size，I表示2位元組 size,L表示4位元組size(double例外),l64表示8位元組size。

5、type :這就很多了，就是%s,%d之類。

6、特別的：%*[width] [{h | l | I64 | L}]type 表示滿足該條件的被過濾掉，不會向目標參數中寫入值

失敗返回0 ，否則返回格式化的參數個數

7、如果讀取的字元串，不是以空格來分隔的話，就可以使用%[]。

返回值

函式將返回成功賦值的欄位個數；返回值不包括已讀取但未賦值的欄位個數。 返回值為 0 表示沒有將任何欄位賦值。 如果在第一次讀取之前到達字元串結尾，則返回EOF。

如果buffer或format是NULL調用指針，無效參數處理程式，如中所述參數驗證。 如果允許繼續執行，則這些函式返回 -1 並將errno設定為EINVAL。

成功則返回參數數目，失敗則返回-1，錯誤原因存於errno中。

經多次測試[來源請求]，在linux系統中成功返回的是成功轉換的值的個數，例如：

sscanf("1 2 3","%d %d %d",buf1, buf2, buf3); 成功調用返回值為3，即buf1，buf2，buf3均成功轉換。

sscanf("1 2","%d %d %d",buf1, buf2, buf3); 成功調用返回值為2，即只有buf1，buf2成功轉換。

(注意：此處buf均為地址)

有關這些和其他錯誤代碼的信息，請參閱_doserrno、 errno、 _sys_errlist 和 _sys_nerr。

作用

讀取格式化的字元串中的數據。

P.S. 這些函式的更安全版本才會有效。請參閱sscanf_s、 _sscanf_s_l、 swscanf_s、 _swscanf_s_l。

使用實例

1、一般用法

char buf[512] = ;sscanf("123456 ", "%s", buf);printf("%s\n", buf);

結果為：123456
2. 取指定長度的字元串。如在下例中，取最大長度為4位元組的字元串。

sscanf("123456 ", "%4s", buf);printf("%s\n", buf);

結果為：1234
3. 取到指定字元為止的字元串。如在下例中，取遇到空格為止字元串。

sscanf("123456 abcdedf", "%[^ ]", buf);printf("%s\n", buf);

結果為：123456
4. 取僅包含指定字元集的字元串。如在下例中，取僅包含1到9和小寫字母的字元串。

sscanf("123456abcdedfBCDEF", "%[1-9a-z]", buf);printf("%s\n", buf);

結果為：123456abcdedf
5. 取到指定字元集為止的字元串。如在下例中，取遇到大寫字母為止的字元串。

sscanf("123456abcdedfBCDEF", "%[^A-Z]", buf);printf("%s\n", buf);

結果為：123456abcdedf
6、給定一個字元串iios/12DDWDFF@122，獲取 / 和 @ 之間的字元串，先將 "iios/"過濾掉，再將非'@'的一串內容送到buf中

sscanf("iios/12DDWDFF@122", "%*[^/]/%[^@]", buf);printf("%s\n", buf);

結果為：12DDWDFF
7、給定一個字元串"hello, world"，僅保留"world"。（注意：“，”之後有一空格）

sscanf("hello, world", "%*s%s", buf);printf("%s\n", buf);

結果為：world
P.S. %*s表示第一個匹配到的%s被過濾掉，即hello被過濾了，
如果沒有空格則結果為NULL。

例程

代碼

//Compiled with Visual Studio 2015.//================Original File===================*/// crt_sscanf.c  // compile with: /W3  // This program uses sscanf to read data items  // from a string named tokenstring, then displays them.    #include <stdio.h>    int main( void )  {     char  tokenstring[] = "15 12 14...";     char  s[81];     char  c;     int   i;     float fp;       // Input various data from tokenstring:     // max 80 character string:     sscanf( tokenstring, "%80s", s ); // C4996     sscanf( tokenstring, "%c", &c );  // C4996     sscanf( tokenstring, "%d", &i );  // C4996     sscanf( tokenstring, "%f", &fp ); // C4996     // Note: sscanf is deprecated; consider using sscanf_s instead       // Output the data read     printf( "String    = %s\n", s );     printf( "Character = %c\n", c );     printf( "Integer:  = %d\n", i );     printf( "Real:     = %f\n", fp );  }  

輸出

String    = 15  Character = 1  Integer:  = 15  Real:     = 15.000000  

集合操作

%[a-z] 表示匹配a到z中任意字元，貪婪性(儘可能多的匹配)

%[aB'] 匹配a、B、'中一員，貪婪性

%[^a] 匹配非a的任意字元，並且停止讀入，貪婪性

小結

sscanf的功能很類似於正則表達式, 但卻沒有正則表達式強大,所以如果對於比較複雜的字元串處理,建議使用正則表達式。