fix(cstdlib/mblen): 内部状態と std::mbrlen を言及

Author: akinomyoga

reference/cstdlib/mblen.md

@@ -18,6 +18,10 @@ namespace std {
 
 `n`は解析に使用する最大バイト数を指定する。
 
+この関数は `std::mbstate_t` に等価な静的記憶域の内部状態を保持し、前回の `mblen` 関数呼び出しの続きとして処理を行う。
+従って、この関数はスレッドセーフではない。
+スレッドセーフに処理する場合は、`std::mbstate_t` を受け取る [`std::mbrlen`](../cwchar/mbrlen.md.nolink) (`<cwchar>`) を使い、呼び出し元でデコード状態の記録場所 `std::mbstate_t` を用意する。
+
 ## 戻り値
 - 正常に動作する場合、文字の占めるバイト数を返す。
 - `str`が`nullptr`の時、内部状態を初期化し`0`を返す。
@@ -57,7 +61,7 @@ int count_chars_mblen(const char* s) {
  int count = 0;
  std::size_t i = 0;
  std::size_t bytes = std::strlen(s);
- while (s[i] != '\0') {
+ while (i < bytes) {
  int len = std::mblen(&s[i], bytes - i);
  if (len < 0) {
  len = 1;
@@ -77,8 +81,15 @@ int main() {
 }
 ```
 
+注意: この例は飽くまで `std::mblen` を用いて文字数を数える関数の例であるが、実用上は `std::mbrlen` を用いた実装にするのが安全である。
+上の関数 `count_chars_mblen` はスレッドーセーフでない他、呼び出し元でも `std::mblen` を使っている場合にその振る舞いを破壊する可能性がある。
+
 #### 出力例
 ```
 文字列: こんにちは世界
 文字数: 7
 ```
+
+## 関連項目
+
+- [`mbrlen`](../cwchar/mbrlen.md.nolink): `std::mbstate_t` を受け取るスレッドセーフなバージョン