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=Shift_JIS">
5 <meta http-equiv=
"Content-Style-Type" content=
"text/css">
6 <link rel=
"up" title=
"FatFs" href=
"../00index_j.html">
7 <link rel=
"alternate" hreflang=
"en" title=
"English" href=
"../en/open.html">
8 <link rel=
"stylesheet" href=
"../css_j.css" type=
"text/css" media=
"screen" title=
"ELM Default">
9 <title>FatFs - f_open
</title>
14 <div class=
"para func">
16 <p>\83t
\83@
\83C
\83\8b\82ð
\83I
\81[
\83v
\83\93\82Ü
\82½
\82Í
\8dì
\90¬
\82µ
\82Ü
\82·
\81B
</p>
19 FIL*
<span class=
"arg">fp
</span>,
<span class=
"c">/* [OUT]
\8bó
\82Ì
\83t
\83@
\83C
\83\8b\81E
\83I
\83u
\83W
\83F
\83N
\83g
\8d\
\91¢
\91Ì
\82Ö
\82Ì
\83|
\83C
\83\93\83^ */
</span>
20 const TCHAR*
<span class=
"arg">path
</span>,
<span class=
"c">/* [IN]
\83t
\83@
\83C
\83\8b\96¼
\82Ö
\82Ì
\83|
\83C
\83\93\83^ */
</span>
21 BYTE
<span class=
"arg">mode
</span> <span class=
"c">/* [IN]
\83\82\81[
\83h
\83t
\83\89\83O */
</span>
26 <div class=
"para arg">
30 <dd>\90V
\82µ
\82
\8dì
\90¬
\82·
\82é
\83t
\83@
\83C
\83\8b\81E
\83I
\83u
\83W
\83F
\83N
\83g
\8d\
\91¢
\91Ì
\82Ö
\82Ì
\83|
\83C
\83\93\83^
\82ð
\8ew
\92è
\82µ
\82Ü
\82·
\81B
\88È
\8d~
\81A
\82»
\82Ì
\83t
\83@
\83C
\83\8b\82ð
\95Â
\82¶
\82é
\82Ü
\82Å
\82±
\82Ì
\83t
\83@
\83C
\83\8b\81E
\83I
\83u
\83W
\83F
\83N
\83g
\82ð
\8eg
\97p
\82µ
\82Ä
\83t
\83@
\83C
\83\8b\91\80\8dì
\82ð
\82µ
\82Ü
\82·
\81B
</dd>
32 <dd>\8aJ
\82
\83t
\83@
\83C
\83\8b\82Ì
<a href=
"filename.html">\83t
\83@
\83C
\83\8b\96¼
</a>\82ð
\8e¦
\82·
\83k
\83\8b\95¶
\8e\9a<tt>'\
0'
</tt>\8fI
\92[
\82Ì
\95¶
\8e\9a\97ñ
\82Ö
\82Ì
\83|
\83C
\83\93\83^
\82ð
\8ew
\92è
\82µ
\82Ü
\82·
\81B
</dd>
34 <dd>\83t
\83@
\83C
\83\8b\82Ì
\83A
\83N
\83Z
\83X
\95û
\96@
\82â
\83I
\81[
\83v
\83\93\95û
\96@
\82ð
\8c\88\82ß
\82é
\83t
\83\89\83O
\82Å
\82·
\81B
\82±
\82Ì
\83p
\83\89\83\81\81[
\83^
\82É
\82Í
\8e\9f\82Ì
\91g
\82Ý
\8d\87\82í
\82¹
\82ð
\8ew
\92è
\82µ
\82Ü
\82·
\81B
<br>
36 <tr><th>\92l
</th><th>\88Ó
\96¡
</th></tr>
37 <tr><td>FA_READ
</td><td>\93Ç
\82Ý
\8fo
\82µ
\83\82\81[
\83h
\82Å
\8aJ
\82«
\82Ü
\82·
\81B
\93Ç
\82Ý
\8f\91\82«
\82·
\82é
\8fê
\8d\87\82Í
<tt>FA_WRITE
</tt>\82Æ
\8b¤
\82É
\8ew
\92è
\82µ
\82Ü
\82·
\81B
</td></tr>
38 <tr><td>FA_WRITE
</td><td>\8f\91\82«
\8d\9e\82Ý
\83\82\81[
\83h
\82Å
\8aJ
\82«
\82Ü
\82·
\81B
\93Ç
\82Ý
\8f\91\82«
\82·
\82é
\8fê
\8d\87\82Í
<tt>FA_READ
</tt>\82Æ
\8b¤
\82É
\8ew
\92è
\82µ
\82Ü
\82·
\81B
</td></tr>
39 <tr><td>FA_OPEN_EXISTING
</td><td>\8aù
\91¶
\82Ì
\83t
\83@
\83C
\83\8b\82ð
\8aJ
\82«
\82Ü
\82·
\81B
\83t
\83@
\83C
\83\8b\82ª
\96³
\82¢
\82Æ
\82«
\82Í
\83G
\83\89\81[
\82É
\82È
\82è
\82Ü
\82·
\81B(
\83f
\83t
\83H
\83\8b\83g)
</td></tr>
40 <tr><td>FA_OPEN_ALWAYS
</td><td>\8aù
\91¶
\82Ì
\83t
\83@
\83C
\83\8b\82ð
\8aJ
\82«
\82Ü
\82·
\81B
\83t
\83@
\83C
\83\8b\82ª
\96³
\82¢
\82Æ
\82«
\82Í
\83t
\83@
\83C
\83\8b\82ð
\8dì
\90¬
\82µ
\82Ü
\82·
\81B
\92Ç
\8bL
\82Ì
\8fê
\8d\87\82Í
\81A
\82±
\82Ì
\95û
\96@
\82Å
\83I
\81[
\83v
\83\93\82µ
\82½
\8cã
\81A
<a href=
"lseek.html"><tt>f_lseek()
</tt></a>\82Å
\83t
\83@
\83C
\83\8b\82Ì
\8dÅ
\8cã
\94ö
\82É
\88Ú
\93®
\82µ
\82Ä
\82
\82¾
\82³
\82¢
\81B
</td></tr>
41 <tr><td>FA_CREATE_NEW
</td><td>\83t
\83@
\83C
\83\8b\82ð
\8dì
\90¬
\82µ
\82Ü
\82·
\81B
\93¯
\96¼
\82Ì
\83t
\83@
\83C
\83\8b\82ª
\82 \82é
\8fê
\8d\87\82Í
\81A
<tt>FR_EXIST
</tt>\82Å
\8e¸
\94s
\82µ
\82Ü
\82·
\81B
</td></tr>
42 <tr><td>FA_CREATE_ALWAYS
</td><td>\83t
\83@
\83C
\83\8b\82ð
\8dì
\90¬
\82µ
\82Ü
\82·
\81B
\93¯
\96¼
\82Ì
\83t
\83@
\83C
\83\8b\82ª
\82 \82é
\8fê
\8d\87\82Í
\81A
\83T
\83C
\83Y
\82ð
0\82É
\82µ
\82Ä
\82©
\82ç
\8aJ
\82«
\82Ü
\82·
\81B
</td></tr>
49 <div class=
"para ret">
52 <a href=
"rc.html#ok">FR_OK
</a>,
53 <a href=
"rc.html#de">FR_DISK_ERR
</a>,
54 <a href=
"rc.html#ie">FR_INT_ERR
</a>,
55 <a href=
"rc.html#nr">FR_NOT_READY
</a>,
56 <a href=
"rc.html#ok">FR_NO_FILE
</a>,
57 <a href=
"rc.html#np">FR_NO_PATH
</a>,
58 <a href=
"rc.html#in">FR_INVALID_NAME
</a>,
59 <a href=
"rc.html#de">FR_DENIED
</a>,
60 <a href=
"rc.html#ex">FR_EXIST
</a>,
61 <a href=
"rc.html#io">FR_INVALID_OBJECT
</a>,
62 <a href=
"rc.html#wp">FR_WRITE_PROTECTED
</a>,
63 <a href=
"rc.html#id">FR_INVALID_DRIVE
</a>,
64 <a href=
"rc.html#ne">FR_NOT_ENABLED
</a>,
65 <a href=
"rc.html#ns">FR_NO_FILESYSTEM
</a>,
66 <a href=
"rc.html#tm">FR_TIMEOUT
</a>,
67 <a href=
"rc.html#lo">FR_LOCKED
</a>,
68 <a href=
"rc.html#nc">FR_NOT_ENOUGH_CORE
</a>,
69 <a href=
"rc.html#tf">FR_TOO_MANY_OPEN_FILES
</a>
74 <div class=
"para desc">
76 <p>\8aù
\91¶
\82Ì
\83t
\83@
\83C
\83\8b\82ð
\8aJ
\82¢
\82½
\82è
\81A
\90V
\82µ
\82¢
\83t
\83@
\83C
\83\8b\82ð
\8dì
\90¬
\82µ
\82Ü
\82·
\81B
\8aÖ
\90\94\82ª
\90¬
\8c÷
\82·
\82é
\82Æ
\83t
\83@
\83C
\83\8b\81E
\83I
\83u
\83W
\83F
\83N
\83g
\82ª
\8dì
\90¬
\82³
\82ê
\81A
\88È
\8d~
\82»
\82Ì
\83t
\83@
\83C
\83\8b\82É
\91Î
\82·
\82é
\83A
\83N
\83Z
\83X
\82É
\8eg
\97p
\82µ
\82Ü
\82·
\81B
\83t
\83@
\83C
\83\8b\82ð
\95Â
\82¶
\82é
\82Æ
\82«
\82Í
\81A
<a href=
"close.html"><tt>f_close()
</tt></a>\82ð
\8eg
\97p
\82µ
\82Ü
\82·
\81B
\89½
\82ç
\82©
\82Ì
\95Ï
\8dX
\82ª
\8ds
\82í
\82ê
\82½
\83t
\83@
\83C
\83\8b\82ª
\82»
\82Ì
\8cã
\90³
\82µ
\82
\95Â
\82¶
\82ç
\82ê
\82È
\82©
\82Á
\82½
\8fê
\8d\87\81A
\82»
\82Ì
\83t
\83@
\83C
\83\8b\82ª
\94j
\91¹
\82·
\82é
\8fê
\8d\87\82ª
\82 \82è
\82Ü
\82·
\81B
</p>
77 <p>\8aù
\82É
\8aJ
\82©
\82ê
\82Ä
\82¢
\82é
\83t
\83@
\83C
\83\8b\82ð
\8aJ
\82
\95K
\97v
\82ª
\82 \82é
\8fê
\8d\87\82Í
\81A
<a href=
"appnote.html#dup">\91½
\8fd
\83A
\83N
\83Z
\83X
\90§
\8cä
</a>\82ð
\8eQ
\8fÆ
\82µ
\82Ä
\82
\82¾
\82³
\82¢
\81B
\82µ
\82©
\82µ
\81A
\88ê
\82Â
\82Ì
\83t
\83@
\83C
\83\8b\82É
\91Î
\82·
\82é
\8f\91\82«
\8d\9e\82Ý
\83\82\81[
\83h
\82ð
\8aÜ
\82Þ
\8fd
\95¡
\83I
\81[
\83v
\83\93\82Í
\8fí
\82É
\8bÖ
\8e~
\82Å
\82·
\81B
</p>
78 <p>\83t
\83@
\83C
\83\8b\81E
\83A
\83N
\83Z
\83X
\82ð
\8aJ
\8en
\82·
\82é
\91O
\82É
\81A
<a href=
"mount.html"><tt>f_mount()
</tt></a>\82ð
\8eg
\82Á
\82Ä
\82»
\82ê
\82¼
\82ê
\82Ì
\98_
\97\9d\83h
\83\89\83C
\83u
\82É
\83\8f\81[
\83N
\81E
\83G
\83\8a\83A(
\83t
\83@
\83C
\83\8b\81E
\83V
\83X
\83e
\83\80\81E
\83I
\83u
\83W
\83F
\83N
\83g)
\82ð
\97^
\82¦
\82é
\95K
\97v
\82ª
\82 \82è
\82Ü
\82·
\81B
\82±
\82Ì
\8f\89\8aú
\89»
\82Ì
\8cã
\81A
\82»
\82Ì
\98_
\97\9d\83h
\83\89\83C
\83u
\82É
\91Î
\82µ
\82Ä
\91S
\82Ä
\82Ì
\83t
\83@
\83C
\83\8b\8aÖ
\90\94\82ª
\8eg
\82¦
\82é
\82æ
\82¤
\82É
\82È
\82è
\82Ü
\82·
\81B
</p>
82 <div class=
"para comp">
83 <h4>\91Î
\89\9e\8fî
\95ñ
</h4>
84 <p>\91S
\82Ä
\82Ì
\8d\
\90¬
\82Å
\8eg
\97p
\89Â
\94\
\82Å
\82·
\81B
<tt>_FS_READONLY ==
1</tt>\82Ì
\82Æ
\82«
\82Í
\81A
<tt>FA_WRITE, FA_CREATE_ALWAYS, FA_CREATE_NEW, FA_OPEN_ALWAYS
</tt>\82Ì
\8ae
\83t
\83\89\83O
\82Í
\83T
\83|
\81[
\83g
\82³
\82ê
\82Ü
\82¹
\82ñ
\81B
</p>
88 <div class=
"para use">
91 <span class=
"c">/*
\83e
\83L
\83X
\83g
\83t
\83@
\83C
\83\8b\82ð
\93Ç
\82Ý
\8fo
\82µ
\82Ä
\95\
\8e¦ */
</span>
93 FATFS FatFs;
<span class=
"c">/*
\98_
\97\9d\83h
\83\89\83C
\83u
\82Ì
\83\8f\81[
\83N
\81E
\83G
\83\8a\83A(
\83t
\83@
\83C
\83\8b\81E
\83V
\83X
\83e
\83\80\81E
\83I
\83u
\83W
\83F
\83N
\83g) */
</span>
97 FIL fil;
<span class=
"c">/*
\83t
\83@
\83C
\83\8b\81E
\83I
\83u
\83W
\83F
\83N
\83g */
</span>
98 char line[
82];
<span class=
"c">/*
\8ds
\83o
\83b
\83t
\83@ */
</span>
99 FRESULT fr;
<span class=
"c">/*
\96ß
\82è
\92l */
</span>
102 <span class=
"c">/*
\83f
\83t
\83H
\83\8b\83g
\81E
\83h
\83\89\83C
\83u
\82É
\83\8f\81[
\83N
\83G
\83\8a\83A
\82ð
\97^
\82¦
\82é */
</span>
103 f_mount(
&FatFs,
"",
0);
105 <span class=
"c">/*
\83e
\83L
\83X
\83g
\81E
\83t
\83@
\83C
\83\8b\82ð
\8aJ
\82 */
</span>
106 fr = f_open(
&fil,
"message.txt", FA_READ);
107 if (fr) return (int)fr;
109 <span class=
"c">/*
1\8ds
\82¸
\82Â
\93Ç
\82Ý
\8fo
\82µ
\82Ä
\95\
\8e¦ */
</span>
110 while (f_gets(line, sizeof line,
&fil))
113 <span class=
"c">/*
\83t
\83@
\83C
\83\8b\82ð
\95Â
\82¶
\82é */
</span>
120 <span class=
"c">/*
\83h
\83\89\83C
\83u1
\82Ì
\83t
\83@
\83C
\83\8b "file.bin" \82ð
\83h
\83\89\83C
\83u0
\82Ö
\83R
\83s
\81[ */
</span>
124 FATFS fs[
2];
<span class=
"c">/*
\98_
\97\9d\83h
\83\89\83C
\83u
\82Ì
\83\8f\81[
\83N
\83G
\83\8a\83A(
\83t
\83@
\83C
\83\8b\81E
\83V
\83X
\83e
\83\80\81E
\83I
\83u
\83W
\83F
\83N
\83g) */
</span>
125 FIL fsrc, fdst;
<span class=
"c">/*
\83t
\83@
\83C
\83\8b\81E
\83I
\83u
\83W
\83F
\83N
\83g */
</span>
126 BYTE buffer[
4096];
<span class=
"c">/* File copy buffer */
</span>
127 FRESULT fr;
<span class=
"c">/* FatFs function common result code */
</span>
128 UINT br, bw;
<span class=
"c">/* File R/W count */
</span>
130 <span class=
"c">/*
\83h
\83\89\83C
\83u0,
1\82É
\83\8f\81[
\83N
\81E
\83G
\83\8a\83A
\82ð
\97^
\82¦
\82é */
</span>
131 f_mount(
&fs[
0],
"0:",
0);
132 f_mount(
&fs[
1],
"1:",
0);
134 <span class=
"c">/*
\83h
\83\89\83C
\83u1
\82Ì
\83R
\83s
\81[
\8c³
\83t
\83@
\83C
\83\8b\82ð
\8aJ
\82 */
</span>
135 res = f_open(
&fsrc,
"1:file.dat", FA_OPEN_EXISTING | FA_READ);
136 if (fr) return (int)fr;
138 <span class=
"c">/*
\83h
\83\89\83C
\83u0
\82É
\83R
\83s
\81[
\90æ
\83t
\83@
\83C
\83\8b\82ð
\8dì
\90¬
\82·
\82é */
</span>
139 res = f_open(
&fdst,
"0:file.dat", FA_CREATE_ALWAYS | FA_WRITE);
140 if (fr) return (int)fr;
142 <span class=
"c">/*
\83R
\83s
\81[
\8c³
\82©
\82ç
\83R
\83s
\81[
\90æ
\82É
\83f
\81[
\83^
\93]
\91\97\82·
\82é */
</span>
144 res = f_read(
&fsrc, buffer, sizeof buffer,
&br);
<span class=
"c">/*
\83R
\83s
\81[
\8c³
\82©
\82ç
\82©
\82ç
\93Ç
\82Ý
\8fo
\82· */
</span>
145 if (res || br ==
0) break;
<span class=
"c">/*
\83G
\83\89\81[
\82©
\83t
\83@
\83C
\83\8b\8fI
\92[ */
</span>
146 res = f_write(
&fdst, buffer, br,
&bw);
<span class=
"c">/*
\82»
\82ê
\82ð
\83R
\83s
\81[
\90æ
\82É
\8f\91\82«
\8d\9e\82Þ */
</span>
147 if (res || bw
< br) break;
<span class=
"c">/*
\83G
\83\89\81[
\82©
\83f
\83B
\83X
\83N
\96\9e\94t */
</span>
150 <span class=
"c">/*
\91S
\82Ä
\82Ì
\83t
\83@
\83C
\83\8b\82ð
\95Â
\82¶
\82é */
</span>
154 <span class=
"c">/*
\83\8f\81[
\83N
\81E
\83G
\83\8a\83A
\82ð
\8aJ
\95ú
\82·
\82é */
</span>
155 f_mount(NULL,
"0:",
0);
156 f_mount(NULL,
"1:",
0);
164 <div class=
"para ref">
166 <p><tt><a href=
"read.html">f_read
</a>,
<a href=
"write.html">f_write
</a>,
<a href=
"close.html">f_close
</a>,
<a href=
"sfile.html">FIL
</a>,
<a href=
"sfatfs.html">FATFS
</a></tt></p>
169 <p class=
"foot"><a href=
"../00index_j.html">\96ß
\82é
</a></p>