1+ <!doctype html>
2+ < html class ="cpprefjp " lang ="ja " itemscope ="" itemtype ="http://schema.org/WebPage ">
3+ < head >
4+
5+
6+ <!-- Google tag (gtag.js) -->
7+ < script async src ="https://www.googletagmanager.com/gtag/js?id=G-NXNBNVBTJS "> </ script >
8+ < script >
9+ window . dataLayer = window . dataLayer || [ ] ;
10+ function gtag ( ) { dataLayer . push ( arguments ) ; }
11+ gtag ( 'js' , new Date ( ) ) ;
12+
13+ gtag ( 'config' , 'G-NXNBNVBTJS' ) ;
14+ </ script >
15+
16+
17+ < meta charset ="UTF-8 ">
18+
19+ < title > mblen - cpprefjp C++日本語リファレンス</ title >
20+
21+ < meta name ="viewport " content ="width=device-width,initial-scale=1 ">
22+ < meta name ="keywords " content ="
23+ C++,標準ライブラリ,リファレンス,ドキュメント,STL,std,cstdlib,std,function
24+ ">
25+ < meta name ="title " content ="mblen - cpprefjp C++日本語リファレンス " />
26+ < meta itemprop ="name " content ="mblen - cpprefjp C++日本語リファレンス " />
27+ < meta property ="og:title " content ="mblen - cpprefjp C++日本語リファレンス " />
28+ < meta property ="og:url " content ="https://cpprefjp.github.io/reference/cstdlib/mblen.html " />
29+ < meta property ="og:site_name " content ="cpprefjp - C++日本語リファレンス " />
30+ < meta property ="og:type " content ="article " />
31+ < meta property ="og:description " content ="マルチバイト文字列の先頭の文字が占めるバイト数を返す。 " />
32+ < meta name ="twitter:card " content ="summary " />
33+ < meta name ="twitter:title " content ="mblen - cpprefjp C++日本語リファレンス " />
34+ < meta name ="twitter:url " content ="https://cpprefjp.github.io/reference/cstdlib/mblen.html " />
35+ < meta name ="twitter:description " content ="マルチバイト文字列の先頭の文字が占めるバイト数を返す。 " />
36+
37+
38+ < link rel ="alternate " type ="application/atom+xml " title ="Atom " href ="https://cpprefjp.github.io/rss.xml " />
39+
40+
41+ < link rel ="apple-touch-icon " sizes ="180x180 " href ="../../static/favicons/apple-touch-icon.png?cachebust=759f03fc15b30d6368ce2e93b7017b1d9cee9a73 ">
42+ < link rel ="icon " type ="image/png " sizes ="32x32 " href ="../../static/favicons/favicon-32x32.png?cachebust=759f03fc15b30d6368ce2e93b7017b1d9cee9a73 ">
43+ < link rel ="icon " type ="image/png " sizes ="16x16 " href ="../../static/favicons/favicon-16x16.png?cachebust=759f03fc15b30d6368ce2e93b7017b1d9cee9a73 ">
44+ < link rel ="manifest " href ="../../manifest.json?cachebust=759f03fc15b30d6368ce2e93b7017b1d9cee9a73 ">
45+ < meta name ="theme-color " content ="#f5f8fc ">
46+
47+ < link rel ="stylesheet " href ="../../static/pygments/default.css?cachebust=759f03fc15b30d6368ce2e93b7017b1d9cee9a73 ">
48+ <!-- <link rel="stylesheet" href="../../static/css/root.css"> -->
49+
50+
51+
52+
53+
54+ < link href ="../../static/kunai/css/kunai-stage-0.css?cachebust=759f03fc15b30d6368ce2e93b7017b1d9cee9a73 " rel ="stylesheet ">
55+ < link href ="../../static/kunai/css/kunai-stage-1.css?cachebust=759f03fc15b30d6368ce2e93b7017b1d9cee9a73 " rel ="stylesheet ">
56+ < link href ="../../static/kunai/css/kunai-stage-2.css?cachebust=759f03fc15b30d6368ce2e93b7017b1d9cee9a73 " rel ="stylesheet ">
57+ < link href ="../../static/kunai/css/kunai-stage-3.css?cachebust=759f03fc15b30d6368ce2e93b7017b1d9cee9a73 " rel ="stylesheet ">
58+
59+ < script type ="text/javascript " src ="../../static/kunai/js/kunai-vendor.js?cachebust=759f03fc15b30d6368ce2e93b7017b1d9cee9a73 "> </ script >
60+ < script type ="text/javascript " src ="../../static/kunai/js/kunai.js?cachebust=759f03fc15b30d6368ce2e93b7017b1d9cee9a73 "> </ script >
61+
62+ < script type ="text/javascript ">
63+ document . addEventListener ( 'DOMContentLoaded' , function ( ) {
64+ var kn = new Kunai ;
65+ kn . cpprefjp ( ) ;
66+ } ) ;
67+ </ script >
68+
69+ </ head >
70+ < body >
71+ < header data-kunai-mdinfo ="{"meta": {"header": ["cstdlib"], "namespace": ["std"], "id-type": ["function"]}, "sources": [{"id": "09ad68cf80f1b31ea942f7955f5c148e8521c820", "source": "#include <iostream>\n#include <cstdlib>\n#include <clocale>\n\nint main() {\n std::setlocale(LC_ALL, \"ja_JP.UTF-8\");\n const char *str = \"\u3053\u3093\u306b\u3061\u306f\";\n int result = std::mblen(str, MB_CUR_MAX);\n std::cout << result << std::endl;\n return 0;\n}\n"}, {"id": "ab1990ecb189149772909ce3d4b8510a55045092", "source": "#include <iostream>\n#include <cstdlib>\n#include <clocale>\n\nint count_chars_mblen(const char* s) {\n std::setlocale(LC_ALL, \"ja_JP.UTF-8\");\n int count = 0;\n size_t i = 0;\n while (s[i] != '\\0') {\n int len = std::mblen(&s[i], MB_CUR_MAX);\n if (len < 0) {\n len = 1;\n }\n i += len;\n count++;\n }\n return count;\n}\n\nint main() {\n const char* str = \"\u3053\u3093\u306b\u3061\u306f\u4e16\u754c\";\n std::cout << \"\u6587\u5b57\u5217: \" << str << \"\\n\";\n std::cout << \"\u6587\u5b57\u6570: \" << count_chars_mblen(str) << \"\\n\";\n}\n"}], "page_id": ["reference", "cstdlib", "mblen"]} ">
72+ < nav class ="navbar navbar-default " role ="navigation ">
73+ < div class ="container-fluid ">
74+ < div class ="navbar-header ">
75+ < button type ="button " class ="navbar-toggle collapsed " data-toggle ="collapse " data-target ="#navbar-collapse ">
76+ < span class ="sr-only "> Toggle navigation</ span >
77+ < span class ="icon-bar "> </ span >
78+ < span class ="icon-bar "> </ span >
79+ < span class ="icon-bar "> </ span >
80+ </ button >
81+ < a class ="navbar-brand " href ="../../index.html ">
82+ < div class ="title-wrapper clearfix ">
83+ < div class ="title "> cpprefjp - C++日本語リファレンス</ div >
84+ </ div >
85+ </ a >
86+ </ div >
87+
88+ < div class ="collapse navbar-collapse " id ="navbar-collapse ">
89+ < ul class ="nav navbar-nav navbar-right ">
90+ < li >
91+ < div class ="google-search ">
92+
93+
94+ < script >
95+ ( function ( ) {
96+ var cx = '013316413321391058734:ji_u66hl7hq' ;
97+ var gcse = document . createElement ( 'script' ) ;
98+ gcse . type = 'text/javascript' ;
99+ gcse . async = true ;
100+ gcse . src = ( document . location . protocol == 'https:' ? 'https:' : 'http:' ) +
101+ '//www.google.com/cse/cse.js?cx=' + cx ;
102+ var s = document . getElementsByTagName ( 'script' ) [ 0 ] ;
103+ s . parentNode . insertBefore ( gcse , s ) ;
104+ } ) ( ) ;
105+ </ script >
106+ < div class ="gcse-search "> </ div >
107+
108+
109+ </ div >
110+ </ li >
111+ < li >
112+ < a href ="https://github.com/cpprefjp/site "> GitHub Project</ a >
113+ </ li >
114+ </ ul >
115+ </ div >
116+ </ div >
117+ </ nav >
118+ </ header >
119+
120+ < main id ="main " role ="main ">
121+ < div class ="container-fluid ">
122+ < div class ="row ">
123+ < div class ="col-sm-9 col-sm-push-3 " itemscope itemtype ="http://schema.org/Article ">
124+ < div class ="row ">
125+ < div class ="col-sm-12 google-search-result ">
126+ < gcse:searchresults > </ gcse:searchresults >
127+ </ div >
128+ </ div >
129+ < div class ="row ">
130+ < div class ="col-sm-12 content-header ">
131+
132+ < ol class ="breadcrumb ">
133+
134+ < li itemscope itemtype ="http://www.schema.org/SiteNavigationElement ">
135+ < span >
136+
137+ < a href ="../../index.html " itemprop ="url ">
138+
139+ < i class ="fa fa-fw fa-home "> </ i >
140+
141+ </ a >
142+
143+ </ span >
144+ </ li >
145+
146+ < li itemscope itemtype ="http://www.schema.org/SiteNavigationElement ">
147+ < span >
148+
149+ < a href ="../../reference.html " itemprop ="url ">
150+
151+ < span itemprop ="name "> リファレンス</ span >
152+
153+ </ a >
154+
155+ </ span >
156+ </ li >
157+
158+ < li itemscope itemtype ="http://www.schema.org/SiteNavigationElement ">
159+ < span >
160+
161+ < a href ="../../reference/cstdlib.html " itemprop ="url ">
162+
163+ < span itemprop ="name "> cstdlib</ span >
164+
165+ </ a >
166+
167+ </ span >
168+ </ li >
169+
170+ < li class ="active " itemscope itemtype ="http://www.schema.org/SiteNavigationElement ">
171+ < span >
172+
173+
174+ < span itemprop ="name "> mblen</ span >
175+
176+
177+ </ span >
178+ </ li >
179+
180+ </ ol >
181+ < div class ="crsearch "> </ div >
182+
183+ </ div >
184+ </ div >
185+ < div class ="row ">
186+ < div class ="col-sm-12 edit-button ">
187+
188+
189+ < p class ="text-right "> < small >
190+ 最終更新日時(UTC):
191+ < span itemprop ="datePublished " content ="2025-12-03T00:51:04 ">
192+ 2025年12月03日 00時51分04秒
193+ </ span >
194+ < br />
195+ < span itemprop ="author " itemscope itemtype ="http://schema.org/Person ">
196+ < span itemprop ="name "> K10-K10</ span >
197+ </ span >
198+ が更新
199+ </ small > </ p >
200+
201+
202+ < p class ="text-right ">
203+ < a class ="history " target ="_blank " href ="https://github.com/cpprefjp/site/commits/master/reference/cstdlib/mblen.md ">
204+ < span class ="fa fa-fw fa-clock-o fa-flip-horizontal "> </ span > 履歴
205+ </ a >
206+ < a class ="edit " target ="_blank " href ="https://github.com/cpprefjp/site/edit/master/reference/cstdlib/mblen.md ">
207+ < span class ="fa fa-fw fa-pencil "> </ span > 編集
208+ </ a >
209+ </ p >
210+ </ div >
211+ </ div >
212+ < div class ="row ">
213+ < div class ="col-sm-12 content-body ">
214+
215+ < div class ="identifier-type "> function</ div > < div class ="header "> <cstdlib></ div > < h1 itemprop ="name "> < span class ="namespace " title ="namespace std "> std::</ span > < span class ="token "> mblen</ span > </ h1 >
216+ < div itemprop ="articleBody "> < p > < div class ="codehilite "> < pre > < span > </ span > < code > < span class ="k "> namespace</ span > < span class ="n "> std</ span > < span class ="p "> {</ span >
217+ < span class ="kt "> int</ span > < span class ="n "> mblen</ span > < span class ="p "> (</ span > < span class ="k "> const</ span > < span class ="kt "> char</ span > < span class ="o "> *</ span > < span class ="n "> str</ span > < span class ="p "> ,</ span > < span class ="kt "> size_t</ span > < span class ="n "> n</ span > < span class ="p "> );</ span >
218+ < span class ="p "> }</ span >
219+ </ code > </ pre > </ div >
220+ </ p >
221+ < h2 > 概要</ h2 >
222+ < p > マルチバイト文字列の先頭の文字が占めるバイト数を返す。</ p >
223+ < p > 先頭以外の文字に関するバイト数は計算されない。</ p >
224+ < p > この関数は現在のロケールに依存してマルチバイト文字を解釈する。</ p >
225+ < p > < code > n</ code > は解析に使用する最大バイト数を指定する。</ p >
226+ < h2 > < a class ="cpprefjp-defined-word " data-desc ="関数呼び出し式の評価結果となるオブジェクト・値 "> 戻り値</ a > </ h2 >
227+ < ul >
228+ < li > 正常に動作する場合、文字の占めるバイト数を返す。</ li >
229+ < li > < code > str</ code > が< code > nullptr</ code > の時、内部状態を初期化し< code > 0</ code > を返す。</ li >
230+ < li > 無効な文字列、または< code > n</ code > が不足している場合、< code > -1</ code > を返す。</ li >
231+ </ ul >
232+ < h2 > 例</ h2 >
233+ < h3 > 基本的な使い方</ h3 >
234+ < p > < div class ="yata " id ="09ad68cf80f1b31ea942f7955f5c148e8521c820 "> < div class ="codehilite "> < pre > < span > </ span > < code > < span class ="cp "> #include</ span > < span class ="cpf "> < a href ="../iostream.html "> <iostream></ a > </ span > < span class ="cp "> </ span >
235+ < span class ="cp "> #include</ span > < span class ="cpf "> < a href ="../cstdlib.html "> <cstdlib></ a > </ span > < span class ="cp "> </ span >
236+ < span class ="cp "> #include</ span > < span class ="cpf "> <clocale></ span > < span class ="cp "> </ span >
237+
238+ < span class ="kt "> int</ span > < span class ="nf "> main</ span > < span class ="p "> ()</ span > < span class ="p "> {</ span >
239+ < span class ="n "> std</ span > < span class ="o "> ::</ span > < span class ="n "> setlocale</ span > < span class ="p "> (</ span > < span class ="n "> LC_ALL</ span > < span class ="p "> ,</ span > < span class ="s "> "ja_JP.UTF-8"</ span > < span class ="p "> );</ span >
240+ < span class ="k "> const</ span > < span class ="kt "> char</ span > < span class ="o "> *</ span > < span class ="n "> str</ span > < span class ="o "> =</ span > < span class ="s "> "こんにちは"</ span > < span class ="p "> ;</ span >
241+ < span class ="kt "> int</ span > < span class ="n "> result</ span > < span class ="o "> =</ span > < span class ="n "> std</ span > < span class ="o "> ::</ span > < span class ="n "> mblen</ span > < span class ="p "> (</ span > < span class ="n "> str</ span > < span class ="p "> ,</ span > < span class ="n "> MB_CUR_MAX</ span > < span class ="p "> );</ span >
242+ < span class ="n "> < a href ="../iostream/cout.html "> std::cout</ a > </ span > < span class ="o "> <<</ span > < span class ="n "> result</ span > < span class ="o "> <<</ span > < span class ="n "> < a href ="../ostream/endl.html "> std::endl</ a > </ span > < span class ="p "> ;</ span >
243+ < span class ="k "> return</ span > < span class ="mi "> 0</ span > < span class ="p "> ;</ span >
244+ < span class ="p "> }</ span >
245+ </ code > </ pre > </ div >
246+ </ div > </ p >
247+ < h4 > 出力例</ h4 >
248+ < p > < pre > < code > 3
249+ </ code > </ pre > </ p >
250+ < h3 > 文字列の文字数を計算する</ h3 >
251+ < p > < div class ="yata " id ="ab1990ecb189149772909ce3d4b8510a55045092 "> < div class ="codehilite "> < pre > < span > </ span > < code > < span class ="cp "> #include</ span > < span class ="cpf "> < a href ="../iostream.html "> <iostream></ a > </ span > < span class ="cp "> </ span >
252+ < span class ="cp "> #include</ span > < span class ="cpf "> < a href ="../cstdlib.html "> <cstdlib></ a > </ span > < span class ="cp "> </ span >
253+ < span class ="cp "> #include</ span > < span class ="cpf "> <clocale></ span > < span class ="cp "> </ span >
254+
255+ < span class ="kt "> int</ span > < span class ="nf "> count_chars_mblen</ span > < span class ="p "> (</ span > < span class ="k "> const</ span > < span class ="kt "> char</ span > < span class ="o "> *</ span > < span class ="n "> s</ span > < span class ="p "> )</ span > < span class ="p "> {</ span >
256+ < span class ="n "> std</ span > < span class ="o "> ::</ span > < span class ="n "> setlocale</ span > < span class ="p "> (</ span > < span class ="n "> LC_ALL</ span > < span class ="p "> ,</ span > < span class ="s "> "ja_JP.UTF-8"</ span > < span class ="p "> );</ span >
257+ < span class ="kt "> int</ span > < span class ="n "> count</ span > < span class ="o "> =</ span > < span class ="mi "> 0</ span > < span class ="p "> ;</ span >
258+ < span class ="kt "> size_t</ span > < span class ="n "> i</ span > < span class ="o "> =</ span > < span class ="mi "> 0</ span > < span class ="p "> ;</ span >
259+ < span class ="k "> while</ span > < span class ="p "> (</ span > < span class ="n "> s</ span > < span class ="p "> [</ span > < span class ="n "> i</ span > < span class ="p "> ]</ span > < span class ="o "> !=</ span > < span class ="sc "> '\0'</ span > < span class ="p "> )</ span > < span class ="p "> {</ span >
260+ < span class ="kt "> int</ span > < span class ="n "> len</ span > < span class ="o "> =</ span > < span class ="n "> std</ span > < span class ="o "> ::</ span > < span class ="n "> mblen</ span > < span class ="p "> (</ span > < span class ="o "> &</ span > < span class ="n "> s</ span > < span class ="p "> [</ span > < span class ="n "> i</ span > < span class ="p "> ],</ span > < span class ="n "> MB_CUR_MAX</ span > < span class ="p "> );</ span >
261+ < span class ="k "> if</ span > < span class ="p "> (</ span > < span class ="n "> len</ span > < span class ="o "> <</ span > < span class ="mi "> 0</ span > < span class ="p "> )</ span > < span class ="p "> {</ span >
262+ < span class ="n "> len</ span > < span class ="o "> =</ span > < span class ="mi "> 1</ span > < span class ="p "> ;</ span >
263+ < span class ="p "> }</ span >
264+ < span class ="n "> i</ span > < span class ="o "> +=</ span > < span class ="n "> len</ span > < span class ="p "> ;</ span >
265+ < span class ="n "> count</ span > < span class ="o "> ++</ span > < span class ="p "> ;</ span >
266+ < span class ="p "> }</ span >
267+ < span class ="k "> return</ span > < span class ="n "> count</ span > < span class ="p "> ;</ span >
268+ < span class ="p "> }</ span >
269+
270+ < span class ="kt "> int</ span > < span class ="nf "> main</ span > < span class ="p "> ()</ span > < span class ="p "> {</ span >
271+ < span class ="k "> const</ span > < span class ="kt "> char</ span > < span class ="o "> *</ span > < span class ="n "> str</ span > < span class ="o "> =</ span > < span class ="s "> "こんにちは世界"</ span > < span class ="p "> ;</ span >
272+ < span class ="n "> < a href ="../iostream/cout.html "> std::cout</ a > </ span > < span class ="o "> <<</ span > < span class ="s "> "文字列: "</ span > < span class ="o "> <<</ span > < span class ="n "> str</ span > < span class ="o "> <<</ span > < span class ="s "> "</ span > < span class ="se "> \n</ span > < span class ="s "> "</ span > < span class ="p "> ;</ span >
273+ < span class ="n "> < a href ="../iostream/cout.html "> std::cout</ a > </ span > < span class ="o "> <<</ span > < span class ="s "> "文字数: "</ span > < span class ="o "> <<</ span > < span class ="n "> count_chars_mblen</ span > < span class ="p "> (</ span > < span class ="n "> str</ span > < span class ="p "> )</ span > < span class ="o "> <<</ span > < span class ="s "> "</ span > < span class ="se "> \n</ span > < span class ="s "> "</ span > < span class ="p "> ;</ span >
274+ < span class ="p "> }</ span >
275+ </ code > </ pre > </ div >
276+ </ div > </ p >
277+ < h4 > 出力例</ h4 >
278+ < p > < pre > < code > 文字列: こんにちは世界
279+ 文字数: 7
280+ </ code > </ pre > </ p > </ div >
281+
282+ </ div >
283+ </ div >
284+ </ div >
285+
286+
287+ < div id ="sidebar " class ="col-sm-3 col-sm-pull-9 ">
288+ </ div >
289+
290+
291+ </ div >
292+ </ div >
293+ </ main >
294+ < footer class ="footer navbar navbar-default ">
295+ < div class ="container-fluid ">
296+ < p > < small >
297+ 本サイトの情報は、
298+ < a href ="https://creativecommons.org/licenses/by/3.0/deed.ja " rel ="nofollow "> クリエイティブ・コモンズ 表示 3.0 非移植 ライセンス(CC BY)</ a >
299+ の下に提供されています。
300+ </ small > </ p >
301+ </ div >
302+ </ footer >
303+ </ body >
304+ </ html >
0 commit comments