]> cloudbase.mooo.com Git - z180-stamp.git/blob - fatfs/doc/ja/lseek.html
Import fatfs R0.10b
[z180-stamp.git] / fatfs / doc / ja / lseek.html
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
2 <html lang="ja">
3 <head>
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/lseek.html">
8 <link rel="stylesheet" href="../css_j.css" type="text/css" media="screen" title="ELM Default">
9 <title>FatFs - f_lseek</title>
10 </head>
11
12 <body>
13
14 <div class="para func">
15 <h2>f_lseek</h2>
16 <p>\83t\83@\83C\83\8b\82Ì\83\8a\81[\83h/\83\89\83C\83g\81E\83|\83C\83\93\83^\82ð\88Ú\93®\82µ\82Ü\82·\81B\82Ü\82½\81A\8d\82\91¬\83V\81[\83N\8b@\94\\8eg\97p\8e\9e\82É\82ÍCLMT(\8cã\8fq)\82Ì\8dì\90¬\82É\82à\8eg\97p\82µ\82Ü\82·\81B</p>
17 <pre>
18 FRESULT f_lseek (
19 FIL* <span class="arg">fp</span>, <span class="c">/* [IN] \83t\83@\83C\83\8b\81E\83I\83u\83W\83F\83N\83g\8d\\91¢\91Ì\82Ö\82Ì\83|\83C\83\93\83^ */</span>
20 DWORD <span class="arg">ofs</span> <span class="c">/* [IN] \88Ú\93®\90æ\83I\83t\83Z\83b\83g */</span>
21 );
22 </pre>
23 </div>
24
25 <div class="para arg">
26 <h4>\88ø\90\94</h4>
27 <dl class="par">
28 <dt>fp</dt>
29 <dd>\91Î\8fÛ\82Æ\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</dd>
30 <dt>ofs</dt>
31 <dd>\88Ú\93®\90æ\82Ì\83I\83t\83Z\83b\83g(\83\8a\81[\83h/\83\89\83C\83g\81E\83|\83C\83\93\83^)\92l\81B\83t\83@\83C\83\8b\90æ\93ª\82©\82ç\82Ì\83I\83t\83Z\83b\83g\82ð\83o\83C\83g\92P\88Ê\82Å\8ew\92è\82µ\82Ü\82·\81B</dd>
32 </dl>
33 </div>
34
35
36 <div class="para ret">
37 <h4>\96ß\82è\92l</h4>
38 <p>
39 <a href="rc.html#ok">FR_OK</a>,
40 <a href="rc.html#de">FR_DISK_ERR</a>,
41 <a href="rc.html#ie">FR_INT_ERR</a>,
42 <a href="rc.html#nr">FR_NOT_READY</a>,
43 <a href="rc.html#io">FR_INVALID_OBJECT</a>,
44 <a href="rc.html#tm">FR_TIMEOUT</a>,
45 <a href="rc.html#nc">FR_NOT_ENOUGH_CORE</a>
46 </p>
47 </div>
48
49
50 <div class="para desc">
51 <h4>\89ð\90à</h4>
52 <p>\83t\83@\83C\83\8b\82Ì\83\8a\81[\83h/\83\89\83C\83g\81E\83|\83C\83\93\83^(\8e\9f\82É\93Ç\82Ý\8fo\82µ\81E\8f\91\82«\8d\9e\82Ý\82³\82ê\82é\83o\83C\83g\82Ì\83I\83t\83Z\83b\83g)\82ð\88Ú\93®\82µ\82Ü\82·\81B\83I\83t\83Z\83b\83g\82Ì\8c´\93_\82Í\83t\83@\83C\83\8b\90æ\93ª\82Å\82·\81B\8f\91\82«\8d\9e\82Ý\83\82\81[\83h\82Å\83t\83@\83C\83\8b\81E\83T\83C\83Y\82æ\82è\91å\82«\82È\92l\82ð\8ew\92è\82·\82é\82Æ\81A\82»\82±\82Ü\82Å\83t\83@\83C\83\8b\81E\83T\83C\83Y\82ª\8ag\92£\82³\82ê\81A\8ag\92£\82³\82ê\82½\95\94\95ª\82Ì\83f\81[\83^\82Í\96¢\92è\8b`\82Æ\82È\82è\82Ü\82·\81B\83f\81[\83^\82ð\92x\89\84\96³\82­\8d\82\91¬\82É\8f\91\82«\8d\9e\82Ý\82½\82¢\82Æ\82«\82Í\81A\97\\82ß\82±\82Ì\8aÖ\90\94\82Å\95K\97v\82È\83T\83C\83Y\82Ü\82Å\83t\83@\83C\83\8b\81E\83T\83C\83Y\82ð\8ag\92£\82µ\82Ä\82¨\82­\82Æ\97Ç\82¢\82Å\82µ\82å\82¤\81B<tt>f_lseek()</tt>\82ª\90³\8fí\8fI\97¹\82µ\82½\82 \82Æ\82Í\81A\83\8a\81[\83h/\83\89\83C\83g\81E\83|\83C\83\93\83^\82ª\90³\82µ\82­\88Ú\93®\82µ\82½\82©\83`\83F\83b\83N\82·\82é\82×\82«\82Å\82·\81B\83\8a\81[\83h/\83\89\83C\83g\81E\83|\83C\83\93\83^\82ª\8ew\92è\82æ\82è\8f¬\82³\82¢\82Æ\82«\82Í\81A\8e\9f\82Ì\8c´\88ö\82ª\8dl\82¦\82ç\82ê\82Ü\82·\81B</p>
53 <ul>
54 <li>\94ñ\8f\91\82«\8d\9e\82Ý\83\82\81[\83h\82Ü\82½\82Í\8d\82\91¬\83V\81[\83N\81E\83\82\81[\83h\82Ì\82½\82ß\81A\83t\83@\83C\83\8b\81E\83T\83C\83Y\82Å\83N\83\8a\83b\83v\82³\82ê\82½\81B</li>
55 <li>\83t\83@\83C\83\8b\8ag\92£\92\86\82É\83f\83B\83X\83N\82ª\96\9e\94t\82É\82È\82Á\82½\81B</li>
56 </ul>
57 <p><tt>_USE_FASTSEEK</tt>\82ª1\82Å\81A\8a\8e\82Â\83t\83@\83C\83\8b\81E\83I\83u\83W\83F\83N\83g\82Ì<tt>cltbl</tt>\83\81\83\93\83o\82ªNULL\88È\8aO(<tt>f_open()</tt>\82ÅNULL\82É\90Ý\92è\82³\82ê\82é)\82Ì\82Æ\82«\81A\8d\82\91¬\83V\81[\83N\81E\83\82\81[\83h\82É\82È\82è\82Ü\82·\81B\82±\82ê\82Í\83t\83@\83C\83\8b\82Ì\83N\83\89\83X\83^\94z\92u\8fî\95ñ(CLMT)\82ð\83\81\83\82\83\8a\8fã\82É\95Û\8e\9d\82µ\82Ä\82¨\82­\82±\82Æ\82É\82æ\82è\81AFAT\82É\83A\83N\83Z\83X\82·\82é\82±\82Æ\82È\82­\8cã\95û\83V\81[\83N\82â\83\8d\83\93\83O\81E\83V\81[\83N\82ð\8d\82\91¬\82É\8ds\82¤\8b@\94\\82Å\82·\81B\8d\82\91¬\83V\81[\83N\81E\83\82\81[\83h\82Í\81A<tt>f_read()/f_wtite()</tt>\82Ì\93®\8dì\82É\82à\93K\97p\82³\82ê\82Ü\82·\81B\8d\82\91¬\83V\81[\83N\81E\83\82\81[\83h\82Å\82Í<tt>f_wtite()/f_lseek()</tt>\82É\82æ\82é\83t\83@\83C\83\8b\81E\83T\83C\83Y\82Ì\8ag\92£\82Í\82Å\82«\82Ü\82¹\82ñ\81B</p>
58 <p>\8d\82\91¬\83V\81[\83N\93®\8dì\82ð\8ds\82¤\91O\82É\81ACLMT\82ð\8dì\90¬\82µ\82Ä\82¨\82­\95K\97v\82ª\82 \82è\82Ü\82·\81B\82±\82ê\82ð\8dì\90¬\82·\82é\82É\82Í\81A\82Ü\82¸CLMT\8ai\94[\83o\83b\83t\83@(<tt>DWORD</tt>\8c^\94z\97ñ)\82ð\8f\80\94õ\82µ\81A<tt>cltbl</tt>\83\81\83\93\83o\82É\82»\82Ì\83|\83C\83\93\83^\82ð\83Z\83b\83g\82µ\82Ü\82·\81B\82»\82µ\82Ä\81A\94z\97ñ\82Ì\90æ\93ª\97v\91f\82É\82»\82Ì\94z\97ñ\82Ì\83T\83C\83Y(\97v\91f\90\94)\82ð\93ü\82ê\81A<tt>f_lseek()</tt>\82ð<tt class="arg">ofs</tt>\82É<tt>CREATE_LINKMAP</tt>\82ð\8ew\92è\82µ\82Ä\8cÄ\82Ñ\8fo\82µ\82Ü\82·\81B\8aÖ\90\94\82ª\90¬\8c÷\82·\82é\82ÆCLMT\82ª\8dì\90¬\82³\82ê\81A\88È\8d~\82Ì<tt>f_read()/f_write()/f_lseek()</tt>\82Å\82ÍFAT\82Ö\82Ì\83A\83N\83Z\83X\82Í\94­\90\82µ\82Ü\82¹\82ñ\81B<tt>FR_NOT_ENOUGH_CORE</tt>\82Å\8e¸\94s\82µ\82½\82Æ\82«\82Í\94z\97ñ\83T\83C\83Y\82ª\95s\91«\82Å\81A\90æ\93ª\97v\91f\82É\82Í\8eÀ\8dÛ\82É\95K\97v\82Æ\82È\82é\97v\91f\90\94\82ª\95Ô\82³\82ê\82Ü\82·\81B\95K\97v\82È\97v\91f\90\94\82Í\81A(\83t\83@\83C\83\8b\82Ì\95ª\8a\84\90\94 + 1) * 2 \82Å\82·\81B\82½\82Æ\82¦\82Î\81A\83t\83@\83C\83\8b\82ª5\82Â\82Ì\83t\83\89\83O\83\81\83\93\83g\82É\95ª\92f\82³\82ê\82Ä\82¢\82é\82Æ\82«\82É\95K\97v\82È\97v\91f\90\94\82Í\81A12\82Æ\82È\82è\82Ü\82·\81B</p>
59 </div>
60
61
62 <div class="para comp">
63 <h4>\91Î\89\9e\8fî\95ñ</h4>
64 <p><tt>_FS_MINIMIZE &lt; 3</tt>\82Ì\82Æ\82«\8eg\97p\89Â\94\\82Å\82·\81B</p>
65 </div>
66
67
68 <div class="para use">
69 <h4>\8eg\97p\97á</h4>
70 <pre>
71 <span class="c">/* \83t\83@\83C\83\8b\82ð\8aJ\82­ */</span>
72 fp = malloc(sizeof (FIL));
73 res = f_open(fp, "file.dat", FA_READ|FA_WRITE);
74 if (res) ...
75
76 <span class="c">/* \83t\83@\83C\83\8b\81E\83I\83t\83Z\83b\83g5000\82Ö\88Ú\93® */</span>
77 res = f_lseek(fp, 5000);
78
79 <span class="c">/* \83t\83@\83C\83\8b\8fI\92[\82Ö\88Ú\93®(\83t\83@\83C\83\8b\92Ç\8bL\82Ì\8f\80\94õ) */</span>
80 res = f_lseek(fp, f_size(fp));
81
82 <span class="c">/* 3000\83o\83C\83g\90i\82ß\82é */</span>
83 res = f_lseek(fp, f_tell(fp) + 3000);
84
85 <span class="c">/* 2000\83o\83C\83g\96ß\82· (\83\89\83b\83v\83A\83\89\83E\83\93\83h\82É\92\8d\88Ó) */</span>
86 res = f_lseek(fp, f_tell(fp) - 2000);
87 </pre>
88 <pre>
89 <span class="c">/* \83N\83\89\83X\83^\90æ\8ds\8a\84\82è\93\96\82Ä (\83X\83g\83\8a\81[\83~\83\93\83O\81E\83\89\83C\83g\8e\9e\82Ì\83o\83b\83t\83@\81E\83I\81[\83o\81[\83\89\83\93\96h\8e~) */</span>
90
91 res = f_open(fp, "record.wav", FA_CREATE_NEW | FA_WRITE); <span class="c">/* \83t\83@\83C\83\8b\8dì\90¬ */</span>
92
93 res = f_lseek(fp, MAX_SIZE); <span class="c">/* \8f\\95ª\82È\83N\83\89\83X\83^\82Ì\90æ\8ds\8a\84\82è\93\96\82Ä */</span>
94 if (res || f_tell(fp) != PRE_SIZE) ... <span class="c">/* \90³\82µ\82­\83t\83@\83C\83\8b\82ª\8ag\92£\82³\82ê\82½\82©\83`\83F\83b\83N */</span>
95
96 res = f_lseek(fp, DATA_START); <span class="c">/* \83f\81[\83^\81E\83X\83g\83\8a\81[\83\80\82Ì\8bL\98^(\83A\83\8d\83P\81[\83V\83\87\83\93\83f\83B\83\8c\83C\96³\82µ) */</span>
97 ...
98
99 res = f_truncate(fp); <span class="c">/* \95s\97v\97Ì\88æ\82Ì\90Ø\82è\8eÌ\82Ä */</span>
100 res = f_lseek(fp, 0); <span class="c">/* \83w\83b\83_\82Ì\8bL\98^ */</span>
101 ...
102
103 res = f_close(fp);
104 </pre>
105 <pre>
106 <span class="c">/* \8d\82\91¬\83V\81[\83N\8b@\94\\82ð\8eg\82¤ */</span>
107
108 DWORD clmt[SZ_TBL]; <span class="c">/* \83\8a\83\93\83N\81E\83}\83b\83v\81E\83e\81[\83u\83\8b\8ai\94[\83o\83b\83t\83@ */</span>
109
110 res = f_lseek(fp, ofs1); <span class="c">/* \92Ê\8fí\83V\81[\83N (\83I\81[\83v\83\93\8e\9e\81Acltbl\82ÍNULL\82É\8f\89\8aú\89»\82³\82ê\82é) */</span>
111
112 fp-&gt;cltbl = clmt; <span class="c">/* \8d\82\91¬\83V\81[\83N\8b@\94\\82Ì\97L\8cø\89» */</span>
113 clmt[0] = SZ_TBL; <span class="c">/* \90æ\93ª\97v\91f\82É\94z\97ñ\97v\91f\90\94\82ð\83Z\83b\83g */</span>
114 res = f_lseek(fp, CREATE_LINKMAP); <span class="c">/* CLMT\82Ì\8dì\90¬ */</span>
115 ...
116
117 res = f_lseek(fp, ofs2); <span class="c">/* \88È\8d~\81Af_read/f_write/f_lseek\82ÅFAT\83A\83N\83Z\83X\82Í\94­\90\82µ\82È\82¢ */</span>
118 </pre>
119 </div>
120
121
122 <div class="para ref">
123 <h4>\8eQ\8fÆ</h4>
124 <p><tt><a href="open.html">f_open</a>, <a href="sfile.html">FIL</a></tt></p>
125 </div>
126
127 <p class="foot"><a href="../00index_j.html">\96ß\82é</a></p>
128 </body>
129 </html>