記述、例を追加

Author: K10-K10

reference/cstdlib/mblen.md

@@ -12,15 +12,19 @@ namespace std {
 ## 概要
 マルチバイト文字列の先頭の文字が占めるバイト数を返す。
 
+先頭以外の文字に関するバイト数は計算されない。
+
 この関数は現在のロケールに依存してマルチバイト文字を解釈する。
-n は解析に使用する最大バイト数を指定する。
+
+`n`は解析に使用する最大バイト数を指定する。
 
 ## 戻り値
 - 正常に動作する場合、文字の占めるバイト数を返す。
 - `str`が`nullptr`の時、内部状態を初期化し`0`を返す。
 - 無効な文字列、または`n`が不足している場合、`-1`を返す。
 
 ## 例
+### 基本的な使い方
 ```cpp example
 #include <iostream>
 #include <cstdlib>
@@ -35,7 +39,41 @@ int main() {
 }
 ```
 
-### 出力例
+#### 出力例
 ```
 3
 ```
+
+### 文字列の文字数を計算する
+```cpp example
+#include <iostream>
+#include <cstdlib>
+#include <clocale>
+
+int count_chars_mblen(const char* s) {
+    std::setlocale(LC_ALL, "ja_JP.UTF-8");
+    int count = 0;
+    size_t i = 0;
+    while (s[i] != '\0') {
+        int len = std::mblen(&s[i], MB_CUR_MAX);
+        if (len < 0) {
+            len = 1;
+        }
+        i += len;
+        count++;
+    }
+    return count;
+}
+
+int main() {
+    const char* str = "こんにちは世界";
+    std::cout << "文字列: " << str << "\n";
+    std::cout << "文字数: " << count_chars_mblen(str) << "\n";
+}
+```
+
+#### 出力例
+```
+文字列: こんにちは世界
+文字数: 7
+```