sscanf

sscanf

sscanf 讀取格式化的字元串中的數據。 swscanf 是 sscanf 的寬字元版本;swscanf 的參數是寬字元串。 swscanf不處理 Unicode 全形十六進制或"兼容性區"字元。 除此以外,swscanf 和 sscanf 的行為完全相同。

函式語法

參數

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

相關詞條

相關搜尋

熱門詞條

聯絡我們