?
? ????? PHP ??? ???? ??? ?? ??
在頭文件<string.h>中定義 | ||
---|---|---|
(1) | ||
char * strncat(char * dest,const char * src,size_t count); | (直到C99) | |
char * strncat(char * restrict dest,const char * restrict src,size_t count); | (自C99以來) | |
errno_t strncat_s(char * restrict dest,rsize_t destsz,const char * restrict src,rsize_t count); | (2) | (自C11以來) |
1)追加由src指向的字符數(shù)組中的大多數(shù)計數(shù)字符,如果找到空字符,則停止到由dest指向的以null結(jié)尾的字節(jié)字符串的末尾。 字符src [0]替換dest結(jié)尾處的空終止符。 終止空字符總是附加在最后(因此函數(shù)可以寫入的最大字節(jié)數(shù)為count + 1)。
如果目標(biāo)數(shù)組沒有足夠的空間用于dest和src的第一個計數(shù)字符的內(nèi)容以及終止的空字符,則行為未定義。 如果源和目標(biāo)對象重疊,則行為未定義。 如果dest不是指向以空字符結(jié)尾的字節(jié)字符串的指針,或者src不是指向字符數(shù)組的指針,則行為未定義.
2)與(1)相同,只是此函數(shù)可能會打斷目標(biāo)數(shù)組的其余部分(從寫入到destsz的最后一個字節(jié)開始),并且在運行時檢測到以下錯誤并調(diào)用當(dāng)前安裝的約束處理函數(shù):
src
或者dest
是空指針
destsz
或者count
是零或大于RSIZE_MAX
在第一個destsz
字節(jié)中沒有空字符dest
則會發(fā)生截斷:count
或者src
較小者的長度超過了dest
和destsz
的空終止符之間的可用空間。
源和目標(biāo)字符串之間會發(fā)生重疊
如果由dest <strnlen(dest,destsz)+ strnlen(src,count)+1 <destsz;指向的字符數(shù)組的大小,則行為是不確定的。 換句話說,destsz的錯誤值不會暴露即將發(fā)生的緩沖區(qū)溢出。 如果字符數(shù)組的大小由src <strnlen(src,count)<destsz; 換句話說,count的錯誤值不會暴露即將發(fā)生的緩沖區(qū)溢出。 作為所有邊界檢查函數(shù),只有當(dāng)__STDC_LIB_EXT1__由實現(xiàn)定義并且在包含string.h之前用戶將__STDC_WANT_LIB_EXT1__定義為整數(shù)常量1時,strncat_s才能保證可用。
dest | - | 指向要附加到的以空字符結(jié)尾的字節(jié)字符串 |
---|---|---|
SRC | - | 指向要復(fù)制的字符數(shù)組的指針 |
count | - | 最大數(shù)量的字符復(fù)制 |
destsz | - | 目標(biāo)緩沖區(qū)的大小 |
1)返回 dest
副本
2)在成功時返回零,錯誤時返回非零值。 另外,如果發(fā)生錯誤,則將零寫入dest [0](除非dest是空指針或destsz為零或大于RMAX_SIZE)。
盡管適合目標(biāo)緩沖區(qū)的截斷存在安全風(fēng)險,并且因此違反了strncat_s的運行時間約束,但可以通過指定count等于目標(biāo)數(shù)組的大小減1來獲得截斷行為:它將復(fù)制第一個計數(shù)字節(jié)和 像往常一樣添加空終止符:strncat_s(dst,sizeof dst,src,(sizeof dst)-strnlen_s(dst,sizeof dst)-1);
#define __STDC_WANT_LIB_EXT1__ 1#include <string.h> #include <stdio.h>#include <stdlib.h> int main(void) { char str[50] = "Hello "; char str2[50] = "World!"; strcat(str, str2); strncat(str, " Goodbye World!", 3); puts(str); #ifdef __STDC_LIB_EXT1__ set_constraint_handler_s(ignore_handler_s); char s1[100] = "good"; char s5[1000] = "bye"; int r1 = strncat_s(s1, 100, s5, 1000); // r1 is 0, s1 holds "goodbye\0" printf("s1 = %s, r1 = %d\n", s1, r1); char s2[6] = "hello"; int r2 = strncat_s(s2, 6, "", 1); // r2 is 0, s2 holds "hello\0" printf("s2 = %s, r2 = %d\n", s2, r2); char s3[6] = "hello"; int r3 = strncat_s(s3, 6, "X", 2); // r3 is non-zero, s3 holds "\0" printf("s3 = %s, r3 = %d\n", s3, r3); // the strncat_s truncation idiom: char s4[7] = "abc"; int r4 = strncat_s(s4, 7, "defghijklmn", 3); // r is 0, s4 holds "abcdef\0" printf("s4 = %s, r4 = %d\n", s4, r4);#endif}
可能的輸出:
Hello World! Go s1 = goodbye, r1 = 0s2 = hello, r2 = 0s3 = , r3 = 22s4 = abcdef, r4 = 0
C11標(biāo)準(zhǔn)(ISO / IEC 9899:2011):
7.24.3.2 strncat函數(shù)(p:364-365)
K.3.7.2.2 strncat_s函數(shù)(p:618-620)
C99標(biāo)準(zhǔn)(ISO / IEC 9899:1999):
7.21.3.2 strncat函數(shù)(p:327-328)
C89 / C90標(biāo)準(zhǔn)(ISO / IEC 9899:1990):
4.11.3.2 strncat函數(shù)
strcatstrcat_s(C11) | 連接兩個字符串(函數(shù)) |
---|---|
strcpystrcpy_s(C11) | 將一個字符串復(fù)制到另一個(函數(shù)) |
在頭文件<wctype.h>中定義 | ||
---|---|---|
int iswdigit(wint_t ch); | (自C95以來) |
檢查給定的寬字符是否對應(yīng)(如果縮?。┦畟€十進制數(shù)字字符0123456789中的一個。
CH | - | 寬字符 |
---|
如果寬字符是數(shù)字字符,則為非零值,否則為零。
iswdigit
與iswxdigit
是唯一不受當(dāng)前安裝的C語言環(huán)境影響的標(biāo)準(zhǔn)寬字符分類函數(shù)。
一些語言環(huán)境提供了檢測非ASCII數(shù)字的附加字符類。
#include <stdio.h>#include <wctype.h>#include <wchar.h>#include <locale.h> void test(wchar_t a3, wchar_t u3, wchar_t j3){ printf(" '%lc' '%lc' '%lc'\n", a3, u3, j3); printf("iswdigit %d %d %d\n", !!iswdigit(a3), !!iswdigit(u3), !!iswdigit(j3)); printf("jdigit: %d %d %d\n", !!iswctype(a3, wctype("jdigit")), !!iswctype(u3, wctype("jdigit")), !!iswctype(j3, wctype("jdigit")));} int main(void){ wchar_t a3 = L'3'; // the ASCII digit 3 wchar_t u3 = L'三'; // the CJK numeral 3 wchar_t j3 = L'3'; // the fullwidth digit 3 setlocale(LC_ALL, "en_US.utf8"); puts("In American locale:"); test(a3, u3, j3); setlocale(LC_ALL, "ja_JP.utf8"); puts("\nIn Japanese locale:"); test(a3, u3, j3);}
輸出:
In American locale: '3' '三' '3'iswdigit 1 0 0jdigit: 0 0 0 In Japanese locale: '3' '三' '3'iswdigit 1 0 0jdigit: 0 0 1
C11標(biāo)準(zhǔn)(ISO / IEC 9899:2011):
7.30.2.1.5 iswdigit函數(shù)(p:449)
C99標(biāo)準(zhǔn)(ISO / IEC 9899:1999):
7.25.2.1.5 iswdigit函數(shù)(p:395)
isdigit | 檢查一個字符是否是一個數(shù)字(功能) |
---|
| 用于iswdigit的C ++文檔 |
ASCII 值 (十六進制) | 字符 | iscntrl iswcntrl. | isprint iswprint. | isspace iswspace. | isblank iswblank. | isgraph iswgraph. | ispunct iswpunct. | isalnum iswalnum. | isalpha iswalpha. | isupper iswupper. | islower iswlower. | isdigit iswdigit. | isxdigit iswxdigit. | |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
0 - 8 | 0x00-0x08 | 控制碼 (NUL, etc.) | ≠0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
9 | 0x09 | tab (\t) | ≠0 | 0 | ≠0 | ≠0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
10 - 13 | 0x0A-0x0D | 空格 (\n,\v,\f,\r) | ≠0 | 0 | ≠0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
14 - 31 | 0x0E-0x1F | 控制碼 | ≠0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
32 | 0x20 | space | 0 | ≠0 | ≠0 | ≠0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
33 - 47 | 0x21-0x2F | !"#$%&'()*+,-./ | 0 | ≠0 | 0 | 0 | ≠0 | ≠0 | 0 | 0 | 0 | 0 | 0 | 0 |
48 - 57 | 0x30-0x39 | 0123456789 | 0 | ≠0 | 0 | 0 | ≠0 | 0 | ≠0 | 0 | 0 | 0 | ≠0 | ≠0 |
58 - 64 | 0x3a-0x40 | :;<=>?@ | 0 | ≠0 | 0 | 0 | ≠0 | ≠0 | 0 | 0 | 0 | 0 | 0 | 0 |
65 - 70 | 0x41-0x46 | ABCDEF | 0 | ≠0 | 0 | 0 | ≠0 | 0 | ≠0 | ≠0 | ≠0 | 0 | 0 | ≠0 |
71 - 90 | 0x47-0x5A | GHIJKLMNOPQRSTUVWXYZ | 0 | ≠0 | 0 | 0 | ≠0 | 0 | ≠0 | ≠0 | ≠0 | 0 | 0 | 0 |
91 - 96 | 0x5B-0x60 | []^_` | 0 | ≠0 | 0 | 0 | ≠0 | ≠0 | 0 | 0 | 0 | 0 | 0 | 0 | | ||||||||||||
97 -102 | 0x61-0x66 | abcdef | 0 | ≠0 | 0 | 0 | ≠0 | 0 | ≠0 | ≠0 | 0 | ≠0 | 0 | ≠0 |
103-122 | 0x67-0x7A | ghijklmnopqrstuvwxyz | 0 | ≠0 | 0 | 0 | ≠0 | 0 | ≠0 | ≠0 | 0 | ≠0 | 0 | 0 |
123-126 | 0x7B-0x7E | {|}~ | 0 | ≠0 | 0 | 0 | ≠0 | ≠0 | 0 | 0 | 0 | 0 | 0 | 0 |
127 | 0x7F | 退格 (DEL) | ≠0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |