blob: 6be74972c1bedf7fb32781206627dfab170d44e3 [file] [log] [blame]
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html lang="ja">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=Shift_JIS">
<meta http-equiv="Content-Style-Type" content="text/css">
<link rel="up" title="FatFs" href="../00index_j.html">
<link rel="stylesheet" href="../css_j.css" type="text/css" media="screen" title="ELM Default">
<title>FatFs - f_open</title>
</head>
<body>
<div class="para">
<h2>f_open</h2>
<p>ƒtƒ@ƒCƒ‹‚ðƒI[ƒvƒ“‚Ü‚½‚͍쐬‚µ‚Ü‚·B</p>
<pre>
FRESULT f_open (
FIL* <em>FileObject</em>, /* ‹ó‚̃tƒ@ƒCƒ‹EƒIƒuƒWƒFƒNƒg\‘¢‘̂ւ̃|ƒCƒ“ƒ^ */
const XCHAR* <em>FileName</em>, /* ƒtƒ@ƒCƒ‹‚̃tƒ‹ƒpƒX–¼‚ւ̃|ƒCƒ“ƒ^ */
BYTE <em>ModeFlags</em> /* ƒ‚[ƒhƒtƒ‰ƒO */
);
</pre>
</div>
<div class="para">
<h4>ˆø”</h4>
<dl class="par">
<dt>FileObject</dt>
<dd>V‚µ‚­ì¬‚·‚éƒtƒ@ƒCƒ‹EƒIƒuƒWƒFƒNƒg\‘¢‘̂ւ̃|ƒCƒ“ƒ^‚ðŽw’肵‚Ü‚·BˆÈ~A‚»‚̃tƒ@ƒCƒ‹‚ð•Â‚¶‚é‚Ü‚Å‚±‚̃tƒ@ƒCƒ‹EƒIƒuƒWƒFƒNƒg‚ðŽg—p‚µ‚ătƒ@ƒCƒ‹‘€ì‚ð‚µ‚Ü‚·B</dd>
<dt>FileName</dt>
<dd>ŠJ‚­(‚Ü‚½‚͍쐬‚·‚é)ƒtƒ@ƒCƒ‹‚Ì <a href="filename.html">ƒtƒ@ƒCƒ‹–¼</a>‚ª“ü‚Á‚½<tt>'\0'</tt>‚ŏI‚í‚镶Žš—ñ‚ւ̃|ƒCƒ“ƒ^‚ðŽw’肵‚Ü‚·B</dd>
<dt>ModeFlags</dt>
<dd>ƒtƒ@ƒCƒ‹‚̃AƒNƒZƒX•û–@‚âƒI[ƒvƒ“•û–@‚ðŒˆ‚ß‚éƒtƒ‰ƒO‚Å‚·B‚±‚̃pƒ‰ƒ[ƒ^‚É‚ÍŽŸ‚Ì‘g‚ݍ‡‚킹‚ðŽw’肵‚Ü‚·B<br>
<table class="lst">
<tr><th>’l</th><th>ˆÓ–¡</th></tr>
<tr><td>FA_READ</td><td>“ǂݏo‚µƒ‚[ƒh‚ÅŠJ‚«‚Ü‚·B“ǂݏ‘‚«‚·‚éê‡‚Í<tt>FA_WRITE</tt>‚Æ‹¤‚ÉŽw’肵‚Ü‚·B</td></tr>
<tr><td>FA_WRITE</td><td>‘‚«ž‚݃‚[ƒh‚ÅŠJ‚«‚Ü‚·B“ǂݏ‘‚«‚·‚éê‡‚Í<tt>FA_READ</tt>‚Æ‹¤‚ÉŽw’肵‚Ü‚·B</td></tr>
<tr><td>FA_OPEN_EXISTING</td><td>Šù‘¶‚̃tƒ@ƒCƒ‹‚ðŠJ‚«‚Ü‚·Bƒtƒ@ƒCƒ‹‚ª–³‚¢‚Æ‚«‚̓Gƒ‰[‚É‚È‚è‚Ü‚·B(ƒfƒtƒHƒ‹ƒg)</td></tr>
<tr><td>FA_OPEN_ALWAYS</td><td>Šù‘¶‚̃tƒ@ƒCƒ‹‚ðŠJ‚«‚Ü‚·Bƒtƒ@ƒCƒ‹‚ª–³‚¢‚Æ‚«‚̓tƒ@ƒCƒ‹‚ðì¬‚µ‚Ü‚·B</td></tr>
<tr><td>FA_CREATE_NEW</td><td>ƒtƒ@ƒCƒ‹‚ðì¬‚µ‚Ü‚·B“¯–¼‚̃tƒ@ƒCƒ‹‚ª‚ ‚éê‡‚́AƒGƒ‰[‚É‚È‚è‚Ü‚·B</td></tr>
<tr><td>FA_CREATE_ALWAYS</td><td>ƒtƒ@ƒCƒ‹‚ðì¬‚µ‚Ü‚·B“¯–¼‚̃tƒ@ƒCƒ‹‚ª‚ ‚éê‡‚́AƒTƒCƒY‚ð0‚É‚µ‚Ä‚©‚çŠJ‚«‚Ü‚·B</td></tr>
</table>
</dd>
</dl>
</div>
<div class="para">
<h4>–ß‚è’l</h4>
<dl class="ret">
<dt>FR_OK (0)</dt>
<dd>³íI—¹BˆÈ~A<tt>FileObject</tt>\‘¢‘Ì‚ðŽg‚Á‚Ä‚±‚̃tƒ@ƒCƒ‹‚𑀍ì‚Å‚«‚Ü‚·B</dd>
<dt>FR_NO_FILE</dt>
<dd>ƒtƒ@ƒCƒ‹‚ªŒ©‚‚©‚ç‚È‚¢B</dd>
<dt>FR_NO_PATH</dt>
<dd>ƒpƒX‚ªŒ©‚‚©‚ç‚È‚¢B</dd>
<dt>FR_INVALID_NAME</dt>
<dd>ƒtƒ@ƒCƒ‹–¼‚ª•s³B</dd>
<dt>FR_INVALID_DRIVE</dt>
<dd>ƒhƒ‰ƒCƒu”ԍ†‚ª•s³B</dd>
<dt>FR_EXIST</dt>
<dd>“¯–¼‚̃tƒ@ƒCƒ‹‚ªŠù‚É‚ ‚éB</dd>
<dt>FR_DENIED</dt>
<dd>ƒAƒNƒZƒX‚ª‹‘”Û‚³‚ꂽBƒŠ[ƒhEƒIƒ“ƒŠ[Eƒtƒ@ƒCƒ‹‚̏‘‚«ž‚݃‚[ƒhEƒI[ƒvƒ“A“¯–¼‚̃fƒBƒŒƒNƒgƒŠ‚Ü‚½‚̓Š[ƒhEƒIƒ“ƒŠ[Eƒtƒ@ƒCƒ‹‚ª‚ ‚éó‘Ԃł̃tƒ@ƒCƒ‹ì¬AƒfƒBƒXƒN‚Ü‚½‚̓fƒBƒŒƒNƒgƒŠEƒe[ƒuƒ‹‚ª–ž”t‚Ńtƒ@ƒCƒ‹‚ðì¬‚Å‚«‚È‚¢‚ȂǁB</dd>
<dt>FR_NOT_READY</dt>
<dd>ƒƒfƒBƒA‚ªƒZƒbƒg‚³‚ê‚Ä‚¢‚È‚¢‚ȂǁA•¨—ƒhƒ‰ƒCƒu‚ª“®ì•s”\ó‘ԁB</dd>
<dt>FR_WRITE_PROTECTED</dt>
<dd>ƒƒfƒBƒA‚ª‘‚«ž‚Ý‹ÖŽ~ó‘Ԃŏ‘‚«ž‚ÝŒnƒI[ƒvƒ“‚ð‚µ‚½B</dd>
<dt>FR_DISK_ERR</dt>
<dd>ƒfƒBƒXƒNEƒGƒ‰[‚É‚æ‚鎸”sB</dd>
<dt>FR_INT_ERR</dt>
<dd>•s³‚ÈFAT\‘¢‚Ü‚½‚Í“à•”ƒGƒ‰[‚É‚æ‚鎸”sB</dd>
<dt>FR_NOT_ENABLED</dt>
<dd>‚»‚̘_—ƒhƒ‰ƒCƒu‚Ƀ[ƒNEƒGƒŠƒA‚ªŠ„‚è“–‚Ä‚ç‚ê‚Ä‚¢‚È‚¢B</dd>
<dt>FR_NO_FILESYSTEM</dt>
<dd>ƒfƒBƒXƒNã‚É—LŒø‚ÈFATƒ{ƒŠƒ…[ƒ€‚ªŒ©‚‚©‚ç‚È‚¢B</dd>
</dl>
</div>
<div class="para">
<h4>‰ðà</h4>
<p>Šù‘¶‚̃tƒ@ƒCƒ‹‚ðŠJ‚¢‚½‚èAV‚µ‚¢ƒtƒ@ƒCƒ‹‚ðì¬‚µ‚Ü‚·BŠÖ”‚ª¬Œ÷‚·‚é‚ƃtƒ@ƒCƒ‹EƒIƒuƒWƒFƒNƒg‚ªì¬‚³‚êAˆÈ~‚»‚̃tƒ@ƒCƒ‹‚ɑ΂·‚éƒAƒNƒZƒX‚ÉŽg—p‚µ‚Ü‚·Bƒtƒ@ƒCƒ‹‚ð•Â‚¶‚é‚Æ‚«‚́A<a href="close.html">f_close()</a>‚ðŽg—p‚µ‚Ü‚·B‰½‚ç‚©‚̕ύX‚ªs‚í‚ꂽƒtƒ@ƒCƒ‹‚ª‚»‚̌㐳‚µ‚­•Â‚¶‚ç‚ê‚È‚©‚Á‚½ê‡A‚»‚̃tƒ@ƒCƒ‹‚ª”j‘¹‚·‚éê‡‚ª‚ ‚è‚Ü‚·B</p>
<p>ƒtƒ@ƒCƒ‹EƒAƒNƒZƒX‚ðŠJŽn‚·‚é‘O‚ɁA<a href="mount.html">f_mount()</a>‚ðŽg‚Á‚Ä‚»‚ꂼ‚ê‚̘_—ƒhƒ‰ƒCƒu‚Ƀ[ƒNEƒGƒŠƒA(ƒtƒ@ƒCƒ‹EƒVƒXƒeƒ€EƒIƒuƒWƒFƒNƒg)‚ð—^‚¦‚é•K—v‚ª‚ ‚è‚Ü‚·B‚±‚̏‰Šú‰»‚ÌŒãA‚»‚̘_—ƒhƒ‰ƒCƒu‚ɑ΂µ‚Ä‘S‚Ẵtƒ@ƒCƒ‹ŠÖ”‚ªŽg‚¦‚é‚悤‚É‚È‚è‚Ü‚·B</p>
</div>
<div class="para">
<h4>‘Ήžî•ñ</h4>
<p>‘S‚Ă̍\¬‚ÅŽg—p‰Â”\‚Å‚·B<tt>_FS_READONLY == 1</tt>‚Ì‚Æ‚«‚́A<tt>FA_WRITE, FA_CREATE_ALWAYS, FA_CREATE_NEW, FA_OPEN_ALWAYS</tt>‚ÌŠeƒtƒ‰ƒO‚̓Tƒ|[ƒg‚³‚ê‚Ü‚¹‚ñB</p>
</div>
<div class="para">
<h4>Žg—p—áiƒtƒ@ƒCƒ‹EƒRƒs[j</h4>
<pre>
void main (void)
{
FATFS fs[2]; /* ˜_—ƒhƒ‰ƒCƒu‚̃[ƒNEƒGƒŠƒA(ƒtƒ@ƒCƒ‹EƒVƒXƒeƒ€EƒIƒuƒWƒFƒNƒg) */
FIL fsrc, fdst; /* ƒtƒ@ƒCƒ‹EƒIƒuƒWƒFƒNƒg */
BYTE buffer[4096]; /* file copy buffer */
FRESULT res; /* FatFs function common result code */
UINT br, bw; /* File R/W count */
/* ƒhƒ‰ƒCƒu0,1‚Ƀ[ƒNEƒGƒŠƒA‚ð—^‚¦‚é */
f_mount(0, &amp;fs[0]);
f_mount(1, &amp;fs[1]);
/* ƒhƒ‰ƒCƒu1‚̃\[ƒXEƒtƒ@ƒCƒ‹‚ðŠJ‚­ */
res = f_open(&amp;fsrc, "1:srcfile.dat", FA_OPEN_EXISTING | FA_READ);
if (res) die(res);
/* ƒhƒ‰ƒCƒu0‚ɃfƒXƒeƒBƒl[ƒVƒ‡ƒ“Eƒtƒ@ƒCƒ‹‚ðì¬‚·‚é */
res = f_open(&amp;fdst, "0:dstfile.dat", FA_CREATE_ALWAYS | FA_WRITE);
if (res) die(res);
/* ƒ\[ƒX‚©‚çƒfƒXƒeƒBƒl[ƒVƒ‡ƒ“‚ɃRƒs[‚·‚é */
for (;;) {
res = f_read(&amp;fsrc, buffer, sizeof(buffer), &amp;br);
if (res || br == 0) break; /* ƒGƒ‰[‚©ƒtƒ@ƒCƒ‹I’[ */
res = f_write(&amp;fdst, buffer, br, &amp;bw);
if (res || bw &lt; br) break; /* ƒGƒ‰[‚©ƒfƒBƒXƒN–ž”t */
}
/* ‘S‚Ẵtƒ@ƒCƒ‹‚ð•Â‚¶‚é */
f_close(&amp;fsrc);
f_close(&amp;fdst);
/* ƒ[ƒNEƒGƒŠƒA‚ðŠJ•ú‚·‚é */
f_mount(0, NULL);
f_mount(1, NULL);
}
</pre>
</div>
<div class="para">
<h4>ŽQÆ</h4>
<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>
</div>
<p class="foot"><a href="../00index_j.html">–ß‚é</a></p>
</body>
</html>