strxfrm

 

C

編譯器支援

語言

標頭檔案

型別支援

程式工具

變參函式支援

錯誤處理

動態記憶體管理

字串庫

演算法

數值

日期和時間工具

輸入/輸出支援

本地化支援

併發支援 (C11)

技術規範

符號索引

 

字串庫

空終止位元組字串

空終止多位元組字串

空終止寬字串

 

空終止位元組字串

函式
字元操作
isalnum isalpha islower isupper isdigit isxdigit isblank (C99)	iscntrl isgraph isspace isprint ispunct tolower toupper
與數字格式相互轉換
atoiatolatoll (C99) atof strtolstrtoll (C99) strtoulstrtoull (C99)	strtoimaxstrtoumax (C99)(C99) strtofstrtodstrtold (C99)(C99) strfromfstrfromdstrfroml (C23)(C23)(C23)
字串操作
strcpystrcpy_s (C11) strncpystrncpy_s (C11) strcatstrcat_s (C11)	strncatstrncat_s (C11) strxfrm strdup (C23) strndup (C23)
字串檢查
strlenstrnlen_s (C11) strcmp strncmp strcoll strchr strrchr	strspn strcspn strpbrk strstr strtokstrtok_s (C11)
記憶體操作
memchr memcmp memsetmemset_explicitmemset_s (C23)(C11)	memcpymemcpy_s (C11) memmovememmove_s (C11) memccpy (C23)
雜項
strerrorstrerror_sstrerrorlen_s (C11)(C11)

 

定義於標頭檔案 <string.h>
size_t strxfrm( char          *dest, const char          *src, size_t count );		(直到 C99)
size_t strxfrm( char *restrict dest, const char *restrict src, size_t count );		(C99 起)

將 src 所指向的以空字元結尾的位元組字串轉換為由實現定義的格式，使得使用 strcmp 比較兩個轉換後的字串與使用 strcoll 比較原始字串在當前 C 區域設定下產生相同的結果。

轉換後的字串的前 count 個字元（包括終止空字元）寫入目標位置，並返回完整轉換後的字串的長度（不包括終止空字元）。

如果 dest 陣列不夠大，則行為未定義。如果 dest 和 src 重疊，則行為未定義。

如果 count 為 ​0​，則允許 dest 為空指標。

註釋

可以接收整個轉換後的字串的緩衝區的正確長度為 1+strxfrm(NULL, src, 0)

此函式用於使用相同字串或一組字串進行多次依賴於區域設定的比較時，因為使用 strxfrm 只轉換所有字串一次，然後使用 strcmp 比較轉換後的字串更有效率。

引數

dest	-	指向將寫入轉換後字串的陣列的第一個元素的指標
src	-	指向要轉換的以空字元結尾的位元組字串的第一個字元的指標
count	-	要寫入的最大字元數

返回值

轉換後的字串的長度，不包括終止空字元。

示例

執行此程式碼

#include <stdio.h>
#include <string.h>
#include <locale.h>
 
int main(void)
{
    setlocale(LC_COLLATE, "cs_CZ.iso88592");
 
    const char *in1 = "hrnec";
    char out1[1+strxfrm(NULL, in1, 0)];
    strxfrm(out1, in1, sizeof out1);
 
    const char *in2 = "chrt";
    char out2[1+strxfrm(NULL, in2, 0)];
    strxfrm(out2, in2, sizeof out2);
 
    printf("In the Czech locale: ");
    if(strcmp(out1, out2) < 0)
         printf("%s before %s\n",in1, in2);
    else
         printf("%s before %s\n",in2, in1);
 
    printf("In lexicographical comparison: ");
    if(strcmp(in1, in2)<0)
         printf("%s before %s\n",in1, in2);
    else
         printf("%s before %s\n",in2, in1);
 
}

可能的輸出

In the Czech locale: hrnec before chrt
In lexicographical comparison: chrt before hrnec

參考

• C17 標準 (ISO/IEC 9899:2018)

• 7.24.4.5 strxfrm 函式 (p: 267)

• C11 標準 (ISO/IEC 9899:2011)

• 7.24.4.5 strxfrm 函式 (p: 366-367)

• C99 標準 (ISO/IEC 9899:1999)

• 7.21.4.5 strxfrm 函式 (p: 329-330)

• C89/C90 標準 (ISO/IEC 9899:1990)

• 4.11.4.5 strxfrm 函式

另請參閱

strcoll	根據當前區域設定比較兩個字串 (函式)
wcscoll (C95)	根據當前語言環境比較兩個寬字串 (函式)
strcmp	比較兩個字串 (函式)
wcsxfrm (C95)	轉換寬字串，使 wcscmp 產生與 wcscoll 相同的結果 (函式)
C++ 文件 關於 strxfrm