C語言 mblen用法及代碼示例

C語言stdlib頭文件(stdlib.h)中mblen函數的用法及代碼示例。

用法:

int mblen (const char* pmb, size_t max);

獲取多字節字符的長度

返回由指向的多字節字符的大小pmb最多檢查max個字節。

mblen有自己的內部換檔狀態，隻有在調用此函數時才需要進行更改。使用空指針作為對函數的調用pmb重置狀態(並返回多字節字符是否為state-dependent)。

此函數的行為取決於LC_CTYPE所選類別C語言環境。

參數

pmb: 指向多字節字符的第一個字節的指針。
或者，可以使用空指針，在這種情況下，該函數會將其內部移位狀態重置為初始值，並返回多字節字符是否使用state-dependent編碼。
max: 最大字節數pmb考慮使用多字節字符。
不多於MB_CUR_MAX在任何情況下都將檢查字符。
size_t是無符號整數類型。

返回值

如果參數傳遞為pmb不是一個空指針，由指向的字符的大小(以字節為單位)pmb當它形成有效的多字節字符而不是終止空字符。如果是終止空字符，該函數將返回零，並且在它們不構成有效的多字節字符的情況下，-1返回。

如果參數傳遞為pmb是一個空指針，如果多字節字符編碼為state-dependent，則該函數返回非零值，否則返回零。

示例

/* mblen example */
#include <stdio.h>      /* printf */
#include <stdlib.h>     /* mblen, mbtowc, wchar_t(C) */

void printbuffer (const char* pt, size_t max)
{
  int length;
  wchar_t dest;

  mblen (NULL, 0);         /* reset mblen */
  mbtowc (NULL, NULL, 0);  /* reset mbtowc */

  while (max>0) {
    length = mblen (pt, max);
    if (length<1) break;
    mbtowc(&dest,pt,length);
    printf ("[%lc]",dest);
    pt+=length; max-=length;
  }
}

int main()
{
  const char str [] = "test string";

  printbuffer (str,sizeof(str));

  return 0;
}

printbuffer按字符打印多字節字符串。

該示例使用一個瑣碎的字符串"C"語言環境，但是該函數支持解釋多字節字符串的語言環境。

輸出：


[t][e][s][t][ ][s][t][r][i][n][g]

相關用法

注：本文由純淨天空篩選整理自C標準庫大神的英文原創作品 C mblen function。非經特殊聲明，原始代碼版權歸原作者所有，本譯文未經允許或授權，請勿轉載或複製。