FatFs - f

X-Git-Url: http://cloudbase.mooo.com/gitweb/z180-stamp.git/blobdiff_plain/70702af1370e44e32fb2c3c507e4759a187b4fe5..289f6a146c0b2087607d8d8659531ea90142779a:/fatfs/documents/doc/setcp.html diff --git a/fatfs/documents/doc/setcp.html b/fatfs/documents/doc/setcp.html new file mode 100644 index 0000000..a1d124b --- /dev/null +++ b/fatfs/documents/doc/setcp.html @@ -0,0 +1,82 @@ + + + + + + + + +FatFs - f_setcp + + + + +

f_setcp

The f_setcp function sets the active code page.

+FRESULT f_setcp (
+  WORD cp     /* [IN] Code page to be set */
+);
+

+ +

Parameters

cp

OEM code page to be used for the path name. Valid values are as follows.
+ + + + + + + + + + + + + + + + + + + + + + + + +

Value	Meaning
0	Initial value (any extended character cannot be used)
437	U.S.
720	Arabic
737	Greek
771	KBL
775	Baltic
850	Latin 1
852	Latin 2
855	Cyrillic
857	Turkish
860	Portuguese
861	Icelandic
862	Hebrew
863	Canadian French
864	Arabic
865	Nordic
866	Russian
869	Greek 2
932	Japanese (DBCS)
936	Simplified Chinese (DBCS)
949	Korean (DBCS)
950	Traditional Chinese (DBCS)

+ + +

Return Values

+FR_OK, +FR_INVALID_PARAMETER +

+ + +

Description

The f_setcp 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 FF_LFN_UNICODE >= 1 and FF_STRF_ENCODE == 0. 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.

+ + +

QuickInfo

Available when FF_CODE_PAGE == 0.

+ + +

Return

+ +