函式語法
參數
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、一般用法
結果為:123456
2. 取指定長度的字元串。如在下例中,取最大長度為4位元組的字元串。
結果為:1234
3. 取到指定字元為止的字元串。如在下例中,取遇到空格為止字元串。
結果為:123456
4. 取僅包含指定字元集的字元串。如在下例中,取僅包含1到9和小寫字母的字元串。
結果為:123456abcdedf
5. 取到指定字元集為止的字元串。如在下例中,取遇到大寫字母為止的字元串。
結果為:123456abcdedf
6、給定一個字元串iios/12DDWDFF@122,獲取 / 和 @ 之間的字元串,先將 "iios/"過濾掉,再將非'@'的一串內容送到buf中
結果為:12DDWDFF
7、給定一個字元串"hello, world",僅保留"world"。(注意:“,”之後有一空格)
結果為:world
P.S. %*s表示第一個匹配到的%s被過濾掉,即hello被過濾了,
如果沒有空格則結果為NULL。
例程
代碼
輸出
集合操作
%[a-z] 表示匹配a到z中任意字元,貪婪性(儘可能多的匹配)
%[aB'] 匹配a、B、'中一員,貪婪性
%[^a] 匹配非a的任意字元,並且停止讀入,貪婪性
小結
sscanf的功能很類似於正則表達式, 但卻沒有正則表達式強大,所以如果對於比較複雜的字元串處理,建議使用正則表達式。