1 <!DOCTYPE HTML PUBLIC
"-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
4 <meta http-equiv=
"Content-Type" content=
"text/html; charset=utf-8">
5 <meta http-equiv=
"Content-Style-Type" content=
"text/css">
6 <link rel=
"up" title=
"FatFs" href=
"../00index_e.html">
7 <link rel=
"alternate" hreflang=
"ja" title=
"Japanese" href=
"../ja/getcwd.html">
8 <link rel=
"stylesheet" href=
"../css_e.css" type=
"text/css" media=
"screen" title=
"ELM Default">
9 <title>FatFs - f_setcp
</title>
14 <div class=
"para func">
16 <p>The f_setcp function sets the active code page.
</p>
19 WORD
<span class=
"arg">cp
</span> <span class=
"c">/* [IN] Code page to be set */
</span>
24 <div class=
"para arg">
28 <dd>OEM code page to be used for the path name. Valid values are as follows.
<br>
30 <tr><th>Value
</th><th>Meaning
</th></tr>
31 <tr><td>0</td><td>Initial value (any extended character cannot be used)
</td></tr>
32 <tr><td>437</td><td>U.S.
</td></tr>
33 <tr><td>720</td><td>Arabic
</td></tr>
34 <tr><td>737</td><td>Greek
</td></tr>
35 <tr><td>771</td><td>KBL
</td></tr>
36 <tr><td>775</td><td>Baltic
</td></tr>
37 <tr><td>850</td><td>Latin
1</td></tr>
38 <tr><td>852</td><td>Latin
2</td></tr>
39 <tr><td>855</td><td>Cyrillic
</td></tr>
40 <tr><td>857</td><td>Turkish
</td></tr>
41 <tr><td>860</td><td>Portuguese
</td></tr>
42 <tr><td>861</td><td>Icelandic
</td></tr>
43 <tr><td>862</td><td>Hebrew
</td></tr>
44 <tr><td>863</td><td>Canadian French
</td></tr>
45 <tr><td>864</td><td>Arabic
</td></tr>
46 <tr><td>865</td><td>Nordic
</td></tr>
47 <tr><td>866</td><td>Russian
</td></tr>
48 <tr><td>869</td><td>Greek
2</td></tr>
49 <tr><td>932</td><td>Japanese (DBCS)
</td></tr>
50 <tr><td>936</td><td>Simplified Chinese (DBCS)
</td></tr>
51 <tr><td>949</td><td>Korean (DBCS)
</td></tr>
52 <tr><td>950</td><td>Traditional Chinese (DBCS)
</td></tr>
59 <div class=
"para ret">
60 <h4>Return Values
</h4>
62 <a href=
"rc.html#ok">FR_OK
</a>,
63 <a href=
"rc.html#ip">FR_INVALID_PARAMETER
</a>
68 <div class=
"para desc">
70 <p>The
<tt>f_setcp
</tt> function sets the active code page for the path name. Also code conversion of string functions will be affected by the setting of code page when
<tt><a href=
"config.html#lfn_unicode">FF_LFN_UNICODE
</a> >=
1</tt> and
<tt><a href=
"config.html#strf_encode">FF_STRF_ENCODE
</a> ==
0</tt>. Because the initial setting of the code page is
0 and API function with extended character will not work properly, a valid code page needs to be set on the system start-up and it should not be changed on the fly.
</p>
74 <div class=
"para comp">
76 <p>Available when
<tt><a href=
"config.html#code_page">FF_CODE_PAGE
</a> ==
0</tt>.
</p>
80 <p class=
"foot"><a href=
"../00index_e.html">Return
</a></p>