1# 文件管理<a name="ZH-CN_TOPIC_0000001209412151"></a> 2 3> **说明：** 4>从 API Version 6 开始支持。 5 6## 导入模块<a name="zh-cn_topic_0000001208447259_s56d19203690d4782bfc74069abb6bd71"></a> 7 8``` 9import fileio from '@ohos.fileio'; 10``` 11 12## 权限列表<a name="zh-cn_topic_0000001208447259_section11257113618419"></a> 13 14无 15 16## 使用说明<a name="zh-cn_topic_0000001208447259_section17323786612"></a> 17 18使用该功能模块对文件/目录进行操作前，需要先获取其绝对路径。 19 20<a name="zh-cn_topic_0000001208447259_table859142263817"></a> 21<table><thead align="left"><tr id="zh-cn_topic_0000001208447259_row165922243812"><th class="cellrowborder" valign="top" width="21.6%" id="mcps1.1.4.1.1"><p id="zh-cn_topic_0000001208447259_p20593226383"><a name="zh-cn_topic_0000001208447259_p20593226383"></a><a name="zh-cn_topic_0000001208447259_p20593226383"></a>目录类型</p> 22</th> 23<th class="cellrowborder" valign="top" width="53.57000000000001%" id="mcps1.1.4.1.2"><p id="zh-cn_topic_0000001208447259_p125911229389"><a name="zh-cn_topic_0000001208447259_p125911229389"></a><a name="zh-cn_topic_0000001208447259_p125911229389"></a>说明</p> 24</th> 25<th class="cellrowborder" valign="top" width="24.830000000000002%" id="mcps1.1.4.1.3"><p id="zh-cn_topic_0000001208447259_p1177425414331"><a name="zh-cn_topic_0000001208447259_p1177425414331"></a><a name="zh-cn_topic_0000001208447259_p1177425414331"></a>相关接口</p> 26</th> 27</tr> 28</thead> 29<tbody><tr id="zh-cn_topic_0000001208447259_row14604221386"><td class="cellrowborder" valign="top" width="21.6%" headers="mcps1.1.4.1.1 "><p id="zh-cn_topic_0000001208447259_p0605228382"><a name="zh-cn_topic_0000001208447259_p0605228382"></a><a name="zh-cn_topic_0000001208447259_p0605228382"></a>内部存储的缓存目录</p> 30</td> 31<td class="cellrowborder" valign="top" width="53.57000000000001%" headers="mcps1.1.4.1.2 "><p id="zh-cn_topic_0000001208447259_p76010229385"><a name="zh-cn_topic_0000001208447259_p76010229385"></a><a name="zh-cn_topic_0000001208447259_p76010229385"></a>可读写，随时可能清除，不保证持久性。一般用作下载临时目录或缓存目录。</p> 32</td> 33<td class="cellrowborder" valign="top" width="24.830000000000002%" headers="mcps1.1.4.1.3 "><p id="zh-cn_topic_0000001208447259_p1677525420331"><a name="zh-cn_topic_0000001208447259_p1677525420331"></a><a name="zh-cn_topic_0000001208447259_p1677525420331"></a>getCacheDir</p> 34</td> 35</tr> 36<tr id="zh-cn_topic_0000001208447259_row20601622183813"><td class="cellrowborder" valign="top" width="21.6%" headers="mcps1.1.4.1.1 "><p id="zh-cn_topic_0000001208447259_p166062273813"><a name="zh-cn_topic_0000001208447259_p166062273813"></a><a name="zh-cn_topic_0000001208447259_p166062273813"></a>内部存储目录</p> 37</td> 38<td class="cellrowborder" valign="top" width="53.57000000000001%" headers="mcps1.1.4.1.2 "><p id="zh-cn_topic_0000001208447259_p19601522103813"><a name="zh-cn_topic_0000001208447259_p19601522103813"></a><a name="zh-cn_topic_0000001208447259_p19601522103813"></a>随应用卸载删除。</p> 39</td> 40<td class="cellrowborder" valign="top" width="24.830000000000002%" headers="mcps1.1.4.1.3 "><p id="zh-cn_topic_0000001208447259_p147753546339"><a name="zh-cn_topic_0000001208447259_p147753546339"></a><a name="zh-cn_topic_0000001208447259_p147753546339"></a>getFilesDir</p> 41</td> 42</tr> 43</tbody> 44</table> 45 46“文件/目录绝对路径”=“应用目录路径”+“文件/目录名” 47 48通过上述接口获取到应用目录路径dir，文件名为“xxx.txt”，文件所在绝对路径为： 49 50``` 51let path = dir + "xxx.txt" 52``` 53 54文件描述符fd： 55 56``` 57let fd = fileio.openSync(path); 58``` 59 60## fileio.statSync<a name="zh-cn_topic_0000001208447259_section014281412198"></a> 61 62statSync\(path:string\): Stat 63 64以同步方法获取文件的信息。 65 66- 参数： 67 68 <a name="zh-cn_topic_0000001208447259_table21431314201914"></a> 69 <table><thead align="left"><tr id="zh-cn_topic_0000001208447259_row15143151416194"><th class="cellrowborder" valign="top" width="11.03%" id="mcps1.1.5.1.1"><p id="zh-cn_topic_0000001208447259_p1214311146190"><a name="zh-cn_topic_0000001208447259_p1214311146190"></a><a name="zh-cn_topic_0000001208447259_p1214311146190"></a>参数名</p> 70 </th> 71 <th class="cellrowborder" valign="top" width="11.64%" id="mcps1.1.5.1.2"><p id="zh-cn_topic_0000001208447259_p181441142194"><a name="zh-cn_topic_0000001208447259_p181441142194"></a><a name="zh-cn_topic_0000001208447259_p181441142194"></a>类型</p> 72 </th> 73 <th class="cellrowborder" valign="top" width="7.1499999999999995%" id="mcps1.1.5.1.3"><p id="zh-cn_topic_0000001208447259_p514421417190"><a name="zh-cn_topic_0000001208447259_p514421417190"></a><a name="zh-cn_topic_0000001208447259_p514421417190"></a>必填</p> 74 </th> 75 <th class="cellrowborder" valign="top" width="70.17999999999999%" id="mcps1.1.5.1.4"><p id="zh-cn_topic_0000001208447259_p41441514181911"><a name="zh-cn_topic_0000001208447259_p41441514181911"></a><a name="zh-cn_topic_0000001208447259_p41441514181911"></a>说明</p> 76 </th> 77 </tr> 78 </thead> 79 <tbody><tr id="zh-cn_topic_0000001208447259_row15144214191910"><td class="cellrowborder" valign="top" width="11.03%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001208447259_p18144111417199"><a name="zh-cn_topic_0000001208447259_p18144111417199"></a><a name="zh-cn_topic_0000001208447259_p18144111417199"></a>path</p> 80 </td> 81 <td class="cellrowborder" valign="top" width="11.64%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001208447259_p9144111415196"><a name="zh-cn_topic_0000001208447259_p9144111415196"></a><a name="zh-cn_topic_0000001208447259_p9144111415196"></a>string</p> 82 </td> 83 <td class="cellrowborder" valign="top" width="7.1499999999999995%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001208447259_p414410149199"><a name="zh-cn_topic_0000001208447259_p414410149199"></a><a name="zh-cn_topic_0000001208447259_p414410149199"></a>是</p> 84 </td> 85 <td class="cellrowborder" valign="top" width="70.17999999999999%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001208447259_p106911349133411"><a name="zh-cn_topic_0000001208447259_p106911349133411"></a><a name="zh-cn_topic_0000001208447259_p106911349133411"></a>待获取文件的绝对路径。</p> 86 </td> 87 </tr> 88 </tbody> 89 </table> 90 91 92- 返回值： 93 94 <a name="zh-cn_topic_0000001208447259_table131441014111919"></a> 95 <table><thead align="left"><tr id="zh-cn_topic_0000001208447259_row19144101418196"><th class="cellrowborder" valign="top" width="22.93%" id="mcps1.1.3.1.1"><p id="zh-cn_topic_0000001208447259_p614513143191"><a name="zh-cn_topic_0000001208447259_p614513143191"></a><a name="zh-cn_topic_0000001208447259_p614513143191"></a>类型</p> 96 </th> 97 <th class="cellrowborder" valign="top" width="77.07000000000001%" id="mcps1.1.3.1.2"><p id="zh-cn_topic_0000001208447259_p1514517145192"><a name="zh-cn_topic_0000001208447259_p1514517145192"></a><a name="zh-cn_topic_0000001208447259_p1514517145192"></a>说明</p> 98 </th> 99 </tr> 100 </thead> 101 <tbody><tr id="zh-cn_topic_0000001208447259_row5145191421914"><td class="cellrowborder" valign="top" width="22.93%" headers="mcps1.1.3.1.1 "><p id="zh-cn_topic_0000001208447259_p11145141481918"><a name="zh-cn_topic_0000001208447259_p11145141481918"></a><a name="zh-cn_topic_0000001208447259_p11145141481918"></a><a href="#zh-cn_topic_0000001208447259_section7315249105116">Stat</a></p> 102 </td> 103 <td class="cellrowborder" valign="top" width="77.07000000000001%" headers="mcps1.1.3.1.2 "><p id="zh-cn_topic_0000001208447259_p0145171491910"><a name="zh-cn_topic_0000001208447259_p0145171491910"></a><a name="zh-cn_topic_0000001208447259_p0145171491910"></a>表示文件的具体信息。</p> 104 </td> 105 </tr> 106 </tbody> 107 </table> 108 109- 示例： 110 111 ``` 112 let stat = fileio.statSync(path); 113 ``` 114 115 116## fileio.opendirSync<a name="zh-cn_topic_0000001208447259_section7741145112216"></a> 117 118opendirSync\(path: string\): Dir 119 120以同步方法打开文件目录。 121 122- 参数： 123 124 <a name="zh-cn_topic_0000001208447259_table57421045122215"></a> 125 <table><thead align="left"><tr id="zh-cn_topic_0000001208447259_row187421459221"><th class="cellrowborder" valign="top" width="11.03%" id="mcps1.1.5.1.1"><p id="zh-cn_topic_0000001208447259_p1974244516221"><a name="zh-cn_topic_0000001208447259_p1974244516221"></a><a name="zh-cn_topic_0000001208447259_p1974244516221"></a>参数名</p> 126 </th> 127 <th class="cellrowborder" valign="top" width="11.64%" id="mcps1.1.5.1.2"><p id="zh-cn_topic_0000001208447259_p774294592214"><a name="zh-cn_topic_0000001208447259_p774294592214"></a><a name="zh-cn_topic_0000001208447259_p774294592214"></a>类型</p> 128 </th> 129 <th class="cellrowborder" valign="top" width="9.81%" id="mcps1.1.5.1.3"><p id="zh-cn_topic_0000001208447259_p137424459229"><a name="zh-cn_topic_0000001208447259_p137424459229"></a><a name="zh-cn_topic_0000001208447259_p137424459229"></a>必填</p> 130 </th> 131 <th class="cellrowborder" valign="top" width="67.52%" id="mcps1.1.5.1.4"><p id="zh-cn_topic_0000001208447259_p274212459222"><a name="zh-cn_topic_0000001208447259_p274212459222"></a><a name="zh-cn_topic_0000001208447259_p274212459222"></a>说明</p> 132 </th> 133 </tr> 134 </thead> 135 <tbody><tr id="zh-cn_topic_0000001208447259_row1674284511223"><td class="cellrowborder" valign="top" width="11.03%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001208447259_p197431458224"><a name="zh-cn_topic_0000001208447259_p197431458224"></a><a name="zh-cn_topic_0000001208447259_p197431458224"></a>path</p> 136 </td> 137 <td class="cellrowborder" valign="top" width="11.64%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001208447259_p774318454226"><a name="zh-cn_topic_0000001208447259_p774318454226"></a><a name="zh-cn_topic_0000001208447259_p774318454226"></a>string</p> 138 </td> 139 <td class="cellrowborder" valign="top" width="9.81%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001208447259_p27437452221"><a name="zh-cn_topic_0000001208447259_p27437452221"></a><a name="zh-cn_topic_0000001208447259_p27437452221"></a>是</p> 140 </td> 141 <td class="cellrowborder" valign="top" width="67.52%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001208447259_p144181369362"><a name="zh-cn_topic_0000001208447259_p144181369362"></a><a name="zh-cn_topic_0000001208447259_p144181369362"></a>待打开文件目录的绝对路径。</p> 142 </td> 143 </tr> 144 </tbody> 145 </table> 146 147- 返回值： 148 149 <a name="zh-cn_topic_0000001208447259_table1743134517224"></a> 150 <table><thead align="left"><tr id="zh-cn_topic_0000001208447259_row14743145202214"><th class="cellrowborder" valign="top" width="22.93%" id="mcps1.1.3.1.1"><p id="zh-cn_topic_0000001208447259_p127431245192220"><a name="zh-cn_topic_0000001208447259_p127431245192220"></a><a name="zh-cn_topic_0000001208447259_p127431245192220"></a>类型</p> 151 </th> 152 <th class="cellrowborder" valign="top" width="77.07000000000001%" id="mcps1.1.3.1.2"><p id="zh-cn_topic_0000001208447259_p137430454222"><a name="zh-cn_topic_0000001208447259_p137430454222"></a><a name="zh-cn_topic_0000001208447259_p137430454222"></a>说明</p> 153 </th> 154 </tr> 155 </thead> 156 <tbody><tr id="zh-cn_topic_0000001208447259_row10743545202213"><td class="cellrowborder" valign="top" width="22.93%" headers="mcps1.1.3.1.1 "><p id="zh-cn_topic_0000001208447259_p17445459222"><a name="zh-cn_topic_0000001208447259_p17445459222"></a><a name="zh-cn_topic_0000001208447259_p17445459222"></a><a href="#zh-cn_topic_0000001208447259_section189341937163212">Dir</a></p> 157 </td> 158 <td class="cellrowborder" valign="top" width="77.07000000000001%" headers="mcps1.1.3.1.2 "><p id="zh-cn_topic_0000001208447259_p16808111123618"><a name="zh-cn_topic_0000001208447259_p16808111123618"></a><a name="zh-cn_topic_0000001208447259_p16808111123618"></a>返回Dir对象。</p> 159 </td> 160 </tr> 161 </tbody> 162 </table> 163 164- 示例： 165 166 ``` 167 let dir = fileio.opendirSync(path); 168 ``` 169 170 171## fileio.accessSync<a name="zh-cn_topic_0000001208447259_section9627104782212"></a> 172 173accessSync\(path: string, mode?: number\): void 174 175以同步方法检查当前进程是否可访问某文件。 176 177- 参数： 178 179 <a name="zh-cn_topic_0000001208447259_table2062810475226"></a> 180 <table><thead align="left"><tr id="zh-cn_topic_0000001208447259_row06284478229"><th class="cellrowborder" valign="top" width="11.03%" id="mcps1.1.5.1.1"><p id="zh-cn_topic_0000001208447259_p56281747182210"><a name="zh-cn_topic_0000001208447259_p56281747182210"></a><a name="zh-cn_topic_0000001208447259_p56281747182210"></a>参数名</p> 181 </th> 182 <th class="cellrowborder" valign="top" width="11.64%" id="mcps1.1.5.1.2"><p id="zh-cn_topic_0000001208447259_p17628144762211"><a name="zh-cn_topic_0000001208447259_p17628144762211"></a><a name="zh-cn_topic_0000001208447259_p17628144762211"></a>类型</p> 183 </th> 184 <th class="cellrowborder" valign="top" width="7.1499999999999995%" id="mcps1.1.5.1.3"><p id="zh-cn_topic_0000001208447259_p156281547192217"><a name="zh-cn_topic_0000001208447259_p156281547192217"></a><a name="zh-cn_topic_0000001208447259_p156281547192217"></a>必填</p> 185 </th> 186 <th class="cellrowborder" valign="top" width="70.17999999999999%" id="mcps1.1.5.1.4"><p id="zh-cn_topic_0000001208447259_p1862824714222"><a name="zh-cn_topic_0000001208447259_p1862824714222"></a><a name="zh-cn_topic_0000001208447259_p1862824714222"></a>说明</p> 187 </th> 188 </tr> 189 </thead> 190 <tbody><tr id="zh-cn_topic_0000001208447259_row262816476222"><td class="cellrowborder" valign="top" width="11.03%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001208447259_p196281347182217"><a name="zh-cn_topic_0000001208447259_p196281347182217"></a><a name="zh-cn_topic_0000001208447259_p196281347182217"></a>path</p> 191 </td> 192 <td class="cellrowborder" valign="top" width="11.64%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001208447259_p1462816472225"><a name="zh-cn_topic_0000001208447259_p1462816472225"></a><a name="zh-cn_topic_0000001208447259_p1462816472225"></a>string</p> 193 </td> 194 <td class="cellrowborder" valign="top" width="7.1499999999999995%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001208447259_p16629104792216"><a name="zh-cn_topic_0000001208447259_p16629104792216"></a><a name="zh-cn_topic_0000001208447259_p16629104792216"></a>是</p> 195 </td> 196 <td class="cellrowborder" valign="top" width="70.17999999999999%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001208447259_p15367141141116"><a name="zh-cn_topic_0000001208447259_p15367141141116"></a><a name="zh-cn_topic_0000001208447259_p15367141141116"></a>待访问文件的绝对路径。</p> 197 </td> 198 </tr> 199 <tr id="zh-cn_topic_0000001208447259_row204438428415"><td class="cellrowborder" valign="top" width="11.03%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001208447259_p14444342104112"><a name="zh-cn_topic_0000001208447259_p14444342104112"></a><a name="zh-cn_topic_0000001208447259_p14444342104112"></a>mode</p> 200 </td> 201 <td class="cellrowborder" valign="top" width="11.64%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001208447259_p144413421414"><a name="zh-cn_topic_0000001208447259_p144413421414"></a><a name="zh-cn_topic_0000001208447259_p144413421414"></a>number</p> 202 </td> 203 <td class="cellrowborder" valign="top" width="7.1499999999999995%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001208447259_p344414217412"><a name="zh-cn_topic_0000001208447259_p344414217412"></a><a name="zh-cn_topic_0000001208447259_p344414217412"></a>否</p> 204 </td> 205 <td class="cellrowborder" valign="top" width="70.17999999999999%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001208447259_zh-cn_topic_0000001144081254_p642032043011"><a name="zh-cn_topic_0000001208447259_zh-cn_topic_0000001144081254_p642032043011"></a><a name="zh-cn_topic_0000001208447259_zh-cn_topic_0000001144081254_p642032043011"></a>访问文件时的选项，可给定如下选项，以按位或的方式使用多个选项，默认给定0。</p> 206 <p id="zh-cn_topic_0000001208447259_zh-cn_topic_0000001144081254_p164812171258"><a name="zh-cn_topic_0000001208447259_zh-cn_topic_0000001144081254_p164812171258"></a><a name="zh-cn_topic_0000001208447259_zh-cn_topic_0000001144081254_p164812171258"></a>确认当前进程是否具有对应权限：</p> 207 <a name="zh-cn_topic_0000001208447259_zh-cn_topic_0000001144081254_ul133214146476"></a><a name="zh-cn_topic_0000001208447259_zh-cn_topic_0000001144081254_ul133214146476"></a><ul id="zh-cn_topic_0000001208447259_zh-cn_topic_0000001144081254_ul133214146476"><li>0：确认文件是否存在。</li></ul> 208 <a name="zh-cn_topic_0000001208447259_zh-cn_topic_0000001144081254_ul2629143710241"></a><a name="zh-cn_topic_0000001208447259_zh-cn_topic_0000001144081254_ul2629143710241"></a><ul id="zh-cn_topic_0000001208447259_zh-cn_topic_0000001144081254_ul2629143710241"><li>1：确认当前进程是否具有可执行权限。</li><li>2：确认当前进程是否具有写权限。</li><li>4：确认当前进程是否具有读权限。</li></ul> 209 </td> 210 </tr> 211 </tbody> 212 </table> 213 214- 示例： 215 216 ``` 217 fileio.accessSync(path); 218 ``` 219 220 221## fileio.closeSync<a name="zh-cn_topic_0000001208447259_section11518951152211"></a> 222 223closeSync\(fd: number\): void 224 225以同步方法关闭文件。 226 227- 参数： 228 229 <a name="zh-cn_topic_0000001208447259_table165187512224"></a> 230 <table><thead align="left"><tr id="zh-cn_topic_0000001208447259_row125192051162212"><th class="cellrowborder" valign="top" width="11.03%" id="mcps1.1.5.1.1"><p id="zh-cn_topic_0000001208447259_p45191851192213"><a name="zh-cn_topic_0000001208447259_p45191851192213"></a><a name="zh-cn_topic_0000001208447259_p45191851192213"></a>参数名</p> 231 </th> 232 <th class="cellrowborder" valign="top" width="11.65%" id="mcps1.1.5.1.2"><p id="zh-cn_topic_0000001208447259_p05198514224"><a name="zh-cn_topic_0000001208447259_p05198514224"></a><a name="zh-cn_topic_0000001208447259_p05198514224"></a>类型</p> 233 </th> 234 <th class="cellrowborder" valign="top" width="7.1%" id="mcps1.1.5.1.3"><p id="zh-cn_topic_0000001208447259_p9519125152210"><a name="zh-cn_topic_0000001208447259_p9519125152210"></a><a name="zh-cn_topic_0000001208447259_p9519125152210"></a>必填</p> 235 </th> 236 <th class="cellrowborder" valign="top" width="70.22%" id="mcps1.1.5.1.4"><p id="zh-cn_topic_0000001208447259_p6519115182214"><a name="zh-cn_topic_0000001208447259_p6519115182214"></a><a name="zh-cn_topic_0000001208447259_p6519115182214"></a>说明</p> 237 </th> 238 </tr> 239 </thead> 240 <tbody><tr id="zh-cn_topic_0000001208447259_row45191051182219"><td class="cellrowborder" valign="top" width="11.03%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001208447259_p1851945110224"><a name="zh-cn_topic_0000001208447259_p1851945110224"></a><a name="zh-cn_topic_0000001208447259_p1851945110224"></a>fd</p> 241 </td> 242 <td class="cellrowborder" valign="top" width="11.65%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001208447259_p12519115116220"><a name="zh-cn_topic_0000001208447259_p12519115116220"></a><a name="zh-cn_topic_0000001208447259_p12519115116220"></a>number</p> 243 </td> 244 <td class="cellrowborder" valign="top" width="7.1%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001208447259_p135191851142216"><a name="zh-cn_topic_0000001208447259_p135191851142216"></a><a name="zh-cn_topic_0000001208447259_p135191851142216"></a>是</p> 245 </td> 246 <td class="cellrowborder" valign="top" width="70.22%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001208447259_p8519951152218"><a name="zh-cn_topic_0000001208447259_p8519951152218"></a><a name="zh-cn_topic_0000001208447259_p8519951152218"></a>待关闭文件的文件描述符。</p> 247 </td> 248 </tr> 249 </tbody> 250 </table> 251 252- 示例： 253 254 ``` 255 fileio.closeSync(fd); 256 ``` 257 258 259## fileio.copyFileSync<a name="zh-cn_topic_0000001208447259_section752155117222"></a> 260 261fileio.copyFileSync\(src: string, dest: string, mode?:number\): void 262 263以同步方法复制文件。 264 265- 参数： 266 267 <a name="zh-cn_topic_0000001208447259_table154591869574"></a> 268 <table><thead align="left"><tr id="zh-cn_topic_0000001208447259_row1146006185710"><th class="cellrowborder" valign="top" width="11.03%" id="mcps1.1.5.1.1"><p id="zh-cn_topic_0000001208447259_p34601364573"><a name="zh-cn_topic_0000001208447259_p34601364573"></a><a name="zh-cn_topic_0000001208447259_p34601364573"></a>参数名</p> 269 </th> 270 <th class="cellrowborder" valign="top" width="19.470000000000002%" id="mcps1.1.5.1.2"><p id="zh-cn_topic_0000001208447259_p114609615719"><a name="zh-cn_topic_0000001208447259_p114609615719"></a><a name="zh-cn_topic_0000001208447259_p114609615719"></a>类型</p> 271 </th> 272 <th class="cellrowborder" valign="top" width="12.139999999999999%" id="mcps1.1.5.1.3"><p id="zh-cn_topic_0000001208447259_p646056165718"><a name="zh-cn_topic_0000001208447259_p646056165718"></a><a name="zh-cn_topic_0000001208447259_p646056165718"></a>必填</p> 273 </th> 274 <th class="cellrowborder" valign="top" width="57.36%" id="mcps1.1.5.1.4"><p id="zh-cn_topic_0000001208447259_p194601269577"><a name="zh-cn_topic_0000001208447259_p194601269577"></a><a name="zh-cn_topic_0000001208447259_p194601269577"></a>说明</p> 275 </th> 276 </tr> 277 </thead> 278 <tbody><tr id="zh-cn_topic_0000001208447259_row184604645713"><td class="cellrowborder" valign="top" width="11.03%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001208447259_p11460863575"><a name="zh-cn_topic_0000001208447259_p11460863575"></a><a name="zh-cn_topic_0000001208447259_p11460863575"></a>src</p> 279 </td> 280 <td class="cellrowborder" valign="top" width="19.470000000000002%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001208447259_p44603616575"><a name="zh-cn_topic_0000001208447259_p44603616575"></a><a name="zh-cn_topic_0000001208447259_p44603616575"></a>string</p> 281 </td> 282 <td class="cellrowborder" valign="top" width="12.139999999999999%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001208447259_p64614615714"><a name="zh-cn_topic_0000001208447259_p64614615714"></a><a name="zh-cn_topic_0000001208447259_p64614615714"></a>是</p> 283 </td> 284 <td class="cellrowborder" valign="top" width="57.36%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001208447259_p16668162211811"><a name="zh-cn_topic_0000001208447259_p16668162211811"></a><a name="zh-cn_topic_0000001208447259_p16668162211811"></a>待复制文件的路径。</p> 285 </td> 286 </tr> 287 <tr id="zh-cn_topic_0000001208447259_row1646119675719"><td class="cellrowborder" valign="top" width="11.03%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001208447259_p1446117665719"><a name="zh-cn_topic_0000001208447259_p1446117665719"></a><a name="zh-cn_topic_0000001208447259_p1446117665719"></a>dest</p> 288 </td> 289 <td class="cellrowborder" valign="top" width="19.470000000000002%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001208447259_p2461765571"><a name="zh-cn_topic_0000001208447259_p2461765571"></a><a name="zh-cn_topic_0000001208447259_p2461765571"></a>string</p> 290 </td> 291 <td class="cellrowborder" valign="top" width="12.139999999999999%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001208447259_p546166135717"><a name="zh-cn_topic_0000001208447259_p546166135717"></a><a name="zh-cn_topic_0000001208447259_p546166135717"></a>是</p> 292 </td> 293 <td class="cellrowborder" valign="top" width="57.36%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001208447259_p3461136125713"><a name="zh-cn_topic_0000001208447259_p3461136125713"></a><a name="zh-cn_topic_0000001208447259_p3461136125713"></a>目标文件路径。</p> 294 </td> 295 </tr> 296 <tr id="zh-cn_topic_0000001208447259_row134617611577"><td class="cellrowborder" valign="top" width="11.03%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001208447259_p446110617571"><a name="zh-cn_topic_0000001208447259_p446110617571"></a><a name="zh-cn_topic_0000001208447259_p446110617571"></a>mode</p> 297 </td> 298 <td class="cellrowborder" valign="top" width="19.470000000000002%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001208447259_p2046218615711"><a name="zh-cn_topic_0000001208447259_p2046218615711"></a><a name="zh-cn_topic_0000001208447259_p2046218615711"></a>number</p> 299 </td> 300 <td class="cellrowborder" valign="top" width="12.139999999999999%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001208447259_p14462116155713"><a name="zh-cn_topic_0000001208447259_p14462116155713"></a><a name="zh-cn_topic_0000001208447259_p14462116155713"></a>否</p> 301 </td> 302 <td class="cellrowborder" valign="top" width="57.36%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001208447259_p14434113012329"><a name="zh-cn_topic_0000001208447259_p14434113012329"></a><a name="zh-cn_topic_0000001208447259_p14434113012329"></a>mode提供覆盖文件的选项，当前仅支持0，且默认为0。</p> 303 <p id="zh-cn_topic_0000001208447259_p20644174510189"><a name="zh-cn_topic_0000001208447259_p20644174510189"></a><a name="zh-cn_topic_0000001208447259_p20644174510189"></a>0：完全覆盖目标文件，未覆盖部分将被裁切掉。</p> 304 </td> 305 </tr> 306 </tbody> 307 </table> 308 309- 示例： 310 311 ``` 312 fileio.copyFileSync(src, dest); 313 ``` 314 315 316## fileio.mkdirSync<a name="zh-cn_topic_0000001208447259_section11419920164917"></a> 317 318fileio.mkdirSync\(path: string, mode?: number\): void 319 320以同步方法创建目录。 321 322- 参数： 323 324 <a name="zh-cn_topic_0000001208447259_table19694163952110"></a> 325 <table><thead align="left"><tr id="zh-cn_topic_0000001208447259_row126941539202111"><th class="cellrowborder" valign="top" width="14.82%" id="mcps1.1.5.1.1"><p id="zh-cn_topic_0000001208447259_p1769483917215"><a name="zh-cn_topic_0000001208447259_p1769483917215"></a><a name="zh-cn_topic_0000001208447259_p1769483917215"></a>参数名</p> 326 </th> 327 <th class="cellrowborder" valign="top" width="14.729999999999999%" id="mcps1.1.5.1.2"><p id="zh-cn_topic_0000001208447259_p14694203922119"><a name="zh-cn_topic_0000001208447259_p14694203922119"></a><a name="zh-cn_topic_0000001208447259_p14694203922119"></a>类型</p> 328 </th> 329 <th class="cellrowborder" valign="top" width="9.16%" id="mcps1.1.5.1.3"><p id="zh-cn_topic_0000001208447259_p1069463922116"><a name="zh-cn_topic_0000001208447259_p1069463922116"></a><a name="zh-cn_topic_0000001208447259_p1069463922116"></a>必填</p> 330 </th> 331 <th class="cellrowborder" valign="top" width="61.29%" id="mcps1.1.5.1.4"><p id="zh-cn_topic_0000001208447259_p1169483913211"><a name="zh-cn_topic_0000001208447259_p1169483913211"></a><a name="zh-cn_topic_0000001208447259_p1169483913211"></a>说明</p> 332 </th> 333 </tr> 334 </thead> 335 <tbody><tr id="zh-cn_topic_0000001208447259_row3694639142118"><td class="cellrowborder" valign="top" width="14.82%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001208447259_p769473962120"><a name="zh-cn_topic_0000001208447259_p769473962120"></a><a name="zh-cn_topic_0000001208447259_p769473962120"></a>path</p> 336 </td> 337 <td class="cellrowborder" valign="top" width="14.729999999999999%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001208447259_p12694153919217"><a name="zh-cn_topic_0000001208447259_p12694153919217"></a><a name="zh-cn_topic_0000001208447259_p12694153919217"></a>string</p> 338 </td> 339 <td class="cellrowborder" valign="top" width="9.16%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001208447259_p9694203932115"><a name="zh-cn_topic_0000001208447259_p9694203932115"></a><a name="zh-cn_topic_0000001208447259_p9694203932115"></a>是</p> 340 </td> 341 <td class="cellrowborder" valign="top" width="61.29%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001208447259_p86940398219"><a name="zh-cn_topic_0000001208447259_p86940398219"></a><a name="zh-cn_topic_0000001208447259_p86940398219"></a>待创建目录的绝对路径。</p> 342 </td> 343 </tr> 344 <tr id="zh-cn_topic_0000001208447259_row1317135692118"><td class="cellrowborder" valign="top" width="14.82%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001208447259_p6171656102116"><a name="zh-cn_topic_0000001208447259_p6171656102116"></a><a name="zh-cn_topic_0000001208447259_p6171656102116"></a>mode</p> 345 </td> 346 <td class="cellrowborder" valign="top" width="14.729999999999999%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001208447259_p1017155614211"><a name="zh-cn_topic_0000001208447259_p1017155614211"></a><a name="zh-cn_topic_0000001208447259_p1017155614211"></a>number</p> 347 </td> 348 <td class="cellrowborder" valign="top" width="9.16%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001208447259_p1917110566213"><a name="zh-cn_topic_0000001208447259_p1917110566213"></a><a name="zh-cn_topic_0000001208447259_p1917110566213"></a>否</p> 349 </td> 350 <td class="cellrowborder" valign="top" width="61.29%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001144081254_p1049717244222"><a name="zh-cn_topic_0000001144081254_p1049717244222"></a><a name="zh-cn_topic_0000001144081254_p1049717244222"></a>创建目录的权限，可给定如下权限，以按位或的方式追加权限，默认给定0o775。</p> 351 <a name="zh-cn_topic_0000001144081254_ul1958851172210"></a><a name="zh-cn_topic_0000001144081254_ul1958851172210"></a><ul id="zh-cn_topic_0000001144081254_ul1958851172210"><li>0o775：所有者具有读、写及可执行权限，其余用户具有读及可执行权限。</li><li>0o700：所有者具有读、写及可执行权限。</li><li>0o400：所有者具有读权限。</li><li>0o200：所有者具有写权限。</li><li>0o100：所有者具有可执行权限。</li><li>0o070：所有用户组具有读、写及可执行权限。</li><li>0o040：所有用户组具有读权限。</li><li>0o020：所有用户组具有写权限。</li><li>0o010：所有用户组具有可执行权限。</li><li>0o007：其余用户具有读、写及可执行权限。</li><li>0o004：其余用户具有读权限。</li><li>0o002：其余用户具有写权限。</li><li>0o001：其余用户具有可执行权限。</li></ul> 352 </td> 353 </tr> 354 </tbody> 355 </table> 356 357- 示例： 358 359 ``` 360 fileio.mkdirSync(path); 361 ``` 362 363 364## fileio.openSync<a name="zh-cn_topic_0000001208447259_section7431145402220"></a> 365 366openSync\(path: string, flags?: number, mode?: number\): number 367 368以同步方法打开文件。 369 370- 参数： 371 372 <a name="zh-cn_topic_0000001208447259_table83121919193718"></a> 373 <table><thead align="left"><tr id="zh-cn_topic_0000001208447259_row1231219198379"><th class="cellrowborder" valign="top" width="9.49%" id="mcps1.1.5.1.1"><p id="zh-cn_topic_0000001208447259_p631213194378"><a name="zh-cn_topic_0000001208447259_p631213194378"></a><a name="zh-cn_topic_0000001208447259_p631213194378"></a>参数名</p> 374 </th> 375 <th class="cellrowborder" valign="top" width="11.67%" id="mcps1.1.5.1.2"><p id="zh-cn_topic_0000001208447259_p1631261963711"><a name="zh-cn_topic_0000001208447259_p1631261963711"></a><a name="zh-cn_topic_0000001208447259_p1631261963711"></a>类型</p> 376 </th> 377 <th class="cellrowborder" valign="top" width="8.260000000000002%" id="mcps1.1.5.1.3"><p id="zh-cn_topic_0000001208447259_p2312111913373"><a name="zh-cn_topic_0000001208447259_p2312111913373"></a><a name="zh-cn_topic_0000001208447259_p2312111913373"></a>必填</p> 378 </th> 379 <th class="cellrowborder" valign="top" width="70.58%" id="mcps1.1.5.1.4"><p id="zh-cn_topic_0000001208447259_p10312171919378"><a name="zh-cn_topic_0000001208447259_p10312171919378"></a><a name="zh-cn_topic_0000001208447259_p10312171919378"></a>说明</p> 380 </th> 381 </tr> 382 </thead> 383 <tbody><tr id="zh-cn_topic_0000001208447259_row12312101993717"><td class="cellrowborder" valign="top" width="9.49%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001208447259_p1313151963712"><a name="zh-cn_topic_0000001208447259_p1313151963712"></a><a name="zh-cn_topic_0000001208447259_p1313151963712"></a>path</p> 384 </td> 385 <td class="cellrowborder" valign="top" width="11.67%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001208447259_p831311198371"><a name="zh-cn_topic_0000001208447259_p831311198371"></a><a name="zh-cn_topic_0000001208447259_p831311198371"></a>string</p> 386 </td> 387 <td class="cellrowborder" valign="top" width="8.260000000000002%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001208447259_p6313161913379"><a name="zh-cn_topic_0000001208447259_p6313161913379"></a><a name="zh-cn_topic_0000001208447259_p6313161913379"></a>是</p> 388 </td> 389 <td class="cellrowborder" valign="top" width="70.58%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001208447259_p143141819183716"><a name="zh-cn_topic_0000001208447259_p143141819183716"></a><a name="zh-cn_topic_0000001208447259_p143141819183716"></a>待打开文件的绝对路径。</p> 390 </td> 391 </tr> 392 <tr id="zh-cn_topic_0000001208447259_row1194614489373"><td class="cellrowborder" valign="top" width="9.49%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001208447259_p1494624819379"><a name="zh-cn_topic_0000001208447259_p1494624819379"></a><a name="zh-cn_topic_0000001208447259_p1494624819379"></a>flags</p> 393 </td> 394 <td class="cellrowborder" valign="top" width="11.67%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001208447259_p17946448103710"><a name="zh-cn_topic_0000001208447259_p17946448103710"></a><a name="zh-cn_topic_0000001208447259_p17946448103710"></a>number</p> 395 </td> 396 <td class="cellrowborder" valign="top" width="8.260000000000002%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001208447259_p139471148183717"><a name="zh-cn_topic_0000001208447259_p139471148183717"></a><a name="zh-cn_topic_0000001208447259_p139471148183717"></a>否</p> 397 </td> 398 <td class="cellrowborder" valign="top" width="70.58%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001208447259_zh-cn_topic_0000001144081254_p0315175720016"><a name="zh-cn_topic_0000001208447259_zh-cn_topic_0000001144081254_p0315175720016"></a><a name="zh-cn_topic_0000001208447259_zh-cn_topic_0000001144081254_p0315175720016"></a>打开文件的选项，必须指定如下选项中的一个，默认以只读方式打开：</p> 399 <a name="zh-cn_topic_0000001208447259_zh-cn_topic_0000001144081254_ul13154571407"></a><a name="zh-cn_topic_0000001208447259_zh-cn_topic_0000001144081254_ul13154571407"></a><ul id="zh-cn_topic_0000001208447259_zh-cn_topic_0000001144081254_ul13154571407"><li>0o0：只读打开。</li><li>0o1：只写打开。</li><li>0o2：读写打开。</li></ul> 400 <p id="zh-cn_topic_0000001208447259_zh-cn_topic_0000001144081254_p431616571208"><a name="zh-cn_topic_0000001208447259_zh-cn_topic_0000001144081254_p431616571208"></a><a name="zh-cn_topic_0000001208447259_zh-cn_topic_0000001144081254_p431616571208"></a>同时，也可给定如下选项，以按位或的方式追加，默认不给定任何额外选项：</p> 401 <a name="zh-cn_topic_0000001208447259_zh-cn_topic_0000001144081254_ul73162575015"></a><a name="zh-cn_topic_0000001208447259_zh-cn_topic_0000001144081254_ul73162575015"></a><ul id="zh-cn_topic_0000001208447259_zh-cn_topic_0000001144081254_ul73162575015"><li>0o100：若文件不存在，则创建文件。使用该选项时必须指定第三个参数 mode。</li><li>0o200：如果追加了0o100选项，且文件已经存在，则出错。</li><li>0o1000：如果文件存在且以只写或读写的方式打开文件，则将其长度裁剪为零。</li><li>0o2000：以追加方式打开，后续写将追加到文件末尾。</li><li>0o4000：如果path指向FIFO、块特殊文件或字符特殊文件，则本次打开及后续 IO 进行非阻塞操作。</li><li>0o200000：如果path指向目录，则出错。</li><li>0o400000：如果path指向符号链接，则出错。</li><li>0o4010000：以同步IO的方式打开文件。</li></ul> 402 </td> 403 </tr> 404 <tr id="zh-cn_topic_0000001208447259_row1452413112392"><td class="cellrowborder" valign="top" width="9.49%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001208447259_p19524171115397"><a name="zh-cn_topic_0000001208447259_p19524171115397"></a><a name="zh-cn_topic_0000001208447259_p19524171115397"></a>mode</p> 405 </td> 406 <td class="cellrowborder" valign="top" width="11.67%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001208447259_p10524811193913"><a name="zh-cn_topic_0000001208447259_p10524811193913"></a><a name="zh-cn_topic_0000001208447259_p10524811193913"></a>number</p> 407 </td> 408 <td class="cellrowborder" valign="top" width="8.260000000000002%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001208447259_p1752419113399"><a name="zh-cn_topic_0000001208447259_p1752419113399"></a><a name="zh-cn_topic_0000001208447259_p1752419113399"></a>否</p> 409 </td> 410 <td class="cellrowborder" valign="top" width="70.58%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001208447259_zh-cn_topic_0000001144081254_p03171057708"><a name="zh-cn_topic_0000001208447259_zh-cn_topic_0000001144081254_p03171057708"></a><a name="zh-cn_topic_0000001208447259_zh-cn_topic_0000001144081254_p03171057708"></a>若创建文件，则指定文件的权限，可给定如下权限，以按位或的方式追加权限，默认给定0o666。</p> 411 <a name="zh-cn_topic_0000001208447259_zh-cn_topic_0000001144081254_ul1554605585712"></a><a name="zh-cn_topic_0000001208447259_zh-cn_topic_0000001144081254_ul1554605585712"></a><ul id="zh-cn_topic_0000001208447259_zh-cn_topic_0000001144081254_ul1554605585712"><li>0o666：所有者具有读、写权限，所有用户组具有读、写权限，其余用户具有读、写权限。</li><li>0o700：所有者具有读、写及可执行权限。</li><li>0o400：所有者具有读权限。</li><li>0o200：所有者具有写权限。</li><li>0o100：所有者具有可执行权限。</li><li>0o070：所有用户组具有读、写及可执行权限。</li><li>0o040：所有用户组具有读权限。</li><li>0o020：所有用户组具有写权限。</li><li>0o010：所有用户组具有可执行权限。</li><li>0o007：其余用户具有读、写及可执行权限。</li><li>0o004：其余用户具有读权限。</li><li>0o002：其余用户具有写权限。</li><li>0o001：其余用户具有可执行权限。</li></ul> 412 </td> 413 </tr> 414 </tbody> 415 </table> 416 417- 返回值： 418 419 <a name="zh-cn_topic_0000001208447259_table10314619113717"></a> 420 <table><thead align="left"><tr id="zh-cn_topic_0000001208447259_row1131431917373"><th class="cellrowborder" valign="top" width="17.01%" id="mcps1.1.3.1.1"><p id="zh-cn_topic_0000001208447259_p14314201914373"><a name="zh-cn_topic_0000001208447259_p14314201914373"></a><a name="zh-cn_topic_0000001208447259_p14314201914373"></a>类型</p> 421 </th> 422 <th class="cellrowborder" valign="top" width="82.99%" id="mcps1.1.3.1.2"><p id="zh-cn_topic_0000001208447259_p2314119103714"><a name="zh-cn_topic_0000001208447259_p2314119103714"></a><a name="zh-cn_topic_0000001208447259_p2314119103714"></a>说明</p> 423 </th> 424 </tr> 425 </thead> 426 <tbody><tr id="zh-cn_topic_0000001208447259_row1314151920378"><td class="cellrowborder" valign="top" width="17.01%" headers="mcps1.1.3.1.1 "><p id="zh-cn_topic_0000001208447259_p163146199374"><a name="zh-cn_topic_0000001208447259_p163146199374"></a><a name="zh-cn_topic_0000001208447259_p163146199374"></a>number</p> 427 </td> 428 <td class="cellrowborder" valign="top" width="82.99%" headers="mcps1.1.3.1.2 "><p id="zh-cn_topic_0000001208447259_p8314151912376"><a name="zh-cn_topic_0000001208447259_p8314151912376"></a><a name="zh-cn_topic_0000001208447259_p8314151912376"></a>打开文件的文件描述符。</p> 429 </td> 430 </tr> 431 </tbody> 432 </table> 433 434- 示例： 435 436 ``` 437 fileio.openSync(path); 438 ``` 439 440 441## fileio.readSync<a name="zh-cn_topic_0000001208447259_section1682515612227"></a> 442 443readSync\(fd: number, buffer: ArrayBuffer, options?: Object\): number 444 445以同步方法从文件读取数据。 446 447- 参数： 448 449 <a name="zh-cn_topic_0000001208447259_table17441612151511"></a> 450 <table><thead align="left"><tr id="zh-cn_topic_0000001208447259_row124410129159"><th class="cellrowborder" valign="top" width="14.82%" id="mcps1.1.5.1.1"><p id="zh-cn_topic_0000001208447259_p1944119126156"><a name="zh-cn_topic_0000001208447259_p1944119126156"></a><a name="zh-cn_topic_0000001208447259_p1944119126156"></a>参数名</p> 451 </th> 452 <th class="cellrowborder" valign="top" width="14.729999999999999%" id="mcps1.1.5.1.2"><p id="zh-cn_topic_0000001208447259_p14411312121519"><a name="zh-cn_topic_0000001208447259_p14411312121519"></a><a name="zh-cn_topic_0000001208447259_p14411312121519"></a>类型</p> 453 </th> 454 <th class="cellrowborder" valign="top" width="9.16%" id="mcps1.1.5.1.3"><p id="zh-cn_topic_0000001208447259_p9441101241511"><a name="zh-cn_topic_0000001208447259_p9441101241511"></a><a name="zh-cn_topic_0000001208447259_p9441101241511"></a>必填</p> 455 </th> 456 <th class="cellrowborder" valign="top" width="61.29%" id="mcps1.1.5.1.4"><p id="zh-cn_topic_0000001208447259_p1744111125158"><a name="zh-cn_topic_0000001208447259_p1744111125158"></a><a name="zh-cn_topic_0000001208447259_p1744111125158"></a>说明</p> 457 </th> 458 </tr> 459 </thead> 460 <tbody><tr id="zh-cn_topic_0000001208447259_row1644111211159"><td class="cellrowborder" valign="top" width="14.82%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001208447259_p344191214156"><a name="zh-cn_topic_0000001208447259_p344191214156"></a><a name="zh-cn_topic_0000001208447259_p344191214156"></a>fd</p> 461 </td> 462 <td class="cellrowborder" valign="top" width="14.729999999999999%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001208447259_p7441121219152"><a name="zh-cn_topic_0000001208447259_p7441121219152"></a><a name="zh-cn_topic_0000001208447259_p7441121219152"></a>number</p> 463 </td> 464 <td class="cellrowborder" valign="top" width="9.16%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001208447259_p20441121231516"><a name="zh-cn_topic_0000001208447259_p20441121231516"></a><a name="zh-cn_topic_0000001208447259_p20441121231516"></a>是</p> 465 </td> 466 <td class="cellrowborder" valign="top" width="61.29%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001208447259_p1044214122155"><a name="zh-cn_topic_0000001208447259_p1044214122155"></a><a name="zh-cn_topic_0000001208447259_p1044214122155"></a>待读取文件的文件描述符。</p> 467 </td> 468 </tr> 469 <tr id="zh-cn_topic_0000001208447259_row1944211231512"><td class="cellrowborder" valign="top" width="14.82%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001208447259_p134429128159"><a name="zh-cn_topic_0000001208447259_p134429128159"></a><a name="zh-cn_topic_0000001208447259_p134429128159"></a>buffer</p> 470 </td> 471 <td class="cellrowborder" valign="top" width="14.729999999999999%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001208447259_p184424121155"><a name="zh-cn_topic_0000001208447259_p184424121155"></a><a name="zh-cn_topic_0000001208447259_p184424121155"></a>ArrayBuffer</p> 472 </td> 473 <td class="cellrowborder" valign="top" width="9.16%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001208447259_p144214127151"><a name="zh-cn_topic_0000001208447259_p144214127151"></a><a name="zh-cn_topic_0000001208447259_p144214127151"></a>是</p> 474 </td> 475 <td class="cellrowborder" valign="top" width="61.29%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001208447259_p6442181219155"><a name="zh-cn_topic_0000001208447259_p6442181219155"></a><a name="zh-cn_topic_0000001208447259_p6442181219155"></a>用于读取文件的缓冲区。</p> 476 </td> 477 </tr> 478 <tr id="zh-cn_topic_0000001208447259_row1444211281512"><td class="cellrowborder" valign="top" width="14.82%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001208447259_p84421812181516"><a name="zh-cn_topic_0000001208447259_p84421812181516"></a><a name="zh-cn_topic_0000001208447259_p84421812181516"></a>options</p> 479 </td> 480 <td class="cellrowborder" valign="top" width="14.729999999999999%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001208447259_p1544217123151"><a name="zh-cn_topic_0000001208447259_p1544217123151"></a><a name="zh-cn_topic_0000001208447259_p1544217123151"></a>Object</p> 481 </td> 482 <td class="cellrowborder" valign="top" width="9.16%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001208447259_p124421812131517"><a name="zh-cn_topic_0000001208447259_p124421812131517"></a><a name="zh-cn_topic_0000001208447259_p124421812131517"></a>否</p> 483 </td> 484 <td class="cellrowborder" valign="top" width="61.29%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001208447259_p15442141216157"><a name="zh-cn_topic_0000001208447259_p15442141216157"></a><a name="zh-cn_topic_0000001208447259_p15442141216157"></a>支持如下选项：</p> 485 <a name="zh-cn_topic_0000001208447259_ul1644261221514"></a><a name="zh-cn_topic_0000001208447259_ul1644261221514"></a><ul id="zh-cn_topic_0000001208447259_ul1644261221514"><li>offset，number 类型，表示将数据读取到缓冲区的位置，即相对于缓冲区首地址的偏移。可选，默认为0。</li><li>length，number 类型，表示期望读取数据的长度。可选，默认缓冲区长度减去偏移长度。</li><li>position，number 类型，表示期望读取文件的位置。可选，默认从当前位置开始读。</li></ul> 486 </td> 487 </tr> 488 </tbody> 489 </table> 490 491- 返回值： 492 493 <a name="zh-cn_topic_0000001208447259_table13442121215151"></a> 494 <table><thead align="left"><tr id="zh-cn_topic_0000001208447259_row1844261201511"><th class="cellrowborder" valign="top" width="17.01%" id="mcps1.1.3.1.1"><p id="zh-cn_topic_0000001208447259_p10442101212158"><a name="zh-cn_topic_0000001208447259_p10442101212158"></a><a name="zh-cn_topic_0000001208447259_p10442101212158"></a>类型</p> 495 </th> 496 <th class="cellrowborder" valign="top" width="82.99%" id="mcps1.1.3.1.2"><p id="zh-cn_topic_0000001208447259_p1444241251511"><a name="zh-cn_topic_0000001208447259_p1444241251511"></a><a name="zh-cn_topic_0000001208447259_p1444241251511"></a>说明</p> 497 </th> 498 </tr> 499 </thead> 500 <tbody><tr id="zh-cn_topic_0000001208447259_row104429125154"><td class="cellrowborder" valign="top" width="17.01%" headers="mcps1.1.3.1.1 "><p id="zh-cn_topic_0000001208447259_p14422012101515"><a name="zh-cn_topic_0000001208447259_p14422012101515"></a><a name="zh-cn_topic_0000001208447259_p14422012101515"></a>number</p> 501 </td> 502 <td class="cellrowborder" valign="top" width="82.99%" headers="mcps1.1.3.1.2 "><p id="zh-cn_topic_0000001208447259_p244314126154"><a name="zh-cn_topic_0000001208447259_p244314126154"></a><a name="zh-cn_topic_0000001208447259_p244314126154"></a>实际读取的长度。</p> 503 </td> 504 </tr> 505 </tbody> 506 </table> 507 508- 示例： 509 510 ``` 511 let fd = fileio.openSync(path, 0o2); 512 let buf = new ArrayBuffer(4096); 513 fileio.readSync(fd, buf); 514 console.log(String.fromCharCode.apply(null, new Uint8Array(buf))); 515 ``` 516 517 518## fileio.rmdirSync<a name="zh-cn_topic_0000001208447259_section1420012610423"></a> 519 520rmdirSync\(path: string\): void 521 522以同步方法删除目录。 523 524- 参数： 525 526 <a name="zh-cn_topic_0000001208447259_table172741614151417"></a> 527 <table><thead align="left"><tr id="zh-cn_topic_0000001208447259_row4274514181420"><th class="cellrowborder" valign="top" width="14.82%" id="mcps1.1.5.1.1"><p id="zh-cn_topic_0000001208447259_p7274161461418"><a name="zh-cn_topic_0000001208447259_p7274161461418"></a><a name="zh-cn_topic_0000001208447259_p7274161461418"></a>参数名</p> 528 </th> 529 <th class="cellrowborder" valign="top" width="14.729999999999999%" id="mcps1.1.5.1.2"><p id="zh-cn_topic_0000001208447259_p0274111414143"><a name="zh-cn_topic_0000001208447259_p0274111414143"></a><a name="zh-cn_topic_0000001208447259_p0274111414143"></a>类型</p> 530 </th> 531 <th class="cellrowborder" valign="top" width="9.16%" id="mcps1.1.5.1.3"><p id="zh-cn_topic_0000001208447259_p1127471451416"><a name="zh-cn_topic_0000001208447259_p1127471451416"></a><a name="zh-cn_topic_0000001208447259_p1127471451416"></a>必填</p> 532 </th> 533 <th class="cellrowborder" valign="top" width="61.29%" id="mcps1.1.5.1.4"><p id="zh-cn_topic_0000001208447259_p1827414149145"><a name="zh-cn_topic_0000001208447259_p1827414149145"></a><a name="zh-cn_topic_0000001208447259_p1827414149145"></a>说明</p> 534 </th> 535 </tr> 536 </thead> 537 <tbody><tr id="zh-cn_topic_0000001208447259_row15274161461412"><td class="cellrowborder" valign="top" width="14.82%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001208447259_p1027421431410"><a name="zh-cn_topic_0000001208447259_p1027421431410"></a><a name="zh-cn_topic_0000001208447259_p1027421431410"></a>path</p> 538 </td> 539 <td class="cellrowborder" valign="top" width="14.729999999999999%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001208447259_p182741014181418"><a name="zh-cn_topic_0000001208447259_p182741014181418"></a><a name="zh-cn_topic_0000001208447259_p182741014181418"></a>string</p> 540 </td> 541 <td class="cellrowborder" valign="top" width="9.16%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001208447259_p14274161431417"><a name="zh-cn_topic_0000001208447259_p14274161431417"></a><a name="zh-cn_topic_0000001208447259_p14274161431417"></a>是</p> 542 </td> 543 <td class="cellrowborder" valign="top" width="61.29%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001208447259_p827414142144"><a name="zh-cn_topic_0000001208447259_p827414142144"></a><a name="zh-cn_topic_0000001208447259_p827414142144"></a>待删除目录的绝对路径。</p> 544 </td> 545 </tr> 546 </tbody> 547 </table> 548 549- 示例： 550 551 ``` 552 fileio.rmdirSync(path); 553 ``` 554 555 556## fileio.unlinkSync<a name="zh-cn_topic_0000001208447259_section1659112267472"></a> 557 558unlinkSync\(path: string\): void 559 560以同步方法删除文件。 561 562- 参数： 563 564 <a name="zh-cn_topic_0000001208447259_table10902246174"></a> 565 <table><thead align="left"><tr id="zh-cn_topic_0000001208447259_row13903174617711"><th class="cellrowborder" valign="top" width="14.82%" id="mcps1.1.5.1.1"><p id="zh-cn_topic_0000001208447259_p99031146778"><a name="zh-cn_topic_0000001208447259_p99031146778"></a><a name="zh-cn_topic_0000001208447259_p99031146778"></a>参数名</p> 566 </th> 567 <th class="cellrowborder" valign="top" width="14.729999999999999%" id="mcps1.1.5.1.2"><p id="zh-cn_topic_0000001208447259_p79034461674"><a name="zh-cn_topic_0000001208447259_p79034461674"></a><a name="zh-cn_topic_0000001208447259_p79034461674"></a>类型</p> 568 </th> 569 <th class="cellrowborder" valign="top" width="9.16%" id="mcps1.1.5.1.3"><p id="zh-cn_topic_0000001208447259_p149030464710"><a name="zh-cn_topic_0000001208447259_p149030464710"></a><a name="zh-cn_topic_0000001208447259_p149030464710"></a>必填</p> 570 </th> 571 <th class="cellrowborder" valign="top" width="61.29%" id="mcps1.1.5.1.4"><p id="zh-cn_topic_0000001208447259_p1790334610714"><a name="zh-cn_topic_0000001208447259_p1790334610714"></a><a name="zh-cn_topic_0000001208447259_p1790334610714"></a>说明</p> 572 </th> 573 </tr> 574 </thead> 575 <tbody><tr id="zh-cn_topic_0000001208447259_row49035468712"><td class="cellrowborder" valign="top" width="14.82%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001208447259_p1390316468713"><a name="zh-cn_topic_0000001208447259_p1390316468713"></a><a name="zh-cn_topic_0000001208447259_p1390316468713"></a>path</p> 576 </td> 577 <td class="cellrowborder" valign="top" width="14.729999999999999%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001208447259_p2090384611710"><a name="zh-cn_topic_0000001208447259_p2090384611710"></a><a name="zh-cn_topic_0000001208447259_p2090384611710"></a>string</p> 578 </td> 579 <td class="cellrowborder" valign="top" width="9.16%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001208447259_p159031846575"><a name="zh-cn_topic_0000001208447259_p159031846575"></a><a name="zh-cn_topic_0000001208447259_p159031846575"></a>是</p> 580 </td> 581 <td class="cellrowborder" valign="top" width="61.29%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001208447259_p7903124619711"><a name="zh-cn_topic_0000001208447259_p7903124619711"></a><a name="zh-cn_topic_0000001208447259_p7903124619711"></a>待删除文件的绝对路径。</p> 582 </td> 583 </tr> 584 </tbody> 585 </table> 586 587- 示例： 588 589 ``` 590 fileio.unlinkSync(path); 591 ``` 592 593 594## fileio.writeSync<a name="zh-cn_topic_0000001208447259_section144923345218"></a> 595 596writeSync\(fd: number, buffer: ArrayBuffer | string, options?:Object\): number 597 598以同步方法将数据写入文件。 599 600- 参数： 601 602 <a name="zh-cn_topic_0000001208447259_table13943194014108"></a> 603 <table><thead align="left"><tr id="zh-cn_topic_0000001208447259_row6944940101012"><th class="cellrowborder" valign="top" width="14.82%" id="mcps1.1.5.1.1"><p id="zh-cn_topic_0000001208447259_p149447402107"><a name="zh-cn_topic_0000001208447259_p149447402107"></a><a name="zh-cn_topic_0000001208447259_p149447402107"></a>参数名</p> 604 </th> 605 <th class="cellrowborder" valign="top" width="20.62%" id="mcps1.1.5.1.2"><p id="zh-cn_topic_0000001208447259_p1944184011102"><a name="zh-cn_topic_0000001208447259_p1944184011102"></a><a name="zh-cn_topic_0000001208447259_p1944184011102"></a>类型</p> 606 </th> 607 <th class="cellrowborder" valign="top" width="7.359999999999999%" id="mcps1.1.5.1.3"><p id="zh-cn_topic_0000001208447259_p11944174001010"><a name="zh-cn_topic_0000001208447259_p11944174001010"></a><a name="zh-cn_topic_0000001208447259_p11944174001010"></a>必填</p> 608 </th> 609 <th class="cellrowborder" valign="top" width="57.199999999999996%" id="mcps1.1.5.1.4"><p id="zh-cn_topic_0000001208447259_p894554017109"><a name="zh-cn_topic_0000001208447259_p894554017109"></a><a name="zh-cn_topic_0000001208447259_p894554017109"></a>说明</p> 610 </th> 611 </tr> 612 </thead> 613 <tbody><tr id="zh-cn_topic_0000001208447259_row199459404101"><td class="cellrowborder" valign="top" width="14.82%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001208447259_p16945440121019"><a name="zh-cn_topic_0000001208447259_p16945440121019"></a><a name="zh-cn_topic_0000001208447259_p16945440121019"></a>fd</p> 614 </td> 615 <td class="cellrowborder" valign="top" width="20.62%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001208447259_p194517403109"><a name="zh-cn_topic_0000001208447259_p194517403109"></a><a name="zh-cn_topic_0000001208447259_p194517403109"></a>number</p> 616 </td> 617 <td class="cellrowborder" valign="top" width="7.359999999999999%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001208447259_p14945204017104"><a name="zh-cn_topic_0000001208447259_p14945204017104"></a><a name="zh-cn_topic_0000001208447259_p14945204017104"></a>是</p> 618 </td> 619 <td class="cellrowborder" valign="top" width="57.199999999999996%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001208447259_p094584020101"><a name="zh-cn_topic_0000001208447259_p094584020101"></a><a name="zh-cn_topic_0000001208447259_p094584020101"></a>待写入文件的文件描述符。</p> 620 </td> 621 </tr> 622 <tr id="zh-cn_topic_0000001208447259_row7946174015104"><td class="cellrowborder" valign="top" width="14.82%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001208447259_p094610401102"><a name="zh-cn_topic_0000001208447259_p094610401102"></a><a name="zh-cn_topic_0000001208447259_p094610401102"></a>buffer</p> 623 </td> 624 <td class="cellrowborder" valign="top" width="20.62%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001208447259_p5946144012109"><a name="zh-cn_topic_0000001208447259_p5946144012109"></a><a name="zh-cn_topic_0000001208447259_p5946144012109"></a>ArrayBuffer | string</p> 625 </td> 626 <td class="cellrowborder" valign="top" width="7.359999999999999%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001208447259_p1794674018108"><a name="zh-cn_topic_0000001208447259_p1794674018108"></a><a name="zh-cn_topic_0000001208447259_p1794674018108"></a>是</p> 627 </td> 628 <td class="cellrowborder" valign="top" width="57.199999999999996%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001208447259_p129466403102"><a name="zh-cn_topic_0000001208447259_p129466403102"></a><a name="zh-cn_topic_0000001208447259_p129466403102"></a>待写入文件的数据，可来自缓冲区或字符串。</p> 629 </td> 630 </tr> 631 <tr id="zh-cn_topic_0000001208447259_row16946204012103"><td class="cellrowborder" valign="top" width="14.82%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001208447259_p1946840141012"><a name="zh-cn_topic_0000001208447259_p1946840141012"></a><a name="zh-cn_topic_0000001208447259_p1946840141012"></a>options</p> 632 </td> 633 <td class="cellrowborder" valign="top" width="20.62%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001208447259_p69477400104"><a name="zh-cn_topic_0000001208447259_p69477400104"></a><a name="zh-cn_topic_0000001208447259_p69477400104"></a>Object</p> 634 </td> 635 <td class="cellrowborder" valign="top" width="7.359999999999999%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001208447259_p4947164021013"><a name="zh-cn_topic_0000001208447259_p4947164021013"></a><a name="zh-cn_topic_0000001208447259_p4947164021013"></a>否</p> 636 </td> 637 <td class="cellrowborder" valign="top" width="57.199999999999996%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001208447259_p16947154021011"><a name="zh-cn_topic_0000001208447259_p16947154021011"></a><a name="zh-cn_topic_0000001208447259_p16947154021011"></a>支持如下选项：</p> 638 <a name="zh-cn_topic_0000001208447259_ul14947144014103"></a><a name="zh-cn_topic_0000001208447259_ul14947144014103"></a><ul id="zh-cn_topic_0000001208447259_ul14947144014103"><li>offset，number类型，表示期望写入数据的位置相对于数据首地址的偏移。可选，默认为0。</li><li>length，number类型，表示期望写入数据的长度。可选，默认缓冲区长度减去偏移长度。</li><li>position，number类型，表示期望写入文件的位置。可选，默认从当前位置开始写。</li><li>encoding，string类型，当数据是 string 类型时有效，表示数据的编码方式，默认 'utf-8'，仅支持 'utf-8'。</li></ul> 639 </td> 640 </tr> 641 </tbody> 642 </table> 643 644- 返回值： 645 646 <a name="zh-cn_topic_0000001208447259_table13948204031017"></a> 647 <table><thead align="left"><tr id="zh-cn_topic_0000001208447259_row4948204031017"><th class="cellrowborder" valign="top" width="17.01%" id="mcps1.1.3.1.1"><p id="zh-cn_topic_0000001208447259_p11948540191013"><a name="zh-cn_topic_0000001208447259_p11948540191013"></a><a name="zh-cn_topic_0000001208447259_p11948540191013"></a>类型</p> 648 </th> 649 <th class="cellrowborder" valign="top" width="82.99%" id="mcps1.1.3.1.2"><p id="zh-cn_topic_0000001208447259_p894954091017"><a name="zh-cn_topic_0000001208447259_p894954091017"></a><a name="zh-cn_topic_0000001208447259_p894954091017"></a>说明</p> 650 </th> 651 </tr> 652 </thead> 653 <tbody><tr id="zh-cn_topic_0000001208447259_row149491940101010"><td class="cellrowborder" valign="top" width="17.01%" headers="mcps1.1.3.1.1 "><p id="zh-cn_topic_0000001208447259_p20949184091011"><a name="zh-cn_topic_0000001208447259_p20949184091011"></a><a name="zh-cn_topic_0000001208447259_p20949184091011"></a>number</p> 654 </td> 655 <td class="cellrowborder" valign="top" width="82.99%" headers="mcps1.1.3.1.2 "><p id="zh-cn_topic_0000001208447259_p1494984011100"><a name="zh-cn_topic_0000001208447259_p1494984011100"></a><a name="zh-cn_topic_0000001208447259_p1494984011100"></a>实际写入的长度。</p> 656 </td> 657 </tr> 658 </tbody> 659 </table> 660 661- 示例： 662 663 ``` 664 let fd = fileio.openSync(path, 0o102, 0o666); 665 fileio.writeSync(fd, "hello, world"); 666 ``` 667 668 669## fileio.chmodSync<sup>7+</sup><a name="zh-cn_topic_0000001208447259_section199971741181414"></a> 670 671chmodSync\(path: string, mode: number\): void 672 673以同步方法基于文件路径改变文件权限。 674 675- 参数： 676 677 <a name="zh-cn_topic_0000001208447259_table7498121613156"></a> 678 <table><thead align="left"><tr id="zh-cn_topic_0000001208447259_row2498151631511"><th class="cellrowborder" valign="top" width="14.82%" id="mcps1.1.5.1.1"><p id="zh-cn_topic_0000001208447259_p4498171610155"><a name="zh-cn_topic_0000001208447259_p4498171610155"></a><a name="zh-cn_topic_0000001208447259_p4498171610155"></a>参数名</p> 679 </th> 680 <th class="cellrowborder" valign="top" width="15.58%" id="mcps1.1.5.1.2"><p id="zh-cn_topic_0000001208447259_p13498151611512"><a name="zh-cn_topic_0000001208447259_p13498151611512"></a><a name="zh-cn_topic_0000001208447259_p13498151611512"></a>类型</p> 681 </th> 682 <th class="cellrowborder" valign="top" width="7.37%" id="mcps1.1.5.1.3"><p id="zh-cn_topic_0000001208447259_p1849841621512"><a name="zh-cn_topic_0000001208447259_p1849841621512"></a><a name="zh-cn_topic_0000001208447259_p1849841621512"></a>必填</p> 683 </th> 684 <th class="cellrowborder" valign="top" width="62.23%" id="mcps1.1.5.1.4"><p id="zh-cn_topic_0000001208447259_p104981716121516"><a name="zh-cn_topic_0000001208447259_p104981716121516"></a><a name="zh-cn_topic_0000001208447259_p104981716121516"></a>说明</p> 685 </th> 686 </tr> 687 </thead> 688 <tbody><tr id="zh-cn_topic_0000001208447259_row94981416121519"><td class="cellrowborder" valign="top" width="14.82%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001208447259_p749991610154"><a name="zh-cn_topic_0000001208447259_p749991610154"></a><a name="zh-cn_topic_0000001208447259_p749991610154"></a>path</p> 689 </td> 690 <td class="cellrowborder" valign="top" width="15.58%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001208447259_p3499151613151"><a name="zh-cn_topic_0000001208447259_p3499151613151"></a><a name="zh-cn_topic_0000001208447259_p3499151613151"></a>string</p> 691 </td> 692 <td class="cellrowborder" valign="top" width="7.37%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001208447259_p11499101618154"><a name="zh-cn_topic_0000001208447259_p11499101618154"></a><a name="zh-cn_topic_0000001208447259_p11499101618154"></a>是</p> 693 </td> 694 <td class="cellrowborder" valign="top" width="62.23%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001208447259_p174992161153"><a name="zh-cn_topic_0000001208447259_p174992161153"></a><a name="zh-cn_topic_0000001208447259_p174992161153"></a>待改变文件权限的绝对路径。</p> 695 </td> 696 </tr> 697 <tr id="zh-cn_topic_0000001208447259_row1349981621513"><td class="cellrowborder" valign="top" width="14.82%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001208447259_p6499191661513"><a name="zh-cn_topic_0000001208447259_p6499191661513"></a><a name="zh-cn_topic_0000001208447259_p6499191661513"></a>mode</p> 698 </td> 699 <td class="cellrowborder" valign="top" width="15.58%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001208447259_p1649961671518"><a name="zh-cn_topic_0000001208447259_p1649961671518"></a><a name="zh-cn_topic_0000001208447259_p1649961671518"></a>number</p> 700 </td> 701 <td class="cellrowborder" valign="top" width="7.37%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001208447259_p11499121631517"><a name="zh-cn_topic_0000001208447259_p11499121631517"></a><a name="zh-cn_topic_0000001208447259_p11499121631517"></a>是</p> 702 </td> 703 <td class="cellrowborder" valign="top" width="62.23%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001144081254_p598318203228"><a name="zh-cn_topic_0000001144081254_p598318203228"></a><a name="zh-cn_topic_0000001144081254_p598318203228"></a>改变文件权限，可给定如下权限，以按位或的方式追加权限。</p> 704 <a name="zh-cn_topic_0000001144081254_ul14983162018222"></a><a name="zh-cn_topic_0000001144081254_ul14983162018222"></a><ul id="zh-cn_topic_0000001144081254_ul14983162018222"><li>0o700：所有者具有读、写及可执行权限。</li><li>0o400：所有者具有读权限。</li><li>0o200：所有者具有写权限。</li><li>0o100：所有者具有可执行权限。</li><li>0o070：所有用户组具有读、写及可执行权限。</li><li>0o040：所有用户组具有读权限。</li><li>0o020：所有用户组具有写权限。</li><li>0o010：所有用户组具有可执行权限。</li><li>0o007：其余用户具有读、写及可执行权限。</li><li>0o004：其余用户具有读权限。</li><li>0o002：其余用户具有写权限。</li><li>0o001：其余用户具有可执行权限。</li></ul> 705 </td> 706 </tr> 707 </tbody> 708 </table> 709 710- 示例： 711 712 ``` 713 fileio.chmodSync(fpath, mode); 714 ``` 715 716 717## fileio.fstatSync<sup>7+</sup><a name="zh-cn_topic_0000001208447259_section14821537102219"></a> 718 719fstatSync\(fd: number\): Stat 720 721以同步方法基于文件描述符获取文件状态信息。 722 723- 参数： 724 725 <a name="zh-cn_topic_0000001208447259_table1318758152213"></a> 726 <table><thead align="left"><tr id="zh-cn_topic_0000001208447259_row431955802216"><th class="cellrowborder" valign="top" width="14.82%" id="mcps1.1.5.1.1"><p id="zh-cn_topic_0000001208447259_p931935832210"><a name="zh-cn_topic_0000001208447259_p931935832210"></a><a name="zh-cn_topic_0000001208447259_p931935832210"></a>参数名</p> 727 </th> 728 <th class="cellrowborder" valign="top" width="20.62%" id="mcps1.1.5.1.2"><p id="zh-cn_topic_0000001208447259_p1431925872217"><a name="zh-cn_topic_0000001208447259_p1431925872217"></a><a name="zh-cn_topic_0000001208447259_p1431925872217"></a>类型</p> 729 </th> 730 <th class="cellrowborder" valign="top" width="7.359999999999999%" id="mcps1.1.5.1.3"><p id="zh-cn_topic_0000001208447259_p632065812228"><a name="zh-cn_topic_0000001208447259_p632065812228"></a><a name="zh-cn_topic_0000001208447259_p632065812228"></a>必填</p> 731 </th> 732 <th class="cellrowborder" valign="top" width="57.199999999999996%" id="mcps1.1.5.1.4"><p id="zh-cn_topic_0000001208447259_p143202586223"><a name="zh-cn_topic_0000001208447259_p143202586223"></a><a name="zh-cn_topic_0000001208447259_p143202586223"></a>说明</p> 733 </th> 734 </tr> 735 </thead> 736 <tbody><tr id="zh-cn_topic_0000001208447259_row1432015811226"><td class="cellrowborder" valign="top" width="14.82%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001208447259_p11321115832213"><a name="zh-cn_topic_0000001208447259_p11321115832213"></a><a name="zh-cn_topic_0000001208447259_p11321115832213"></a>fd</p> 737 </td> 738 <td class="cellrowborder" valign="top" width="20.62%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001208447259_p113211588229"><a name="zh-cn_topic_0000001208447259_p113211588229"></a><a name="zh-cn_topic_0000001208447259_p113211588229"></a>number</p> 739 </td> 740 <td class="cellrowborder" valign="top" width="7.359999999999999%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001208447259_p113211658192212"><a name="zh-cn_topic_0000001208447259_p113211658192212"></a><a name="zh-cn_topic_0000001208447259_p113211658192212"></a>是</p> 741 </td> 742 <td class="cellrowborder" valign="top" width="57.199999999999996%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001208447259_p1032135842220"><a name="zh-cn_topic_0000001208447259_p1032135842220"></a><a name="zh-cn_topic_0000001208447259_p1032135842220"></a>待获取文件的文件描述符。</p> 743 </td> 744 </tr> 745 </tbody> 746 </table> 747 748 749- 返回值： 750 751 <a name="zh-cn_topic_0000001208447259_table1432119586228"></a> 752 <table><thead align="left"><tr id="zh-cn_topic_0000001208447259_row232195820224"><th class="cellrowborder" valign="top" width="17.01%" id="mcps1.1.3.1.1"><p id="zh-cn_topic_0000001208447259_p4322658182215"><a name="zh-cn_topic_0000001208447259_p4322658182215"></a><a name="zh-cn_topic_0000001208447259_p4322658182215"></a>类型</p> 753 </th> 754 <th class="cellrowborder" valign="top" width="82.99%" id="mcps1.1.3.1.2"><p id="zh-cn_topic_0000001208447259_p03222058162215"><a name="zh-cn_topic_0000001208447259_p03222058162215"></a><a name="zh-cn_topic_0000001208447259_p03222058162215"></a>说明</p> 755 </th> 756 </tr> 757 </thead> 758 <tbody><tr id="zh-cn_topic_0000001208447259_row1032275817222"><td class="cellrowborder" valign="top" width="17.01%" headers="mcps1.1.3.1.1 "><p id="zh-cn_topic_0000001208447259_p75973654013"><a name="zh-cn_topic_0000001208447259_p75973654013"></a><a name="zh-cn_topic_0000001208447259_p75973654013"></a>Promise<Stat></p> 759 </td> 760 <td class="cellrowborder" valign="top" width="82.99%" headers="mcps1.1.3.1.2 "><p id="zh-cn_topic_0000001208447259_p12597269404"><a name="zh-cn_topic_0000001208447259_p12597269404"></a><a name="zh-cn_topic_0000001208447259_p12597269404"></a>表示文件的具体信息。</p> 761 </td> 762 </tr> 763 </tbody> 764 </table> 765 766 767- 示例： 768 769 ``` 770 let fd = fileio.openSync(path); 771 let stat = fileio.fstatSync(fd); 772 ``` 773 774 775## fileio.ftruncateSync<sup>7+</sup><a name="zh-cn_topic_0000001208447259_section514613516446"></a> 776 777ftruncateSync\(fd: number, len?: number\): void 778 779以同步方法基于文件描述符截断文件。 780 781- 参数： 782 783 <a name="zh-cn_topic_0000001208447259_table171461935114413"></a> 784 <table><thead align="left"><tr id="zh-cn_topic_0000001208447259_row15147113510445"><th class="cellrowborder" valign="top" width="14.82%" id="mcps1.1.5.1.1"><p id="zh-cn_topic_0000001208447259_p1614753518444"><a name="zh-cn_topic_0000001208447259_p1614753518444"></a><a name="zh-cn_topic_0000001208447259_p1614753518444"></a>参数名</p> 785 </th> 786 <th class="cellrowborder" valign="top" width="20.62%" id="mcps1.1.5.1.2"><p id="zh-cn_topic_0000001208447259_p1314783574414"><a name="zh-cn_topic_0000001208447259_p1314783574414"></a><a name="zh-cn_topic_0000001208447259_p1314783574414"></a>类型</p> 787 </th> 788 <th class="cellrowborder" valign="top" width="7.359999999999999%" id="mcps1.1.5.1.3"><p id="zh-cn_topic_0000001208447259_p3147133512441"><a name="zh-cn_topic_0000001208447259_p3147133512441"></a><a name="zh-cn_topic_0000001208447259_p3147133512441"></a>必填</p> 789 </th> 790 <th class="cellrowborder" valign="top" width="57.199999999999996%" id="mcps1.1.5.1.4"><p id="zh-cn_topic_0000001208447259_p1514753513442"><a name="zh-cn_topic_0000001208447259_p1514753513442"></a><a name="zh-cn_topic_0000001208447259_p1514753513442"></a>说明</p> 791 </th> 792 </tr> 793 </thead> 794 <tbody><tr id="zh-cn_topic_0000001208447259_row1514716354442"><td class="cellrowborder" valign="top" width="14.82%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001208447259_p94460314520"><a name="zh-cn_topic_0000001208447259_p94460314520"></a><a name="zh-cn_topic_0000001208447259_p94460314520"></a>fd</p> 795 </td> 796 <td class="cellrowborder" valign="top" width="20.62%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001208447259_p1044616334513"><a name="zh-cn_topic_0000001208447259_p1044616334513"></a><a name="zh-cn_topic_0000001208447259_p1044616334513"></a>number</p> 797 </td> 798 <td class="cellrowborder" valign="top" width="7.359999999999999%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001208447259_p15446639458"><a name="zh-cn_topic_0000001208447259_p15446639458"></a><a name="zh-cn_topic_0000001208447259_p15446639458"></a>是</p> 799 </td> 800 <td class="cellrowborder" valign="top" width="57.199999999999996%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001208447259_p2446103114518"><a name="zh-cn_topic_0000001208447259_p2446103114518"></a><a name="zh-cn_topic_0000001208447259_p2446103114518"></a>待截断文件的文件描述符。</p> 801 </td> 802 </tr> 803 <tr id="zh-cn_topic_0000001208447259_row614812359442"><td class="cellrowborder" valign="top" width="14.82%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001208447259_p1644610344516"><a name="zh-cn_topic_0000001208447259_p1644610344516"></a><a name="zh-cn_topic_0000001208447259_p1644610344516"></a>len</p> 804 </td> 805 <td class="cellrowborder" valign="top" width="20.62%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001208447259_p184461931459"><a name="zh-cn_topic_0000001208447259_p184461931459"></a><a name="zh-cn_topic_0000001208447259_p184461931459"></a>number</p> 806 </td> 807 <td class="cellrowborder" valign="top" width="7.359999999999999%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001208447259_p64469311451"><a name="zh-cn_topic_0000001208447259_p64469311451"></a><a name="zh-cn_topic_0000001208447259_p64469311451"></a>否</p> 808 </td> 809 <td class="cellrowborder" valign="top" width="57.199999999999996%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001208447259_p1946656171316"><a name="zh-cn_topic_0000001208447259_p1946656171316"></a><a name="zh-cn_topic_0000001208447259_p1946656171316"></a>文件截断后的长度，以字节为单位。</p> 810 </td> 811 </tr> 812 </tbody> 813 </table> 814 815 816- 示例： 817 818 ``` 819 fileio.ftruncate(fd, len); 820 ``` 821 822 823## fileio.fchmodSync<sup>7+</sup><a name="zh-cn_topic_0000001208447259_section16345147182418"></a> 824 825fchmodSync\(existingPath: string, newPath: string\): void 826 827以同步方法基于文件描述符改变文件权限。 828 829- 参数： 830 831 <a name="zh-cn_topic_0000001208447259_table134612718249"></a> 832 <table><thead align="left"><tr id="zh-cn_topic_0000001208447259_row934607172416"><th class="cellrowborder" valign="top" width="14.82%" id="mcps1.1.5.1.1"><p id="zh-cn_topic_0000001208447259_p63468792413"><a name="zh-cn_topic_0000001208447259_p63468792413"></a><a name="zh-cn_topic_0000001208447259_p63468792413"></a>参数名</p> 833 </th> 834 <th class="cellrowborder" valign="top" width="14.729999999999999%" id="mcps1.1.5.1.2"><p id="zh-cn_topic_0000001208447259_p1234719722417"><a name="zh-cn_topic_0000001208447259_p1234719722417"></a><a name="zh-cn_topic_0000001208447259_p1234719722417"></a>类型</p> 835 </th> 836 <th class="cellrowborder" valign="top" width="9.16%" id="mcps1.1.5.1.3"><p id="zh-cn_topic_0000001208447259_p93476716246"><a name="zh-cn_topic_0000001208447259_p93476716246"></a><a name="zh-cn_topic_0000001208447259_p93476716246"></a>必填</p> 837 </th> 838 <th class="cellrowborder" valign="top" width="61.29%" id="mcps1.1.5.1.4"><p id="zh-cn_topic_0000001208447259_p83472714248"><a name="zh-cn_topic_0000001208447259_p83472714248"></a><a name="zh-cn_topic_0000001208447259_p83472714248"></a>说明</p> 839 </th> 840 </tr> 841 </thead> 842 <tbody><tr id="zh-cn_topic_0000001208447259_row1534710711248"><td class="cellrowborder" valign="top" width="14.82%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001208447259_p634719710243"><a name="zh-cn_topic_0000001208447259_p634719710243"></a><a name="zh-cn_topic_0000001208447259_p634719710243"></a>fd</p> 843 </td> 844 <td class="cellrowborder" valign="top" width="14.729999999999999%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001208447259_p17348147122417"><a name="zh-cn_topic_0000001208447259_p17348147122417"></a><a name="zh-cn_topic_0000001208447259_p17348147122417"></a>number</p> 845 </td> 846 <td class="cellrowborder" valign="top" width="9.16%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001208447259_p15348207152417"><a name="zh-cn_topic_0000001208447259_p15348207152417"></a><a name="zh-cn_topic_0000001208447259_p15348207152417"></a>是</p> 847 </td> 848 <td class="cellrowborder" valign="top" width="61.29%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001208447259_p91788493584"><a name="zh-cn_topic_0000001208447259_p91788493584"></a><a name="zh-cn_topic_0000001208447259_p91788493584"></a>待改变文件的文件描述符。</p> 849 </td> 850 </tr> 851 <tr id="zh-cn_topic_0000001208447259_row103484712416"><td class="cellrowborder" valign="top" width="14.82%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001208447259_p1834817711241"><a name="zh-cn_topic_0000001208447259_p1834817711241"></a><a name="zh-cn_topic_0000001208447259_p1834817711241"></a>mode</p> 852 </td> 853 <td class="cellrowborder" valign="top" width="14.729999999999999%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001208447259_p13481762412"><a name="zh-cn_topic_0000001208447259_p13481762412"></a><a name="zh-cn_topic_0000001208447259_p13481762412"></a>number</p> 854 </td> 855 <td class="cellrowborder" valign="top" width="9.16%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001208447259_p83484702415"><a name="zh-cn_topic_0000001208447259_p83484702415"></a><a name="zh-cn_topic_0000001208447259_p83484702415"></a>是</p> 856 </td> 857 <td class="cellrowborder" valign="top" width="61.29%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001144081254_p19508174455411"><a name="zh-cn_topic_0000001144081254_p19508174455411"></a><a name="zh-cn_topic_0000001144081254_p19508174455411"></a>若创建文件，则指定文件的权限，可给定如下权限，以按位或的方式追加权限。</p> 858 <a name="zh-cn_topic_0000001144081254_ul74723715117"></a><a name="zh-cn_topic_0000001144081254_ul74723715117"></a><ul id="zh-cn_topic_0000001144081254_ul74723715117"><li>0o700：所有者具有读、写及可执行权限。</li><li>0o400：所有者具有读权限。</li><li>0o200：所有者具有写权限。</li><li>0o100：所有者具有可执行权限。</li><li>0o070：所有用户组具有读、写及可执行权限。</li><li>0o040：所有用户组具有读权限。</li><li>0o020：所有用户组具有写权限。</li><li>0o010：所有用户组具有可执行权限。</li><li>0o007：其余用户具有读、写及可执行权限。</li><li>0o004：其余用户具有读权限。</li><li>0o002：其余用户具有写权限。</li><li>0o001：其余用户具有可执行权限。</li></ul> 859 </td> 860 </tr> 861 </tbody> 862 </table> 863 864- 示例： 865 866 ``` 867 fileio.fchmodSync(fd, mode); 868 ``` 869 870 871## fileio.truncateSync<sup>7+</sup><a name="zh-cn_topic_0000001208447259_section2759113014567"></a> 872 873truncateSync\(fpath: string, len?: number\): void 874 875以同步方法基于文件路径截断文件。 876 877- 参数： 878 879 <a name="zh-cn_topic_0000001208447259_table20760730115615"></a> 880 <table><thead align="left"><tr id="zh-cn_topic_0000001208447259_row1676023035614"><th class="cellrowborder" valign="top" width="14.82%" id="mcps1.1.5.1.1"><p id="zh-cn_topic_0000001208447259_p16760163085614"><a name="zh-cn_topic_0000001208447259_p16760163085614"></a><a name="zh-cn_topic_0000001208447259_p16760163085614"></a>参数名</p> 881 </th> 882 <th class="cellrowborder" valign="top" width="20.62%" id="mcps1.1.5.1.2"><p id="zh-cn_topic_0000001208447259_p7760530145610"><a name="zh-cn_topic_0000001208447259_p7760530145610"></a><a name="zh-cn_topic_0000001208447259_p7760530145610"></a>类型</p> 883 </th> 884 <th class="cellrowborder" valign="top" width="7.359999999999999%" id="mcps1.1.5.1.3"><p id="zh-cn_topic_0000001208447259_p12761830125613"><a name="zh-cn_topic_0000001208447259_p12761830125613"></a><a name="zh-cn_topic_0000001208447259_p12761830125613"></a>必填</p> 885 </th> 886 <th class="cellrowborder" valign="top" width="57.199999999999996%" id="mcps1.1.5.1.4"><p id="zh-cn_topic_0000001208447259_p976117306565"><a name="zh-cn_topic_0000001208447259_p976117306565"></a><a name="zh-cn_topic_0000001208447259_p976117306565"></a>说明</p> 887 </th> 888 </tr> 889 </thead> 890 <tbody><tr id="zh-cn_topic_0000001208447259_row5761123020566"><td class="cellrowborder" valign="top" width="14.82%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001208447259_p62014513569"><a name="zh-cn_topic_0000001208447259_p62014513569"></a><a name="zh-cn_topic_0000001208447259_p62014513569"></a>path</p> 891 </td> 892 <td class="cellrowborder" valign="top" width="20.62%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001208447259_p1120125175619"><a name="zh-cn_topic_0000001208447259_p1120125175619"></a><a name="zh-cn_topic_0000001208447259_p1120125175619"></a>string</p> 893 </td> 894 <td class="cellrowborder" valign="top" width="7.359999999999999%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001208447259_p17201151145613"><a name="zh-cn_topic_0000001208447259_p17201151145613"></a><a name="zh-cn_topic_0000001208447259_p17201151145613"></a>是</p> 895 </td> 896 <td class="cellrowborder" valign="top" width="57.199999999999996%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001208447259_p1320155155611"><a name="zh-cn_topic_0000001208447259_p1320155155611"></a><a name="zh-cn_topic_0000001208447259_p1320155155611"></a>待截断文件的绝对路径。</p> 897 </td> 898 </tr> 899 <tr id="zh-cn_topic_0000001208447259_row5762153019567"><td class="cellrowborder" valign="top" width="14.82%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001208447259_p1020351135614"><a name="zh-cn_topic_0000001208447259_p1020351135614"></a><a name="zh-cn_topic_0000001208447259_p1020351135614"></a>len</p> 900 </td> 901 <td class="cellrowborder" valign="top" width="20.62%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001208447259_p02075175616"><a name="zh-cn_topic_0000001208447259_p02075175616"></a><a name="zh-cn_topic_0000001208447259_p02075175616"></a>number</p> 902 </td> 903 <td class="cellrowborder" valign="top" width="7.359999999999999%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001208447259_p620115112567"><a name="zh-cn_topic_0000001208447259_p620115112567"></a><a name="zh-cn_topic_0000001208447259_p620115112567"></a>否</p> 904 </td> 905 <td class="cellrowborder" valign="top" width="57.199999999999996%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001208447259_p5924834141415"><a name="zh-cn_topic_0000001208447259_p5924834141415"></a><a name="zh-cn_topic_0000001208447259_p5924834141415"></a>文件截断后的长度，以字节为单位。</p> 906 </td> 907 </tr> 908 </tbody> 909 </table> 910 911 912- 示例： 913 914 ``` 915 fileio.ftruncate(path, len); 916 ``` 917 918 919## fileio.renameSync<sup>7+</sup><a name="zh-cn_topic_0000001208447259_section153395523116"></a> 920 921renameSync\(oldPath: string, newPath: string\): void 922 923以同步方法重命名文件。 924 925- 参数： 926 927 <a name="zh-cn_topic_0000001208447259_table1933195515319"></a> 928 <table><thead align="left"><tr id="zh-cn_topic_0000001208447259_row734105543113"><th class="cellrowborder" valign="top" width="14.82%" id="mcps1.1.5.1.1"><p id="zh-cn_topic_0000001208447259_p534555163120"><a name="zh-cn_topic_0000001208447259_p534555163120"></a><a name="zh-cn_topic_0000001208447259_p534555163120"></a>参数名</p> 929 </th> 930 <th class="cellrowborder" valign="top" width="14.729999999999999%" id="mcps1.1.5.1.2"><p id="zh-cn_topic_0000001208447259_p63419553317"><a name="zh-cn_topic_0000001208447259_p63419553317"></a><a name="zh-cn_topic_0000001208447259_p63419553317"></a>类型</p> 931 </th> 932 <th class="cellrowborder" valign="top" width="9.16%" id="mcps1.1.5.1.3"><p id="zh-cn_topic_0000001208447259_p1134255173110"><a name="zh-cn_topic_0000001208447259_p1134255173110"></a><a name="zh-cn_topic_0000001208447259_p1134255173110"></a>必填</p> 933 </th> 934 <th class="cellrowborder" valign="top" width="61.29%" id="mcps1.1.5.1.4"><p id="zh-cn_topic_0000001208447259_p4342551315"><a name="zh-cn_topic_0000001208447259_p4342551315"></a><a name="zh-cn_topic_0000001208447259_p4342551315"></a>说明</p> 935 </th> 936 </tr> 937 </thead> 938 <tbody><tr id="zh-cn_topic_0000001208447259_row63425513314"><td class="cellrowborder" valign="top" width="14.82%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001208447259_p935105518312"><a name="zh-cn_topic_0000001208447259_p935105518312"></a><a name="zh-cn_topic_0000001208447259_p935105518312"></a>oldPath</p> 939 </td> 940 <td class="cellrowborder" valign="top" width="14.729999999999999%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001208447259_p193535583114"><a name="zh-cn_topic_0000001208447259_p193535583114"></a><a name="zh-cn_topic_0000001208447259_p193535583114"></a>string</p> 941 </td> 942 <td class="cellrowborder" valign="top" width="9.16%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001208447259_p173565513112"><a name="zh-cn_topic_0000001208447259_p173565513112"></a><a name="zh-cn_topic_0000001208447259_p173565513112"></a>是</p> 943 </td> 944 <td class="cellrowborder" valign="top" width="61.29%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001208447259_p168006618555"><a name="zh-cn_topic_0000001208447259_p168006618555"></a><a name="zh-cn_topic_0000001208447259_p168006618555"></a>目标文件的当前绝对路径。</p> 945 </td> 946 </tr> 947 <tr id="zh-cn_topic_0000001208447259_row183525593115"><td class="cellrowborder" valign="top" width="14.82%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001208447259_p1835185583116"><a name="zh-cn_topic_0000001208447259_p1835185583116"></a><a name="zh-cn_topic_0000001208447259_p1835185583116"></a>Newpath</p> 948 </td> 949 <td class="cellrowborder" valign="top" width="14.729999999999999%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001208447259_p63675553116"><a name="zh-cn_topic_0000001208447259_p63675553116"></a><a name="zh-cn_topic_0000001208447259_p63675553116"></a>String</p> 950 </td> 951 <td class="cellrowborder" valign="top" width="9.16%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001208447259_p23616551319"><a name="zh-cn_topic_0000001208447259_p23616551319"></a><a name="zh-cn_topic_0000001208447259_p23616551319"></a>是</p> 952 </td> 953 <td class="cellrowborder" valign="top" width="61.29%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001208447259_p9801362555"><a name="zh-cn_topic_0000001208447259_p9801362555"></a><a name="zh-cn_topic_0000001208447259_p9801362555"></a>目标文件的新绝对路径。</p> 954 </td> 955 </tr> 956 </tbody> 957 </table> 958 959- 示例： 960 961 ``` 962 fileio.rename(oldpath，newpath); 963 ``` 964 965 966## fileio.fsyncSync<sup>7+</sup><a name="zh-cn_topic_0000001208447259_section11863111112544"></a> 967 968fsyncSync\(fd: number\): void 969 970以同步方法同步文件数据。 971 972- 参数： 973 974 <a name="zh-cn_topic_0000001208447259_table159491205546"></a> 975 <table><thead align="left"><tr id="zh-cn_topic_0000001208447259_row1995170195414"><th class="cellrowborder" valign="top" width="14.82%" id="mcps1.1.5.1.1"><p id="zh-cn_topic_0000001208447259_p119529085410"><a name="zh-cn_topic_0000001208447259_p119529085410"></a><a name="zh-cn_topic_0000001208447259_p119529085410"></a>参数名</p> 976 </th> 977 <th class="cellrowborder" valign="top" width="14.729999999999999%" id="mcps1.1.5.1.2"><p id="zh-cn_topic_0000001208447259_p129521607543"><a name="zh-cn_topic_0000001208447259_p129521607543"></a><a name="zh-cn_topic_0000001208447259_p129521607543"></a>类型</p> 978 </th> 979 <th class="cellrowborder" valign="top" width="9.16%" id="mcps1.1.5.1.3"><p id="zh-cn_topic_0000001208447259_p895270195410"><a name="zh-cn_topic_0000001208447259_p895270195410"></a><a name="zh-cn_topic_0000001208447259_p895270195410"></a>必填</p> 980 </th> 981 <th class="cellrowborder" valign="top" width="61.29%" id="mcps1.1.5.1.4"><p id="zh-cn_topic_0000001208447259_p69524012549"><a name="zh-cn_topic_0000001208447259_p69524012549"></a><a name="zh-cn_topic_0000001208447259_p69524012549"></a>说明</p> 982 </th> 983 </tr> 984 </thead> 985 <tbody><tr id="zh-cn_topic_0000001208447259_row129528012540"><td class="cellrowborder" valign="top" width="14.82%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001208447259_p295230155415"><a name="zh-cn_topic_0000001208447259_p295230155415"></a><a name="zh-cn_topic_0000001208447259_p295230155415"></a>fd</p> 986 </td> 987 <td class="cellrowborder" valign="top" width="14.729999999999999%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001208447259_p19953106545"><a name="zh-cn_topic_0000001208447259_p19953106545"></a><a name="zh-cn_topic_0000001208447259_p19953106545"></a>number</p> 988 </td> 989 <td class="cellrowborder" valign="top" width="9.16%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001208447259_p139532010546"><a name="zh-cn_topic_0000001208447259_p139532010546"></a><a name="zh-cn_topic_0000001208447259_p139532010546"></a>是</p> 990 </td> 991 <td class="cellrowborder" valign="top" width="61.29%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001208447259_p79461816143220"><a name="zh-cn_topic_0000001208447259_p79461816143220"></a><a name="zh-cn_topic_0000001208447259_p79461816143220"></a>待同步文件的文件描述符。</p> 992 </td> 993 </tr> 994 </tbody> 995 </table> 996 997- 示例： 998 999 ``` 1000 fileio.fyncsSync)(fd); 1001 ``` 1002 1003 1004## fileio.chownSync<sup>7+</sup><a name="zh-cn_topic_0000001208447259_section1717097183517"></a> 1005 1006chownSync\(path: string, uid: number, gid: number\): void 1007 1008以同步的方法基于文件路径改变文件所有者。 1009 1010- 参数： 1011 1012 <a name="zh-cn_topic_0000001208447259_table1262234217377"></a> 1013 <table><thead align="left"><tr id="zh-cn_topic_0000001208447259_row20773134243715"><th class="cellrowborder" valign="top" width="11.110000000000001%" id="mcps1.1.5.1.1"><p id="zh-cn_topic_0000001208447259_p1677374219379"><a name="zh-cn_topic_0000001208447259_p1677374219379"></a><a name="zh-cn_topic_0000001208447259_p1677374219379"></a>参数名</p> 1014 </th> 1015 <th class="cellrowborder" valign="top" width="11.110000000000001%" id="mcps1.1.5.1.2"><p id="zh-cn_topic_0000001208447259_p18774144214370"><a name="zh-cn_topic_0000001208447259_p18774144214370"></a><a name="zh-cn_topic_0000001208447259_p18774144214370"></a>类型</p> 1016 </th> 1017 <th class="cellrowborder" valign="top" width="7.07%" id="mcps1.1.5.1.3"><p id="zh-cn_topic_0000001208447259_p77741142163719"><a name="zh-cn_topic_0000001208447259_p77741142163719"></a><a name="zh-cn_topic_0000001208447259_p77741142163719"></a>必填</p> 1018 </th> 1019 <th class="cellrowborder" valign="top" width="70.71%" id="mcps1.1.5.1.4"><p id="zh-cn_topic_0000001208447259_p1277418426378"><a name="zh-cn_topic_0000001208447259_p1277418426378"></a><a name="zh-cn_topic_0000001208447259_p1277418426378"></a>说明</p> 1020 </th> 1021 </tr> 1022 </thead> 1023 <tbody><tr id="zh-cn_topic_0000001208447259_row20774742203717"><td class="cellrowborder" valign="top" width="11.110000000000001%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001208447259_p16774124273718"><a name="zh-cn_topic_0000001208447259_p16774124273718"></a><a name="zh-cn_topic_0000001208447259_p16774124273718"></a>path</p> 1024 </td> 1025 <td class="cellrowborder" valign="top" width="11.110000000000001%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001208447259_p67741042183716"><a name="zh-cn_topic_0000001208447259_p67741042183716"></a><a name="zh-cn_topic_0000001208447259_p67741042183716"></a>string</p> 1026 </td> 1027 <td class="cellrowborder" valign="top" width="7.07%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001208447259_p977404214375"><a name="zh-cn_topic_0000001208447259_p977404214375"></a><a name="zh-cn_topic_0000001208447259_p977404214375"></a>是</p> 1028 </td> 1029 <td class="cellrowborder" valign="top" width="70.71%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001208447259_p197811961391"><a name="zh-cn_topic_0000001208447259_p197811961391"></a><a name="zh-cn_topic_0000001208447259_p197811961391"></a>待改变文件的绝对路径。</p> 1030 </td> 1031 </tr> 1032 <tr id="zh-cn_topic_0000001208447259_row16774124283717"><td class="cellrowborder" valign="top" width="11.110000000000001%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001208447259_p077414218379"><a name="zh-cn_topic_0000001208447259_p077414218379"></a><a name="zh-cn_topic_0000001208447259_p077414218379"></a>uid</p> 1033 </td> 1034 <td class="cellrowborder" valign="top" width="11.110000000000001%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001208447259_p13774184214377"><a name="zh-cn_topic_0000001208447259_p13774184214377"></a><a name="zh-cn_topic_0000001208447259_p13774184214377"></a>number</p> 1035 </td> 1036 <td class="cellrowborder" valign="top" width="7.07%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001208447259_p187745428377"><a name="zh-cn_topic_0000001208447259_p187745428377"></a><a name="zh-cn_topic_0000001208447259_p187745428377"></a>是</p> 1037 </td> 1038 <td class="cellrowborder" valign="top" width="70.71%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001208447259_p577524263713"><a name="zh-cn_topic_0000001208447259_p577524263713"></a><a name="zh-cn_topic_0000001208447259_p577524263713"></a>新的UID。</p> 1039 </td> 1040 </tr> 1041 <tr id="zh-cn_topic_0000001208447259_row11775114273711"><td class="cellrowborder" valign="top" width="11.110000000000001%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001208447259_p47751542133715"><a name="zh-cn_topic_0000001208447259_p47751542133715"></a><a name="zh-cn_topic_0000001208447259_p47751542133715"></a>gid</p> 1042 </td> 1043 <td class="cellrowborder" valign="top" width="11.110000000000001%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001208447259_p67751742143712"><a name="zh-cn_topic_0000001208447259_p67751742143712"></a><a name="zh-cn_topic_0000001208447259_p67751742143712"></a>number</p> 1044 </td> 1045 <td class="cellrowborder" valign="top" width="7.07%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001208447259_p19775154263711"><a name="zh-cn_topic_0000001208447259_p19775154263711"></a><a name="zh-cn_topic_0000001208447259_p19775154263711"></a>是</p> 1046 </td> 1047 <td class="cellrowborder" valign="top" width="70.71%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001208447259_p977544219372"><a name="zh-cn_topic_0000001208447259_p977544219372"></a><a name="zh-cn_topic_0000001208447259_p977544219372"></a>新的GID。</p> 1048 </td> 1049 </tr> 1050 </tbody> 1051 </table> 1052 1053- 示例： 1054 1055 ``` 1056 let stat = fileio.statSync(fpath) 1057 fileio.chownSync(path, stat.uid, stat.gid); 1058 ``` 1059 1060 1061## fileio.createStreamSync<sup>7+</sup><a name="zh-cn_topic_0000001208447259_section1956102153713"></a> 1062 1063createStreamSync\(path: string, mode: string\): Stream 1064 1065以同步方法基于文件路径打开文件流。 1066 1067- 参数： 1068 1069 <a name="zh-cn_topic_0000001208447259_table125718213375"></a> 1070 <table><thead align="left"><tr id="zh-cn_topic_0000001208447259_row1857621153710"><th class="cellrowborder" valign="top" width="9.08%" id="mcps1.1.5.1.1"><p id="zh-cn_topic_0000001208447259_p125811212376"><a name="zh-cn_topic_0000001208447259_p125811212376"></a><a name="zh-cn_topic_0000001208447259_p125811212376"></a>参数名</p> 1071 </th> 1072 <th class="cellrowborder" valign="top" width="9.94%" id="mcps1.1.5.1.2"><p id="zh-cn_topic_0000001208447259_p0581121113714"><a name="zh-cn_topic_0000001208447259_p0581121113714"></a><a name="zh-cn_topic_0000001208447259_p0581121113714"></a>类型</p> 1073 </th> 1074 <th class="cellrowborder" valign="top" width="7.01%" id="mcps1.1.5.1.3"><p id="zh-cn_topic_0000001208447259_p115832113375"><a name="zh-cn_topic_0000001208447259_p115832113375"></a><a name="zh-cn_topic_0000001208447259_p115832113375"></a>必填</p> 1075 </th> 1076 <th class="cellrowborder" valign="top" width="73.97%" id="mcps1.1.5.1.4"><p id="zh-cn_topic_0000001208447259_p18589215373"><a name="zh-cn_topic_0000001208447259_p18589215373"></a><a name="zh-cn_topic_0000001208447259_p18589215373"></a>说明</p> 1077 </th> 1078 </tr> 1079 </thead> 1080 <tbody><tr id="zh-cn_topic_0000001208447259_row125815214372"><td class="cellrowborder" valign="top" width="9.08%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001208447259_p1696272519446"><a name="zh-cn_topic_0000001208447259_p1696272519446"></a><a name="zh-cn_topic_0000001208447259_p1696272519446"></a>path</p> 1081 </td> 1082 <td class="cellrowborder" valign="top" width="9.94%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001208447259_p1396202534413"><a name="zh-cn_topic_0000001208447259_p1396202534413"></a><a name="zh-cn_topic_0000001208447259_p1396202534413"></a>string</p> 1083 </td> 1084 <td class="cellrowborder" valign="top" width="7.01%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001208447259_p12962425144415"><a name="zh-cn_topic_0000001208447259_p12962425144415"></a><a name="zh-cn_topic_0000001208447259_p12962425144415"></a>是</p> 1085 </td> 1086 <td class="cellrowborder" valign="top" width="73.97%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001208447259_p179623257441"><a name="zh-cn_topic_0000001208447259_p179623257441"></a><a name="zh-cn_topic_0000001208447259_p179623257441"></a>待打开文件的绝对路径。</p> 1087 </td> 1088 </tr> 1089 <tr id="zh-cn_topic_0000001208447259_row66780382444"><td class="cellrowborder" valign="top" width="9.08%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001208447259_p1534517513466"><a name="zh-cn_topic_0000001208447259_p1534517513466"></a><a name="zh-cn_topic_0000001208447259_p1534517513466"></a>mode</p> 1090 </td> 1091 <td class="cellrowborder" valign="top" width="9.94%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001208447259_p18345115194618"><a name="zh-cn_topic_0000001208447259_p18345115194618"></a><a name="zh-cn_topic_0000001208447259_p18345115194618"></a>string</p> 1092 </td> 1093 <td class="cellrowborder" valign="top" width="7.01%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001208447259_p634505174615"><a name="zh-cn_topic_0000001208447259_p634505174615"></a><a name="zh-cn_topic_0000001208447259_p634505174615"></a>是</p> 1094 </td> 1095 <td class="cellrowborder" valign="top" width="73.97%" headers="mcps1.1.5.1.4 "><a name="zh-cn_topic_0000001208447259_ul141401653154518"></a><a name="zh-cn_topic_0000001208447259_ul141401653154518"></a><ul id="zh-cn_topic_0000001208447259_ul141401653154518"><li>r：打开只读文件，该文件必须存在。</li><li>r+：打开可读写的文件，该文件必须存在。</li><li>w：打开只写文件，若文件存在则文件长度清0，即该文件内容会消失。若文件不存在则建立该文件。</li><li>w+：打开可读写文件，若文件存在则文件长度清0，即该文件内容会消失。若文件不存在则建立该文件。</li><li>a：以附加的方式打开只写文件。若文件不存在，则会建立该文件，如果文件存在，写入的数据会被加到文件尾，即文件原先的内容会被保留。</li><li>a+：以附加方式打开可读写的文件。若文件不存在，则会建立该文件，如果文件存在，写入的数据会被加到文件尾后，即文件原先的内容会被保留。</li></ul> 1096 </td> 1097 </tr> 1098 </tbody> 1099 </table> 1100 1101 1102- 返回值： 1103 1104 <a name="zh-cn_topic_0000001208447259_table82181442114718"></a> 1105 <table><thead align="left"><tr id="zh-cn_topic_0000001208447259_row11377134234713"><th class="cellrowborder" valign="top" width="21.21%" id="mcps1.1.3.1.1"><p id="zh-cn_topic_0000001208447259_p5377144217477"><a name="zh-cn_topic_0000001208447259_p5377144217477"></a><a name="zh-cn_topic_0000001208447259_p5377144217477"></a>参数名</p> 1106 </th> 1107 <th class="cellrowborder" valign="top" width="78.79%" id="mcps1.1.3.1.2"><p id="zh-cn_topic_0000001208447259_p9377134211472"><a name="zh-cn_topic_0000001208447259_p9377134211472"></a><a name="zh-cn_topic_0000001208447259_p9377134211472"></a>说明</p> 1108 </th> 1109 </tr> 1110 </thead> 1111 <tbody><tr id="zh-cn_topic_0000001208447259_row537794234717"><td class="cellrowborder" valign="top" width="21.21%" headers="mcps1.1.3.1.1 "><p id="zh-cn_topic_0000001208447259_p23779423475"><a name="zh-cn_topic_0000001208447259_p23779423475"></a><a name="zh-cn_topic_0000001208447259_p23779423475"></a><a href="#zh-cn_topic_0000001208447259_section109771933162919">Stream</a></p> 1112 </td> 1113 <td class="cellrowborder" valign="top" width="78.79%" headers="mcps1.1.3.1.2 "><p id="zh-cn_topic_0000001208447259_p1349516611613"><a name="zh-cn_topic_0000001208447259_p1349516611613"></a><a name="zh-cn_topic_0000001208447259_p1349516611613"></a>返回文件流的结果。</p> 1114 </td> 1115 </tr> 1116 </tbody> 1117 </table> 1118 1119- 示例： 1120 1121 ``` 1122 let ss = fileio.createStream(path, "r+"); 1123 ``` 1124 1125 1126## fileio.fdopenStreamSync<sup>7+</sup><a name="zh-cn_topic_0000001208447259_section185160523522"></a> 1127 1128fdopenStreamSync\(fd: number, mode: string\): Stream 1129 1130以同步方法基于文件描述符打开文件流。 1131 1132- 参数： 1133 1134 <a name="zh-cn_topic_0000001208447259_table1151765215216"></a> 1135 <table><thead align="left"><tr id="zh-cn_topic_0000001208447259_row55171523524"><th class="cellrowborder" valign="top" width="9.09%" id="mcps1.1.5.1.1"><p id="zh-cn_topic_0000001208447259_p1852145275216"><a name="zh-cn_topic_0000001208447259_p1852145275216"></a><a name="zh-cn_topic_0000001208447259_p1852145275216"></a>参数名</p> 1136 </th> 1137 <th class="cellrowborder" valign="top" width="9.43%" id="mcps1.1.5.1.2"><p id="zh-cn_topic_0000001208447259_p9521175215213"><a name="zh-cn_topic_0000001208447259_p9521175215213"></a><a name="zh-cn_topic_0000001208447259_p9521175215213"></a>类型</p> 1138 </th> 1139 <th class="cellrowborder" valign="top" width="8.84%" id="mcps1.1.5.1.3"><p id="zh-cn_topic_0000001208447259_p1521115212529"><a name="zh-cn_topic_0000001208447259_p1521115212529"></a><a name="zh-cn_topic_0000001208447259_p1521115212529"></a>必填</p> 1140 </th> 1141 <th class="cellrowborder" valign="top" width="72.64%" id="mcps1.1.5.1.4"><p id="zh-cn_topic_0000001208447259_p152119524526"><a name="zh-cn_topic_0000001208447259_p152119524526"></a><a name="zh-cn_topic_0000001208447259_p152119524526"></a>说明</p> 1142 </th> 1143 </tr> 1144 </thead> 1145 <tbody><tr id="zh-cn_topic_0000001208447259_row16522052105215"><td class="cellrowborder" valign="top" width="9.09%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001208447259_p2052265216521"><a name="zh-cn_topic_0000001208447259_p2052265216521"></a><a name="zh-cn_topic_0000001208447259_p2052265216521"></a>fd</p> 1146 </td> 1147 <td class="cellrowborder" valign="top" width="9.43%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001208447259_p15225527528"><a name="zh-cn_topic_0000001208447259_p15225527528"></a><a name="zh-cn_topic_0000001208447259_p15225527528"></a>number</p> 1148 </td> 1149 <td class="cellrowborder" valign="top" width="8.84%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001208447259_p952225219523"><a name="zh-cn_topic_0000001208447259_p952225219523"></a><a name="zh-cn_topic_0000001208447259_p952225219523"></a>是</p> 1150 </td> 1151 <td class="cellrowborder" valign="top" width="72.64%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001208447259_p18953103165913"><a name="zh-cn_topic_0000001208447259_p18953103165913"></a><a name="zh-cn_topic_0000001208447259_p18953103165913"></a>待打开文件的文件描述符。</p> 1152 </td> 1153 </tr> 1154 <tr id="zh-cn_topic_0000001208447259_row115221452175217"><td class="cellrowborder" valign="top" width="9.09%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001208447259_p9523155285212"><a name="zh-cn_topic_0000001208447259_p9523155285212"></a><a name="zh-cn_topic_0000001208447259_p9523155285212"></a>mode</p> 1155 </td> 1156 <td class="cellrowborder" valign="top" width="9.43%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001208447259_p12523752105216"><a name="zh-cn_topic_0000001208447259_p12523752105216"></a><a name="zh-cn_topic_0000001208447259_p12523752105216"></a>string</p> 1157 </td> 1158 <td class="cellrowborder" valign="top" width="8.84%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001208447259_p752315529529"><a name="zh-cn_topic_0000001208447259_p752315529529"></a><a name="zh-cn_topic_0000001208447259_p752315529529"></a>是</p> 1159 </td> 1160 <td class="cellrowborder" valign="top" width="72.64%" headers="mcps1.1.5.1.4 "><a name="zh-cn_topic_0000001208447259_ul141557537457"></a><a name="zh-cn_topic_0000001208447259_ul141557537457"></a><ul id="zh-cn_topic_0000001208447259_ul141557537457"><li>r：打开只读文件，该文件必须存在。</li><li>r+：打开可读写的文件，该文件必须存在。</li><li>w：打开只写文件，若文件存在则文件长度清0，即该文件内容会消失。若文件不存在则建立该文件。</li><li>w+：打开可读写文件，若文件存在则文件长度清0，即该文件内容会消失。若文件不存在则建立该文件。</li><li>a：以附加的方式打开只写文件。若文件不存在，则会建立该文件，如果文件存在，写入的数据会被加到文件尾，即文件原先的内容会被保留。</li><li>a+：以附加方式打开可读写的文件。若文件不存在，则会建立该文件，如果文件存在，写入的数据会被加到文件尾后，即文件原先的内容会被保留。</li></ul> 1161 </td> 1162 </tr> 1163 </tbody> 1164 </table> 1165 1166 1167- 返回值： 1168 1169 <a name="zh-cn_topic_0000001208447259_table9524115217526"></a> 1170 <table><thead align="left"><tr id="zh-cn_topic_0000001208447259_row17525125205211"><th class="cellrowborder" valign="top" width="21.21%" id="mcps1.1.3.1.1"><p id="zh-cn_topic_0000001208447259_p552585219523"><a name="zh-cn_topic_0000001208447259_p552585219523"></a><a name="zh-cn_topic_0000001208447259_p552585219523"></a>参数名</p> 1171 </th> 1172 <th class="cellrowborder" valign="top" width="78.79%" id="mcps1.1.3.1.2"><p id="zh-cn_topic_0000001208447259_p85251152105216"><a name="zh-cn_topic_0000001208447259_p85251152105216"></a><a name="zh-cn_topic_0000001208447259_p85251152105216"></a>说明</p> 1173 </th> 1174 </tr> 1175 </thead> 1176 <tbody><tr id="zh-cn_topic_0000001208447259_row195259523527"><td class="cellrowborder" valign="top" width="21.21%" headers="mcps1.1.3.1.1 "><p id="zh-cn_topic_0000001208447259_p1552618520529"><a name="zh-cn_topic_0000001208447259_p1552618520529"></a><a name="zh-cn_topic_0000001208447259_p1552618520529"></a><a href="#zh-cn_topic_0000001208447259_section109771933162919">Stream</a></p> 1177 </td> 1178 <td class="cellrowborder" valign="top" width="78.79%" headers="mcps1.1.3.1.2 "><p id="zh-cn_topic_0000001208447259_p10526165225216"><a name="zh-cn_topic_0000001208447259_p10526165225216"></a><a name="zh-cn_topic_0000001208447259_p10526165225216"></a>返回文件流的结果。</p> 1179 </td> 1180 </tr> 1181 </tbody> 1182 </table> 1183 1184- 示例： 1185 1186 ``` 1187 let ss = fileio.fdopenStreamSync(fd, "r+"); 1188 ``` 1189 1190 1191## fileio.fchownSync<sup>7+</sup><a name="zh-cn_topic_0000001208447259_section118619326160"></a> 1192 1193fchownSync\(fd: number, uid: number, gid: number\): void 1194 1195以同步方法基于文件描述符改变文件所有者。 1196 1197- 参数： 1198 1199 <a name="zh-cn_topic_0000001208447259_table131861032131617"></a> 1200 <table><thead align="left"><tr id="zh-cn_topic_0000001208447259_row1187143214167"><th class="cellrowborder" valign="top" width="11.110000000000001%" id="mcps1.1.5.1.1"><p id="zh-cn_topic_0000001208447259_p1518763271613"><a name="zh-cn_topic_0000001208447259_p1518763271613"></a><a name="zh-cn_topic_0000001208447259_p1518763271613"></a>参数名</p> 1201 </th> 1202 <th class="cellrowborder" valign="top" width="11.110000000000001%" id="mcps1.1.5.1.2"><p id="zh-cn_topic_0000001208447259_p12187183210161"><a name="zh-cn_topic_0000001208447259_p12187183210161"></a><a name="zh-cn_topic_0000001208447259_p12187183210161"></a>类型</p> 1203 </th> 1204 <th class="cellrowborder" valign="top" width="7.07%" id="mcps1.1.5.1.3"><p id="zh-cn_topic_0000001208447259_p918773211164"><a name="zh-cn_topic_0000001208447259_p918773211164"></a><a name="zh-cn_topic_0000001208447259_p918773211164"></a>必填</p> 1205 </th> 1206 <th class="cellrowborder" valign="top" width="70.71%" id="mcps1.1.5.1.4"><p id="zh-cn_topic_0000001208447259_p718814323161"><a name="zh-cn_topic_0000001208447259_p718814323161"></a><a name="zh-cn_topic_0000001208447259_p718814323161"></a>说明</p> 1207 </th> 1208 </tr> 1209 </thead> 1210 <tbody><tr id="zh-cn_topic_0000001208447259_row12188113213167"><td class="cellrowborder" valign="top" width="11.110000000000001%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001208447259_p218819328165"><a name="zh-cn_topic_0000001208447259_p218819328165"></a><a name="zh-cn_topic_0000001208447259_p218819328165"></a>fd</p> 1211 </td> 1212 <td class="cellrowborder" valign="top" width="11.110000000000001%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001208447259_p1918814327166"><a name="zh-cn_topic_0000001208447259_p1918814327166"></a><a name="zh-cn_topic_0000001208447259_p1918814327166"></a>number</p> 1213 </td> 1214 <td class="cellrowborder" valign="top" width="7.07%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001208447259_p131881732171618"><a name="zh-cn_topic_0000001208447259_p131881732171618"></a><a name="zh-cn_topic_0000001208447259_p131881732171618"></a>是</p> 1215 </td> 1216 <td class="cellrowborder" valign="top" width="70.71%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001208447259_p780313572596"><a name="zh-cn_topic_0000001208447259_p780313572596"></a><a name="zh-cn_topic_0000001208447259_p780313572596"></a>待改变文件的文件描述符。</p> 1217 </td> 1218 </tr> 1219 <tr id="zh-cn_topic_0000001208447259_row1618883221612"><td class="cellrowborder" valign="top" width="11.110000000000001%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001208447259_p10188183218161"><a name="zh-cn_topic_0000001208447259_p10188183218161"></a><a name="zh-cn_topic_0000001208447259_p10188183218161"></a>uid</p> 1220 </td> 1221 <td class="cellrowborder" valign="top" width="11.110000000000001%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001208447259_p1918917326163"><a name="zh-cn_topic_0000001208447259_p1918917326163"></a><a name="zh-cn_topic_0000001208447259_p1918917326163"></a>number</p> 1222 </td> 1223 <td class="cellrowborder" valign="top" width="7.07%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001208447259_p151892321164"><a name="zh-cn_topic_0000001208447259_p151892321164"></a><a name="zh-cn_topic_0000001208447259_p151892321164"></a>是</p> 1224 </td> 1225 <td class="cellrowborder" valign="top" width="70.71%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001208447259_p1418993241611"><a name="zh-cn_topic_0000001208447259_p1418993241611"></a><a name="zh-cn_topic_0000001208447259_p1418993241611"></a>文件所有者的UID。</p> 1226 </td> 1227 </tr> 1228 <tr id="zh-cn_topic_0000001208447259_row5189143201618"><td class="cellrowborder" valign="top" width="11.110000000000001%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001208447259_p618923201615"><a name="zh-cn_topic_0000001208447259_p618923201615"></a><a name="zh-cn_topic_0000001208447259_p618923201615"></a>gid</p> 1229 </td> 1230 <td class="cellrowborder" valign="top" width="11.110000000000001%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001208447259_p41891332131619"><a name="zh-cn_topic_0000001208447259_p41891332131619"></a><a name="zh-cn_topic_0000001208447259_p41891332131619"></a>number</p> 1231 </td> 1232 <td class="cellrowborder" valign="top" width="7.07%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001208447259_p19397151815357"><a name="zh-cn_topic_0000001208447259_p19397151815357"></a><a name="zh-cn_topic_0000001208447259_p19397151815357"></a>是</p> 1233 </td> 1234 <td class="cellrowborder" valign="top" width="70.71%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001208447259_p47382016132620"><a name="zh-cn_topic_0000001208447259_p47382016132620"></a><a name="zh-cn_topic_0000001208447259_p47382016132620"></a>文件所有组的GID。</p> 1235 </td> 1236 </tr> 1237 </tbody> 1238 </table> 1239 1240- 示例： 1241 1242 ``` 1243 let stat = fileio.statSync(fpath); 1244 fileio.fchownSync(fd, stat.uid, stat.gid); 1245 ``` 1246 1247 1248## Stat<a name="zh-cn_topic_0000001208447259_section7315249105116"></a> 1249 1250文件具体信息，在调用Stat的方法前，需要先通过[fileio.statSync](#zh-cn_topic_0000001208447259_section014281412198)来构建一个Stat实例。 1251 1252### 属性<a name="zh-cn_topic_0000001208447259_section23751576140"></a> 1253 1254<a name="zh-cn_topic_0000001208447259_table728861911417"></a> 1255<table><thead align="left"><tr id="zh-cn_topic_0000001208447259_row62887198149"><th class="cellrowborder" valign="top" width="11.66%" id="mcps1.1.6.1.1"><p id="zh-cn_topic_0000001208447259_p928811911410"><a name="zh-cn_topic_0000001208447259_p928811911410"></a><a name="zh-cn_topic_0000001208447259_p928811911410"></a>名称</p> 1256</th> 1257<th class="cellrowborder" valign="top" width="12.030000000000001%" id="mcps1.1.6.1.2"><p id="zh-cn_topic_0000001208447259_p8288191916149"><a name="zh-cn_topic_0000001208447259_p8288191916149"></a><a name="zh-cn_topic_0000001208447259_p8288191916149"></a>参数类型</p> 1258</th> 1259<th class="cellrowborder" valign="top" width="7.359999999999999%" id="mcps1.1.6.1.3"><p id="zh-cn_topic_0000001208447259_p14288131911418"><a name="zh-cn_topic_0000001208447259_p14288131911418"></a><a name="zh-cn_topic_0000001208447259_p14288131911418"></a>可读</p> 1260</th> 1261<th class="cellrowborder" valign="top" width="6.63%" id="mcps1.1.6.1.4"><p id="zh-cn_topic_0000001208447259_p1928861921411"><a name="zh-cn_topic_0000001208447259_p1928861921411"></a><a name="zh-cn_topic_0000001208447259_p1928861921411"></a>可写</p> 1262</th> 1263<th class="cellrowborder" valign="top" width="62.32%" id="mcps1.1.6.1.5"><p id="zh-cn_topic_0000001208447259_p728815191149"><a name="zh-cn_topic_0000001208447259_p728815191149"></a><a name="zh-cn_topic_0000001208447259_p728815191149"></a>说明</p> 1264</th> 1265</tr> 1266</thead> 1267<tbody><tr id="zh-cn_topic_0000001208447259_row528891919142"><td class="cellrowborder" valign="top" width="11.66%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001208447259_p3288191991414"><a name="zh-cn_topic_0000001208447259_p3288191991414"></a><a name="zh-cn_topic_0000001208447259_p3288191991414"></a>dev</p> 1268</td> 1269<td class="cellrowborder" valign="top" width="12.030000000000001%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001208447259_p3288121901418"><a name="zh-cn_topic_0000001208447259_p3288121901418"></a><a name="zh-cn_topic_0000001208447259_p3288121901418"></a>number</p> 1270</td> 1271<td class="cellrowborder" valign="top" width="7.359999999999999%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001208447259_p182881319191414"><a name="zh-cn_topic_0000001208447259_p182881319191414"></a><a name="zh-cn_topic_0000001208447259_p182881319191414"></a>是</p> 1272</td> 1273<td class="cellrowborder" valign="top" width="6.63%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001208447259_p1928801914148"><a name="zh-cn_topic_0000001208447259_p1928801914148"></a><a name="zh-cn_topic_0000001208447259_p1928801914148"></a>否</p> 1274</td> 1275<td class="cellrowborder" valign="top" width="62.32%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001208447259_p1428811192144"><a name="zh-cn_topic_0000001208447259_p1428811192144"></a><a name="zh-cn_topic_0000001208447259_p1428811192144"></a>标识包含该文件的主设备号。</p> 1276</td> 1277</tr> 1278<tr id="zh-cn_topic_0000001208447259_row17111195311346"><td class="cellrowborder" valign="top" width="11.66%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001208447259_p10288419131415"><a name="zh-cn_topic_0000001208447259_p10288419131415"></a><a name="zh-cn_topic_0000001208447259_p10288419131415"></a>ino</p> 1279</td> 1280<td class="cellrowborder" valign="top" width="12.030000000000001%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001208447259_p626711397284"><a name="zh-cn_topic_0000001208447259_p626711397284"></a><a name="zh-cn_topic_0000001208447259_p626711397284"></a>number</p> 1281</td> 1282<td class="cellrowborder" valign="top" width="7.359999999999999%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001208447259_p1726743912812"><a name="zh-cn_topic_0000001208447259_p1726743912812"></a><a name="zh-cn_topic_0000001208447259_p1726743912812"></a>是</p> 1283</td> 1284<td class="cellrowborder" valign="top" width="6.63%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001208447259_p326733942818"><a name="zh-cn_topic_0000001208447259_p326733942818"></a><a name="zh-cn_topic_0000001208447259_p326733942818"></a>否</p> 1285</td> 1286<td class="cellrowborder" valign="top" width="62.32%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001208447259_p1228991915144"><a name="zh-cn_topic_0000001208447259_p1228991915144"></a><a name="zh-cn_topic_0000001208447259_p1228991915144"></a>标识该文件。通常同设备上的不同文件的INO不同。</p> 1287</td> 1288</tr> 1289<tr id="zh-cn_topic_0000001208447259_row1918562340"><td class="cellrowborder" valign="top" width="11.66%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001208447259_p209120568349"><a name="zh-cn_topic_0000001208447259_p209120568349"></a><a name="zh-cn_topic_0000001208447259_p209120568349"></a>mode</p> 1290</td> 1291<td class="cellrowborder" valign="top" width="12.030000000000001%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001208447259_p19794751113514"><a name="zh-cn_topic_0000001208447259_p19794751113514"></a><a name="zh-cn_topic_0000001208447259_p19794751113514"></a>number</p> 1292</td> 1293<td class="cellrowborder" valign="top" width="7.359999999999999%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001208447259_p17122185403519"><a name="zh-cn_topic_0000001208447259_p17122185403519"></a><a name="zh-cn_topic_0000001208447259_p17122185403519"></a>是</p> 1294</td> 1295<td class="cellrowborder" valign="top" width="6.63%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001208447259_p11319595358"><a name="zh-cn_topic_0000001208447259_p11319595358"></a><a name="zh-cn_topic_0000001208447259_p11319595358"></a>否</p> 1296</td> 1297<td class="cellrowborder" valign="top" width="62.32%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001208447259_p49119568343"><a name="zh-cn_topic_0000001208447259_p49119568343"></a><a name="zh-cn_topic_0000001208447259_p49119568343"></a>表示文件类型及权限，其首 4 位表示文件类型，后 12 位表示权限。各特征位的含义如下：</p> 1298<a name="zh-cn_topic_0000001208447259_ul3882122236"></a><a name="zh-cn_topic_0000001208447259_ul3882122236"></a><ul id="zh-cn_topic_0000001208447259_ul3882122236"><li>0o170000：可用于获取文件类型的掩码。</li><li>0o140000：文件是套接字。</li><li>0o120000：文件是符号链接。</li><li>0o100000：文件是一般文件。</li><li>0o060000：文件属于块设备。</li><li>0o040000：文件是目录。</li><li>0o020000：文件是字符设备。</li><li>0o010000：文件是具名管道，即FIFO。</li><li>0o0700：可用于获取用户权限的掩码。</li><li>0o0400：用户读，对于普通文件，所有者可读取文件；对于目录，所有者可读取目录项。</li><li>0o0200：用户写，对于普通文件，所有者可写入文件；对于目录，所有者可创建/删除目录项。</li><li>0o0100：用户执行，对于普通文件，所有者可执行文件；对于目录，所有者可在目录中搜索给定路径名。</li><li>0o0070：可用于获取用户组权限的掩码。</li><li>0o0040：用户组读，对于普通文件，所有用户组可读取文件；对于目录，所有用户组可读取目录项。</li><li>0o0020：用户组写，对于普通文件，所有用户组可写入文件；对于目录，所有用户组可创建/删除目录项。</li><li>0o0010：用户组执行，对于普通文件，所有用户组可执行文件；对于目录，所有用户组是否可在目录中搜索给定路径名。</li><li>0o0007：可用于获取其他用户权限的掩码。</li><li>0o0004：其他读，对于普通文件，其余用户可读取文件；对于目录，其他用户组可读取目录项。</li><li>0o0002：其他写，对于普通文件，其余用户可写入文件；对于目录，其他用户组可创建/删除目录项。</li><li>0o0001：其他执行，对于普通文件，其余用户可执行文件；对于目录，其他用户组可在目录中搜索给定路径名。</li></ul> 1299</td> 1300</tr> 1301<tr id="zh-cn_topic_0000001208447259_row11288719111417"><td class="cellrowborder" valign="top" width="11.66%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001208447259_p179541859193413"><a name="zh-cn_topic_0000001208447259_p179541859193413"></a><a name="zh-cn_topic_0000001208447259_p179541859193413"></a>nlink</p> 1302</td> 1303<td class="cellrowborder" valign="top" width="12.030000000000001%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001208447259_p7812951193514"><a name="zh-cn_topic_0000001208447259_p7812951193514"></a><a name="zh-cn_topic_0000001208447259_p7812951193514"></a>number</p> 1304</td> 1305<td class="cellrowborder" valign="top" width="7.359999999999999%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001208447259_p912275418354"><a name="zh-cn_topic_0000001208447259_p912275418354"></a><a name="zh-cn_topic_0000001208447259_p912275418354"></a>是</p> 1306</td> 1307<td class="cellrowborder" valign="top" width="6.63%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001208447259_p629559143510"><a name="zh-cn_topic_0000001208447259_p629559143510"></a><a name="zh-cn_topic_0000001208447259_p629559143510"></a>否</p> 1308</td> 1309<td class="cellrowborder" valign="top" width="62.32%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001208447259_p89331759153410"><a name="zh-cn_topic_0000001208447259_p89331759153410"></a><a name="zh-cn_topic_0000001208447259_p89331759153410"></a>文件的硬链接数。</p> 1310</td> 1311</tr> 1312<tr id="zh-cn_topic_0000001208447259_row819112311341"><td class="cellrowborder" valign="top" width="11.66%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001208447259_p1319117373415"><a name="zh-cn_topic_0000001208447259_p1319117373415"></a><a name="zh-cn_topic_0000001208447259_p1319117373415"></a>uid</p> 1313</td> 1314<td class="cellrowborder" valign="top" width="12.030000000000001%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001208447259_p178301751203519"><a name="zh-cn_topic_0000001208447259_p178301751203519"></a><a name="zh-cn_topic_0000001208447259_p178301751203519"></a>number</p> 1315</td> 1316<td class="cellrowborder" valign="top" width="7.359999999999999%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001208447259_p1075695613358"><a name="zh-cn_topic_0000001208447259_p1075695613358"></a><a name="zh-cn_topic_0000001208447259_p1075695613358"></a>是</p> 1317</td> 1318<td class="cellrowborder" valign="top" width="6.63%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001208447259_p447125963517"><a name="zh-cn_topic_0000001208447259_p447125963517"></a><a name="zh-cn_topic_0000001208447259_p447125963517"></a>否</p> 1319</td> 1320<td class="cellrowborder" valign="top" width="62.32%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001208447259_p31921839340"><a name="zh-cn_topic_0000001208447259_p31921839340"></a><a name="zh-cn_topic_0000001208447259_p31921839340"></a>文件所有者的ID。</p> 1321</td> 1322</tr> 1323<tr id="zh-cn_topic_0000001208447259_row5209203920349"><td class="cellrowborder" valign="top" width="11.66%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001208447259_p520953913418"><a name="zh-cn_topic_0000001208447259_p520953913418"></a><a name="zh-cn_topic_0000001208447259_p520953913418"></a>gid</p> 1324</td> 1325<td class="cellrowborder" valign="top" width="12.030000000000001%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001208447259_p1983814516358"><a name="zh-cn_topic_0000001208447259_p1983814516358"></a><a name="zh-cn_topic_0000001208447259_p1983814516358"></a>number</p> 1326</td> 1327<td class="cellrowborder" valign="top" width="7.359999999999999%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001208447259_p1376416564354"><a name="zh-cn_topic_0000001208447259_p1376416564354"></a><a name="zh-cn_topic_0000001208447259_p1376416564354"></a>是</p> 1328</td> 1329<td class="cellrowborder" valign="top" width="6.63%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001208447259_p135545943518"><a name="zh-cn_topic_0000001208447259_p135545943518"></a><a name="zh-cn_topic_0000001208447259_p135545943518"></a>否</p> 1330</td> 1331<td class="cellrowborder" valign="top" width="62.32%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001208447259_p820933917349"><a name="zh-cn_topic_0000001208447259_p820933917349"></a><a name="zh-cn_topic_0000001208447259_p820933917349"></a>文件所有组的ID。</p> 1332</td> 1333</tr> 1334<tr id="zh-cn_topic_0000001208447259_row987683412343"><td class="cellrowborder" valign="top" width="11.66%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001208447259_p15877734143414"><a name="zh-cn_topic_0000001208447259_p15877734143414"></a><a name="zh-cn_topic_0000001208447259_p15877734143414"></a>rdev</p> 1335</td> 1336<td class="cellrowborder" valign="top" width="12.030000000000001%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001208447259_p1684585183518"><a name="zh-cn_topic_0000001208447259_p1684585183518"></a><a name="zh-cn_topic_0000001208447259_p1684585183518"></a>number</p> 1337</td> 1338<td class="cellrowborder" valign="top" width="7.359999999999999%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001208447259_p97711556193513"><a name="zh-cn_topic_0000001208447259_p97711556193513"></a><a name="zh-cn_topic_0000001208447259_p97711556193513"></a>是</p> 1339</td> 1340<td class="cellrowborder" valign="top" width="6.63%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001208447259_p196235953510"><a name="zh-cn_topic_0000001208447259_p196235953510"></a><a name="zh-cn_topic_0000001208447259_p196235953510"></a>否</p> 1341</td> 1342<td class="cellrowborder" valign="top" width="62.32%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001208447259_p1287793463415"><a name="zh-cn_topic_0000001208447259_p1287793463415"></a><a name="zh-cn_topic_0000001208447259_p1287793463415"></a>标识包含该文件的从设备号。</p> 1343</td> 1344</tr> 1345<tr id="zh-cn_topic_0000001208447259_row1825315322344"><td class="cellrowborder" valign="top" width="11.66%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001208447259_p92531132163419"><a name="zh-cn_topic_0000001208447259_p92531132163419"></a><a name="zh-cn_topic_0000001208447259_p92531132163419"></a>size</p> 1346</td> 1347<td class="cellrowborder" valign="top" width="12.030000000000001%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001208447259_p485275173512"><a name="zh-cn_topic_0000001208447259_p485275173512"></a><a name="zh-cn_topic_0000001208447259_p485275173512"></a>number</p> 1348</td> 1349<td class="cellrowborder" valign="top" width="7.359999999999999%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001208447259_p177781156183511"><a name="zh-cn_topic_0000001208447259_p177781156183511"></a><a name="zh-cn_topic_0000001208447259_p177781156183511"></a>是</p> 1350</td> 1351<td class="cellrowborder" valign="top" width="6.63%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001208447259_p46995917359"><a name="zh-cn_topic_0000001208447259_p46995917359"></a><a name="zh-cn_topic_0000001208447259_p46995917359"></a>否</p> 1352</td> 1353<td class="cellrowborder" valign="top" width="62.32%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001208447259_p82531332103418"><a name="zh-cn_topic_0000001208447259_p82531332103418"></a><a name="zh-cn_topic_0000001208447259_p82531332103418"></a>文件的大小，以字节为单位。仅对普通文件有效。</p> 1354</td> 1355</tr> 1356<tr id="zh-cn_topic_0000001208447259_row15419937153410"><td class="cellrowborder" valign="top" width="11.66%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001208447259_p2042033717340"><a name="zh-cn_topic_0000001208447259_p2042033717340"></a><a name="zh-cn_topic_0000001208447259_p2042033717340"></a>blocks</p> 1357</td> 1358<td class="cellrowborder" valign="top" width="12.030000000000001%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001208447259_p16860135123512"><a name="zh-cn_topic_0000001208447259_p16860135123512"></a><a name="zh-cn_topic_0000001208447259_p16860135123512"></a>number</p> 1359</td> 1360<td class="cellrowborder" valign="top" width="7.359999999999999%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001208447259_p4785115611354"><a name="zh-cn_topic_0000001208447259_p4785115611354"></a><a name="zh-cn_topic_0000001208447259_p4785115611354"></a>是</p> 1361</td> 1362<td class="cellrowborder" valign="top" width="6.63%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001208447259_p14761599359"><a name="zh-cn_topic_0000001208447259_p14761599359"></a><a name="zh-cn_topic_0000001208447259_p14761599359"></a>否</p> 1363</td> 1364<td class="cellrowborder" valign="top" width="62.32%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001208447259_p134203373346"><a name="zh-cn_topic_0000001208447259_p134203373346"></a><a name="zh-cn_topic_0000001208447259_p134203373346"></a>文件占用的块数，计算时块大小按512B计算。</p> 1365</td> 1366</tr> 1367<tr id="zh-cn_topic_0000001208447259_row757852116342"><td class="cellrowborder" valign="top" width="11.66%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001208447259_p105797211348"><a name="zh-cn_topic_0000001208447259_p105797211348"></a><a name="zh-cn_topic_0000001208447259_p105797211348"></a>atime</p> 1368</td> 1369<td class="cellrowborder" valign="top" width="12.030000000000001%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001208447259_p7867105133518"><a name="zh-cn_topic_0000001208447259_p7867105133518"></a><a name="zh-cn_topic_0000001208447259_p7867105133518"></a>number</p> 1370</td> 1371<td class="cellrowborder" valign="top" width="7.359999999999999%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001208447259_p14792145612357"><a name="zh-cn_topic_0000001208447259_p14792145612357"></a><a name="zh-cn_topic_0000001208447259_p14792145612357"></a>是</p> 1372</td> 1373<td class="cellrowborder" valign="top" width="6.63%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001208447259_p18445903518"><a name="zh-cn_topic_0000001208447259_p18445903518"></a><a name="zh-cn_topic_0000001208447259_p18445903518"></a>否</p> 1374</td> 1375<td class="cellrowborder" valign="top" width="62.32%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001208447259_p7579202117348"><a name="zh-cn_topic_0000001208447259_p7579202117348"></a><a name="zh-cn_topic_0000001208447259_p7579202117348"></a>上次访问该文件的时间，表示距1970年1月1日0时0分0秒的秒数。</p> 1376</td> 1377</tr> 1378<tr id="zh-cn_topic_0000001208447259_row7331132814341"><td class="cellrowborder" valign="top" width="11.66%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001208447259_p23311828143417"><a name="zh-cn_topic_0000001208447259_p23311828143417"></a><a name="zh-cn_topic_0000001208447259_p23311828143417"></a>mtime</p> 1379</td> 1380<td class="cellrowborder" valign="top" width="12.030000000000001%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001208447259_p188741518359"><a name="zh-cn_topic_0000001208447259_p188741518359"></a><a name="zh-cn_topic_0000001208447259_p188741518359"></a>number</p> 1381</td> 1382<td class="cellrowborder" valign="top" width="7.359999999999999%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001208447259_p2799115633517"><a name="zh-cn_topic_0000001208447259_p2799115633517"></a><a name="zh-cn_topic_0000001208447259_p2799115633517"></a>是</p> 1383</td> 1384<td class="cellrowborder" valign="top" width="6.63%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001208447259_p14911659103510"><a name="zh-cn_topic_0000001208447259_p14911659103510"></a><a name="zh-cn_topic_0000001208447259_p14911659103510"></a>否</p> 1385</td> 1386<td class="cellrowborder" valign="top" width="62.32%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001208447259_p16332122819345"><a name="zh-cn_topic_0000001208447259_p16332122819345"></a><a name="zh-cn_topic_0000001208447259_p16332122819345"></a>上次修改该文件的时间，表示距1970年1月1日0时0分0秒的秒数。</p> 1387</td> 1388</tr> 1389<tr id="zh-cn_topic_0000001208447259_row1047914304341"><td class="cellrowborder" valign="top" width="11.66%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001208447259_p947913020342"><a name="zh-cn_topic_0000001208447259_p947913020342"></a><a name="zh-cn_topic_0000001208447259_p947913020342"></a>ctime</p> 1390</td> 1391<td class="cellrowborder" valign="top" width="12.030000000000001%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001208447259_p4881155110359"><a name="zh-cn_topic_0000001208447259_p4881155110359"></a><a name="zh-cn_topic_0000001208447259_p4881155110359"></a>number</p> 1392</td> 1393<td class="cellrowborder" valign="top" width="7.359999999999999%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001208447259_p88061956113520"><a name="zh-cn_topic_0000001208447259_p88061956113520"></a><a name="zh-cn_topic_0000001208447259_p88061956113520"></a>是</p> 1394</td> 1395<td class="cellrowborder" valign="top" width="6.63%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001208447259_p109845983513"><a name="zh-cn_topic_0000001208447259_p109845983513"></a><a name="zh-cn_topic_0000001208447259_p109845983513"></a>否</p> 1396</td> 1397<td class="cellrowborder" valign="top" width="62.32%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001208447259_p347915303344"><a name="zh-cn_topic_0000001208447259_p347915303344"></a><a name="zh-cn_topic_0000001208447259_p347915303344"></a>最近改变文件状态的时间，表示距1970年1月1日0时0分0秒的秒数。</p> 1398</td> 1399</tr> 1400</tbody> 1401</table> 1402 1403### isBlockDevice<a name="zh-cn_topic_0000001208447259_section1041074182716"></a> 1404 1405isBlockDevice\(\): boolean 1406 1407用于判断当前目录项是否是块特殊文件。一个块特殊文件只能以块为粒度进行访问，且访问的时候带缓存。 1408 1409- 返回值： 1410 1411 <a name="zh-cn_topic_0000001208447259_table1241064122713"></a> 1412 <table><thead align="left"><tr id="zh-cn_topic_0000001208447259_row5410174202717"><th class="cellrowborder" valign="top" width="17.01%" id="mcps1.1.3.1.1"><p id="zh-cn_topic_0000001208447259_p14101249279"><a name="zh-cn_topic_0000001208447259_p14101249279"></a><a name="zh-cn_topic_0000001208447259_p14101249279"></a>类型</p> 1413 </th> 1414 <th class="cellrowborder" valign="top" width="82.99%" id="mcps1.1.3.1.2"><p id="zh-cn_topic_0000001208447259_p104104410278"><a name="zh-cn_topic_0000001208447259_p104104410278"></a><a name="zh-cn_topic_0000001208447259_p104104410278"></a>说明</p> 1415 </th> 1416 </tr> 1417 </thead> 1418 <tbody><tr id="zh-cn_topic_0000001208447259_row164101142272"><td class="cellrowborder" valign="top" width="17.01%" headers="mcps1.1.3.1.1 "><p id="zh-cn_topic_0000001208447259_p14410347278"><a name="zh-cn_topic_0000001208447259_p14410347278"></a><a name="zh-cn_topic_0000001208447259_p14410347278"></a>boolean</p> 1419 </td> 1420 <td class="cellrowborder" valign="top" width="82.99%" headers="mcps1.1.3.1.2 "><p id="zh-cn_topic_0000001208447259_p3410947271"><a name="zh-cn_topic_0000001208447259_p3410947271"></a><a name="zh-cn_topic_0000001208447259_p3410947271"></a>表示当前目录项是否是块特殊设备。</p> 1421 </td> 1422 </tr> 1423 </tbody> 1424 </table> 1425 1426- 示例： 1427 1428 ``` 1429 let isBLockDevice = fileio.statSync(path).isBlockDevice(); 1430 ``` 1431 1432 1433### isCharacterDevice<a name="zh-cn_topic_0000001208447259_section154111646277"></a> 1434 1435isCharacterDevice\(\): boolean 1436 1437用于判断当前目录项是否是字符特殊文件。一个字符特殊设备可进行随机访问，且访问的时候不带缓存。 1438 1439- 返回值： 1440 1441 <a name="zh-cn_topic_0000001208447259_table184113412717"></a> 1442 <table><thead align="left"><tr id="zh-cn_topic_0000001208447259_row94111942272"><th class="cellrowborder" valign="top" width="17.01%" id="mcps1.1.3.1.1"><p id="zh-cn_topic_0000001208447259_p3411194132713"><a name="zh-cn_topic_0000001208447259_p3411194132713"></a><a name="zh-cn_topic_0000001208447259_p3411194132713"></a>类型</p> 1443 </th> 1444 <th class="cellrowborder" valign="top" width="82.99%" id="mcps1.1.3.1.2"><p id="zh-cn_topic_0000001208447259_p04116472711"><a name="zh-cn_topic_0000001208447259_p04116472711"></a><a name="zh-cn_topic_0000001208447259_p04116472711"></a>说明</p> 1445 </th> 1446 </tr> 1447 </thead> 1448 <tbody><tr id="zh-cn_topic_0000001208447259_row194111544271"><td class="cellrowborder" valign="top" width="17.01%" headers="mcps1.1.3.1.1 "><p id="zh-cn_topic_0000001208447259_p04111245272"><a name="zh-cn_topic_0000001208447259_p04111245272"></a><a name="zh-cn_topic_0000001208447259_p04111245272"></a>boolean</p> 1449 </td> 1450 <td class="cellrowborder" valign="top" width="82.99%" headers="mcps1.1.3.1.2 "><p id="zh-cn_topic_0000001208447259_p041104132717"><a name="zh-cn_topic_0000001208447259_p041104132717"></a><a name="zh-cn_topic_0000001208447259_p041104132717"></a>表示当前目录项是否是字符特殊设备。</p> 1451 </td> 1452 </tr> 1453 </tbody> 1454 </table> 1455 1456- 示例： 1457 1458 ``` 1459 let isCharacterDevice = fileio.statSync(path).isCharacterDevice(); 1460 ``` 1461 1462 1463### isDirectory<a name="zh-cn_topic_0000001208447259_section2041115418271"></a> 1464 1465isDirectory\(\): boolean 1466 1467用于判断当前目录项是否是目录。 1468 1469- 返回值： 1470 1471 <a name="zh-cn_topic_0000001208447259_table841113472714"></a> 1472 <table><thead align="left"><tr id="zh-cn_topic_0000001208447259_row14114412719"><th class="cellrowborder" valign="top" width="17.01%" id="mcps1.1.3.1.1"><p id="zh-cn_topic_0000001208447259_p641194102713"><a name="zh-cn_topic_0000001208447259_p641194102713"></a><a name="zh-cn_topic_0000001208447259_p641194102713"></a>类型</p> 1473 </th> 1474 <th class="cellrowborder" valign="top" width="82.99%" id="mcps1.1.3.1.2"><p id="zh-cn_topic_0000001208447259_p104111847275"><a name="zh-cn_topic_0000001208447259_p104111847275"></a><a name="zh-cn_topic_0000001208447259_p104111847275"></a>说明</p> 1475 </th> 1476 </tr> 1477 </thead> 1478 <tbody><tr id="zh-cn_topic_0000001208447259_row5411164192714"><td class="cellrowborder" valign="top" width="17.01%" headers="mcps1.1.3.1.1 "><p id="zh-cn_topic_0000001208447259_p24114412720"><a name="zh-cn_topic_0000001208447259_p24114412720"></a><a name="zh-cn_topic_0000001208447259_p24114412720"></a>boolean</p> 1479 </td> 1480 <td class="cellrowborder" valign="top" width="82.99%" headers="mcps1.1.3.1.2 "><p id="zh-cn_topic_0000001208447259_p11412134132718"><a name="zh-cn_topic_0000001208447259_p11412134132718"></a><a name="zh-cn_topic_0000001208447259_p11412134132718"></a>表示当前目录项是否是目录。</p> 1481 </td> 1482 </tr> 1483 </tbody> 1484 </table> 1485 1486- 示例： 1487 1488 ``` 1489 let isDirectory= fileio.statSync(path).isDirectory(); 1490 ``` 1491 1492 1493### isFIFO<a name="zh-cn_topic_0000001208447259_section1941244122719"></a> 1494 1495isFIFO\(\): boolean 1496 1497用于判断当前目录项是否是命名管道（有时也称为FIFO）。命名管道通常用于进程间通信。 1498 1499- 返回值： 1500 1501 <a name="zh-cn_topic_0000001208447259_table11412845271"></a> 1502 <table><thead align="left"><tr id="zh-cn_topic_0000001208447259_row1641220416272"><th class="cellrowborder" valign="top" width="17.01%" id="mcps1.1.3.1.1"><p id="zh-cn_topic_0000001208447259_p1641210415279"><a name="zh-cn_topic_0000001208447259_p1641210415279"></a><a name="zh-cn_topic_0000001208447259_p1641210415279"></a>类型</p> 1503 </th> 1504 <th class="cellrowborder" valign="top" width="82.99%" id="mcps1.1.3.1.2"><p id="zh-cn_topic_0000001208447259_p3412548273"><a name="zh-cn_topic_0000001208447259_p3412548273"></a><a name="zh-cn_topic_0000001208447259_p3412548273"></a>说明</p> 1505 </th> 1506 </tr> 1507 </thead> 1508 <tbody><tr id="zh-cn_topic_0000001208447259_row441224142717"><td class="cellrowborder" valign="top" width="17.01%" headers="mcps1.1.3.1.1 "><p id="zh-cn_topic_0000001208447259_p741218402714"><a name="zh-cn_topic_0000001208447259_p741218402714"></a><a name="zh-cn_topic_0000001208447259_p741218402714"></a>boolean</p> 1509 </td> 1510 <td class="cellrowborder" valign="top" width="82.99%" headers="mcps1.1.3.1.2 "><p id="zh-cn_topic_0000001208447259_p154121840272"><a name="zh-cn_topic_0000001208447259_p154121840272"></a><a name="zh-cn_topic_0000001208447259_p154121840272"></a>表示当前目录项是否是 FIFO。</p> 1511 </td> 1512 </tr> 1513 </tbody> 1514 </table> 1515 1516- 示例： 1517 1518 ``` 1519 let isFIFO= fileio.statSync(path).isFIFO(); 1520 ``` 1521 1522 1523### isFile<a name="zh-cn_topic_0000001208447259_section341284192710"></a> 1524 1525isFile\(\): boolean 1526 1527用于判断当前目录项是否是普通文件。 1528 1529- 返回值： 1530 1531 <a name="zh-cn_topic_0000001208447259_table10412124152720"></a> 1532 <table><thead align="left"><tr id="zh-cn_topic_0000001208447259_row34124412272"><th class="cellrowborder" valign="top" width="17.01%" id="mcps1.1.3.1.1"><p id="zh-cn_topic_0000001208447259_p20412144152718"><a name="zh-cn_topic_0000001208447259_p20412144152718"></a><a name="zh-cn_topic_0000001208447259_p20412144152718"></a>类型</p> 1533 </th> 1534 <th class="cellrowborder" valign="top" width="82.99%" id="mcps1.1.3.1.2"><p id="zh-cn_topic_0000001208447259_p1941374112718"><a name="zh-cn_topic_0000001208447259_p1941374112718"></a><a name="zh-cn_topic_0000001208447259_p1941374112718"></a>说明</p> 1535 </th> 1536 </tr> 1537 </thead> 1538 <tbody><tr id="zh-cn_topic_0000001208447259_row2041384102711"><td class="cellrowborder" valign="top" width="17.01%" headers="mcps1.1.3.1.1 "><p id="zh-cn_topic_0000001208447259_p184131045270"><a name="zh-cn_topic_0000001208447259_p184131045270"></a><a name="zh-cn_topic_0000001208447259_p184131045270"></a>boolean</p> 1539 </td> 1540 <td class="cellrowborder" valign="top" width="82.99%" headers="mcps1.1.3.1.2 "><p id="zh-cn_topic_0000001208447259_p1241316412277"><a name="zh-cn_topic_0000001208447259_p1241316412277"></a><a name="zh-cn_topic_0000001208447259_p1241316412277"></a>表示当前目录项是否是普通文件。</p> 1541 </td> 1542 </tr> 1543 </tbody> 1544 </table> 1545 1546- 示例： 1547 1548 ``` 1549 let isFile= fileio.statSync(fpath).isFile(); 1550 ``` 1551 1552 1553### isSocket<a name="zh-cn_topic_0000001208447259_section154131413278"></a> 1554 1555isSocket\(\): boolean 1556 1557用于判断当前目录项是否是套接字。 1558 1559- 返回值： 1560 1561 <a name="zh-cn_topic_0000001208447259_table144131842271"></a> 1562 <table><thead align="left"><tr id="zh-cn_topic_0000001208447259_row1841304192716"><th class="cellrowborder" valign="top" width="17.01%" id="mcps1.1.3.1.1"><p id="zh-cn_topic_0000001208447259_p154133422714"><a name="zh-cn_topic_0000001208447259_p154133422714"></a><a name="zh-cn_topic_0000001208447259_p154133422714"></a>类型</p> 1563 </th> 1564 <th class="cellrowborder" valign="top" width="82.99%" id="mcps1.1.3.1.2"><p id="zh-cn_topic_0000001208447259_p12413144275"><a name="zh-cn_topic_0000001208447259_p12413144275"></a><a name="zh-cn_topic_0000001208447259_p12413144275"></a>说明</p> 1565 </th> 1566 </tr> 1567 </thead> 1568 <tbody><tr id="zh-cn_topic_0000001208447259_row441310418272"><td class="cellrowborder" valign="top" width="17.01%" headers="mcps1.1.3.1.1 "><p id="zh-cn_topic_0000001208447259_p141319432718"><a name="zh-cn_topic_0000001208447259_p141319432718"></a><a name="zh-cn_topic_0000001208447259_p141319432718"></a>boolean</p> 1569 </td> 1570 <td class="cellrowborder" valign="top" width="82.99%" headers="mcps1.1.3.1.2 "><p id="zh-cn_topic_0000001208447259_p1541319482714"><a name="zh-cn_topic_0000001208447259_p1541319482714"></a><a name="zh-cn_topic_0000001208447259_p1541319482714"></a>表示当前目录项是否是套接字。</p> 1571 </td> 1572 </tr> 1573 </tbody> 1574 </table> 1575 1576- 示例： 1577 1578 ``` 1579 let isSocket = fileio.statSync(path).isSocket(); 1580 ``` 1581 1582 1583### isSymbolicLink<a name="zh-cn_topic_0000001208447259_section241317413274"></a> 1584 1585isSymbolicLink\(\): boolean 1586 1587用于判断当前目录项是否是符号链接。 1588 1589- 返回值： 1590 1591 <a name="zh-cn_topic_0000001208447259_table13413114122717"></a> 1592 <table><thead align="left"><tr id="zh-cn_topic_0000001208447259_row14147472718"><th class="cellrowborder" valign="top" width="17.01%" id="mcps1.1.3.1.1"><p id="zh-cn_topic_0000001208447259_p14143472712"><a name="zh-cn_topic_0000001208447259_p14143472712"></a><a name="zh-cn_topic_0000001208447259_p14143472712"></a>类型</p> 1593 </th> 1594 <th class="cellrowborder" valign="top" width="82.99%" id="mcps1.1.3.1.2"><p id="zh-cn_topic_0000001208447259_p1241417442710"><a name="zh-cn_topic_0000001208447259_p1241417442710"></a><a name="zh-cn_topic_0000001208447259_p1241417442710"></a>说明</p> 1595 </th> 1596 </tr> 1597 </thead> 1598 <tbody><tr id="zh-cn_topic_0000001208447259_row134146472715"><td class="cellrowborder" valign="top" width="17.01%" headers="mcps1.1.3.1.1 "><p id="zh-cn_topic_0000001208447259_p64144418275"><a name="zh-cn_topic_0000001208447259_p64144418275"></a><a name="zh-cn_topic_0000001208447259_p64144418275"></a>boolean</p> 1599 </td> 1600 <td class="cellrowborder" valign="top" width="82.99%" headers="mcps1.1.3.1.2 "><p id="zh-cn_topic_0000001208447259_p24142419279"><a name="zh-cn_topic_0000001208447259_p24142419279"></a><a name="zh-cn_topic_0000001208447259_p24142419279"></a>表示当前目录项是否是符号链接。</p> 1601 </td> 1602 </tr> 1603 </tbody> 1604 </table> 1605 1606- 示例： 1607 1608 ``` 1609 let isSymbolicLink = fileio.statSync(path).isSymbolicLink(); 1610 ``` 1611 1612 1613## Stream<sup>7+</sup><a name="zh-cn_topic_0000001208447259_section109771933162919"></a> 1614 1615文件流，在调用Stream的方法前，需要先通过[fileio.createStreamSync](#zh-cn_topic_0000001208447259_section1956102153713)方法来构建一个Stream实例。 1616 1617### closeSync<sup>7+</sup><a name="zh-cn_topic_0000001208447259_section45453128524"></a> 1618 1619closeSync\(\): void 1620 1621同步关闭文件流。 1622 1623- 示例： 1624 1625 ``` 1626 let ss= fileio.createStreamSync(path); 1627 ss.closeSync(); 1628 ``` 1629 1630 1631### flushSync<sup>7+</sup><a name="zh-cn_topic_0000001208447259_section55111014181917"></a> 1632 1633flushSync\(\): void 1634 1635同步刷新文件流。 1636 1637- 示例： 1638 1639 ``` 1640 let ss= fileio.createStreamSync(path); 1641 ss.flushSync(); 1642 ``` 1643 1644 1645### writeSync<sup>7+</sup><a name="zh-cn_topic_0000001208447259_section1959319151511"></a> 1646 1647writeSync\(buffer: ArrayBuffer | string, options?:Object\): number 1648 1649以同步方法将数据写入流文件。 1650 1651- 参数： 1652 1653 <a name="zh-cn_topic_0000001208447259_table25121946162517"></a> 1654 <table><thead align="left"><tr id="zh-cn_topic_0000001208447259_row1651474618253"><th class="cellrowborder" valign="top" width="14.82%" id="mcps1.1.5.1.1"><p id="zh-cn_topic_0000001208447259_p1514124642518"><a name="zh-cn_topic_0000001208447259_p1514124642518"></a><a name="zh-cn_topic_0000001208447259_p1514124642518"></a>参数名</p> 1655 </th> 1656 <th class="cellrowborder" valign="top" width="20.62%" id="mcps1.1.5.1.2"><p id="zh-cn_topic_0000001208447259_p1251494613252"><a name="zh-cn_topic_0000001208447259_p1251494613252"></a><a name="zh-cn_topic_0000001208447259_p1251494613252"></a>类型</p> 1657 </th> 1658 <th class="cellrowborder" valign="top" width="7.359999999999999%" id="mcps1.1.5.1.3"><p id="zh-cn_topic_0000001208447259_p1151434632511"><a name="zh-cn_topic_0000001208447259_p1151434632511"></a><a name="zh-cn_topic_0000001208447259_p1151434632511"></a>必填</p> 1659 </th> 1660 <th class="cellrowborder" valign="top" width="57.199999999999996%" id="mcps1.1.5.1.4"><p id="zh-cn_topic_0000001208447259_p18515124622520"><a name="zh-cn_topic_0000001208447259_p18515124622520"></a><a name="zh-cn_topic_0000001208447259_p18515124622520"></a>说明</p> 1661 </th> 1662 </tr> 1663 </thead> 1664 <tbody><tr id="zh-cn_topic_0000001208447259_row19516124618251"><td class="cellrowborder" valign="top" width="14.82%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001208447259_p135161346172518"><a name="zh-cn_topic_0000001208447259_p135161346172518"></a><a name="zh-cn_topic_0000001208447259_p135161346172518"></a>buffer</p> 1665 </td> 1666 <td class="cellrowborder" valign="top" width="20.62%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001208447259_p10516164619254"><a name="zh-cn_topic_0000001208447259_p10516164619254"></a><a name="zh-cn_topic_0000001208447259_p10516164619254"></a>ArrayBuffer | string</p> 1667 </td> 1668 <td class="cellrowborder" valign="top" width="7.359999999999999%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001208447259_p1551710465250"><a name="zh-cn_topic_0000001208447259_p1551710465250"></a><a name="zh-cn_topic_0000001208447259_p1551710465250"></a>是</p> 1669 </td> 1670 <td class="cellrowborder" valign="top" width="57.199999999999996%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001208447259_p1551710467254"><a name="zh-cn_topic_0000001208447259_p1551710467254"></a><a name="zh-cn_topic_0000001208447259_p1551710467254"></a>待写入文件的数据，可来自缓冲区或字符串。</p> 1671 </td> 1672 </tr> 1673 <tr id="zh-cn_topic_0000001208447259_row551754611254"><td class="cellrowborder" valign="top" width="14.82%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001208447259_p75171846182515"><a name="zh-cn_topic_0000001208447259_p75171846182515"></a><a name="zh-cn_topic_0000001208447259_p75171846182515"></a>options</p> 1674 </td> 1675 <td class="cellrowborder" valign="top" width="20.62%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001208447259_p2051844618257"><a name="zh-cn_topic_0000001208447259_p2051844618257"></a><a name="zh-cn_topic_0000001208447259_p2051844618257"></a>Object</p> 1676 </td> 1677 <td class="cellrowborder" valign="top" width="7.359999999999999%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001208447259_p15518124612513"><a name="zh-cn_topic_0000001208447259_p15518124612513"></a><a name="zh-cn_topic_0000001208447259_p15518124612513"></a>否</p> 1678 </td> 1679 <td class="cellrowborder" valign="top" width="57.199999999999996%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001208447259_p0518114652511"><a name="zh-cn_topic_0000001208447259_p0518114652511"></a><a name="zh-cn_topic_0000001208447259_p0518114652511"></a>支持如下选项：</p> 1680 <a name="zh-cn_topic_0000001208447259_ul6518134616252"></a><a name="zh-cn_topic_0000001208447259_ul6518134616252"></a><ul id="zh-cn_topic_0000001208447259_ul6518134616252"><li>offset，number类型，表示期望写入数据的位置相对于数据首地址的偏移。可选，默认为0。</li><li>length，number类型，表示期望写入数据的长度。可选，默认缓冲区长度减去偏移长度。</li><li>position，number类型，表示期望写入文件的位置。可选，默认从当前位置开始写。</li><li>encoding，string类型，当数据是 string 类型时有效，表示数据的编码方式，默认 'utf-8'，仅支持 'utf-8'。</li></ul> 1681 </td> 1682 </tr> 1683 </tbody> 1684 </table> 1685 1686- 返回值： 1687 1688 <a name="zh-cn_topic_0000001208447259_table10520446162513"></a> 1689 <table><thead align="left"><tr id="zh-cn_topic_0000001208447259_row652084611250"><th class="cellrowborder" valign="top" width="17.01%" id="mcps1.1.3.1.1"><p id="zh-cn_topic_0000001208447259_p125211946122520"><a name="zh-cn_topic_0000001208447259_p125211946122520"></a><a name="zh-cn_topic_0000001208447259_p125211946122520"></a>类型</p> 1690 </th> 1691 <th class="cellrowborder" valign="top" width="82.99%" id="mcps1.1.3.1.2"><p id="zh-cn_topic_0000001208447259_p6521146152512"><a name="zh-cn_topic_0000001208447259_p6521146152512"></a><a name="zh-cn_topic_0000001208447259_p6521146152512"></a>说明</p> 1692 </th> 1693 </tr> 1694 </thead> 1695 <tbody><tr id="zh-cn_topic_0000001208447259_row2522174652520"><td class="cellrowborder" valign="top" width="17.01%" headers="mcps1.1.3.1.1 "><p id="zh-cn_topic_0000001208447259_p1522114617255"><a name="zh-cn_topic_0000001208447259_p1522114617255"></a><a name="zh-cn_topic_0000001208447259_p1522114617255"></a>number</p> 1696 </td> 1697 <td class="cellrowborder" valign="top" width="82.99%" headers="mcps1.1.3.1.2 "><p id="zh-cn_topic_0000001208447259_p152234632520"><a name="zh-cn_topic_0000001208447259_p152234632520"></a><a name="zh-cn_topic_0000001208447259_p152234632520"></a>实际写入的长度。</p> 1698 </td> 1699 </tr> 1700 </tbody> 1701 </table> 1702 1703- 示例： 1704 1705 ``` 1706 let ss= fileio.createStreamSync(fpath,"r+"); 1707 ss.writeSync("hello, world",{offset: 1,length: 5,position: 5,encoding :'utf-8'}); 1708 ``` 1709 1710 1711### readSync<sup>7+</sup><a name="zh-cn_topic_0000001208447259_section547517381167"></a> 1712 1713readSync\(buffer: ArrayBuffer, options?: Object\): number 1714 1715以同步方法从流文件读取数据。 1716 1717- 参数： 1718 1719 <a name="zh-cn_topic_0000001208447259_table834818156483"></a> 1720 <table><thead align="left"><tr id="zh-cn_topic_0000001208447259_row73491515164815"><th class="cellrowborder" valign="top" width="14.82%" id="mcps1.1.5.1.1"><p id="zh-cn_topic_0000001208447259_p334911584819"><a name="zh-cn_topic_0000001208447259_p334911584819"></a><a name="zh-cn_topic_0000001208447259_p334911584819"></a>参数名</p> 1721 </th> 1722 <th class="cellrowborder" valign="top" width="14.729999999999999%" id="mcps1.1.5.1.2"><p id="zh-cn_topic_0000001208447259_p12349141518486"><a name="zh-cn_topic_0000001208447259_p12349141518486"></a><a name="zh-cn_topic_0000001208447259_p12349141518486"></a>类型</p> 1723 </th> 1724 <th class="cellrowborder" valign="top" width="9.16%" id="mcps1.1.5.1.3"><p id="zh-cn_topic_0000001208447259_p143501153489"><a name="zh-cn_topic_0000001208447259_p143501153489"></a><a name="zh-cn_topic_0000001208447259_p143501153489"></a>必填</p> 1725 </th> 1726 <th class="cellrowborder" valign="top" width="61.29%" id="mcps1.1.5.1.4"><p id="zh-cn_topic_0000001208447259_p7350151519489"><a name="zh-cn_topic_0000001208447259_p7350151519489"></a><a name="zh-cn_topic_0000001208447259_p7350151519489"></a>说明</p> 1727 </th> 1728 </tr> 1729 </thead> 1730 <tbody><tr id="zh-cn_topic_0000001208447259_row16351191514489"><td class="cellrowborder" valign="top" width="14.82%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001208447259_p53511515154811"><a name="zh-cn_topic_0000001208447259_p53511515154811"></a><a name="zh-cn_topic_0000001208447259_p53511515154811"></a>buffer</p> 1731 </td> 1732 <td class="cellrowborder" valign="top" width="14.729999999999999%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001208447259_p193515154487"><a name="zh-cn_topic_0000001208447259_p193515154487"></a><a name="zh-cn_topic_0000001208447259_p193515154487"></a>ArrayBuffer</p> 1733 </td> 1734 <td class="cellrowborder" valign="top" width="9.16%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001208447259_p3351715114812"><a name="zh-cn_topic_0000001208447259_p3351715114812"></a><a name="zh-cn_topic_0000001208447259_p3351715114812"></a>是</p> 1735 </td> 1736 <td class="cellrowborder" valign="top" width="61.29%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001208447259_p1035220156485"><a name="zh-cn_topic_0000001208447259_p1035220156485"></a><a name="zh-cn_topic_0000001208447259_p1035220156485"></a>用于读取文件的缓冲区。</p> 1737 </td> 1738 </tr> 1739 <tr id="zh-cn_topic_0000001208447259_row143521315134810"><td class="cellrowborder" valign="top" width="14.82%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001208447259_p635212150484"><a name="zh-cn_topic_0000001208447259_p635212150484"></a><a name="zh-cn_topic_0000001208447259_p635212150484"></a>options</p> 1740 </td> 1741 <td class="cellrowborder" valign="top" width="14.729999999999999%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001208447259_p19352131524811"><a name="zh-cn_topic_0000001208447259_p19352131524811"></a><a name="zh-cn_topic_0000001208447259_p19352131524811"></a>Object</p> 1742 </td> 1743 <td class="cellrowborder" valign="top" width="9.16%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001208447259_p3353201520481"><a name="zh-cn_topic_0000001208447259_p3353201520481"></a><a name="zh-cn_topic_0000001208447259_p3353201520481"></a>否</p> 1744 </td> 1745 <td class="cellrowborder" valign="top" width="61.29%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001208447259_p1935319155480"><a name="zh-cn_topic_0000001208447259_p1935319155480"></a><a name="zh-cn_topic_0000001208447259_p1935319155480"></a>支持如下选项：</p> 1746 <a name="zh-cn_topic_0000001208447259_ul135351513487"></a><a name="zh-cn_topic_0000001208447259_ul135351513487"></a><ul id="zh-cn_topic_0000001208447259_ul135351513487"><li>offset，number 类型，表示将数据读取到缓冲区的位置，即相对于缓冲区首地址的偏移。可选，默认为0。</li><li>length，number 类型，表示期望读取数据的长度。可选，默认缓冲区长度减去偏移长度。</li><li>position，number 类型，表示期望读取文件的位置。可选，默认从当前位置开始读。</li></ul> 1747 </td> 1748 </tr> 1749 </tbody> 1750 </table> 1751 1752- 返回值： 1753 1754 <a name="zh-cn_topic_0000001208447259_table5354151584811"></a> 1755 <table><thead align="left"><tr id="zh-cn_topic_0000001208447259_row18355161514482"><th class="cellrowborder" valign="top" width="17.01%" id="mcps1.1.3.1.1"><p id="zh-cn_topic_0000001208447259_p1355111514810"><a name="zh-cn_topic_0000001208447259_p1355111514810"></a><a name="zh-cn_topic_0000001208447259_p1355111514810"></a>类型</p> 1756 </th> 1757 <th class="cellrowborder" valign="top" width="82.99%" id="mcps1.1.3.1.2"><p id="zh-cn_topic_0000001208447259_p16355515194816"><a name="zh-cn_topic_0000001208447259_p16355515194816"></a><a name="zh-cn_topic_0000001208447259_p16355515194816"></a>说明</p> 1758 </th> 1759 </tr> 1760 </thead> 1761 <tbody><tr id="zh-cn_topic_0000001208447259_row83551515164815"><td class="cellrowborder" valign="top" width="17.01%" headers="mcps1.1.3.1.1 "><p id="zh-cn_topic_0000001208447259_p1235651511484"><a name="zh-cn_topic_0000001208447259_p1235651511484"></a><a name="zh-cn_topic_0000001208447259_p1235651511484"></a>number</p> 1762 </td> 1763 <td class="cellrowborder" valign="top" width="82.99%" headers="mcps1.1.3.1.2 "><p id="zh-cn_topic_0000001208447259_p835651513487"><a name="zh-cn_topic_0000001208447259_p835651513487"></a><a name="zh-cn_topic_0000001208447259_p835651513487"></a>实际读取的长度。</p> 1764 </td> 1765 </tr> 1766 </tbody> 1767 </table> 1768 1769- 示例： 1770 1771 ``` 1772 let ss = fileio.createStreamSync(fpath, "r+"); 1773 ss.readSync(new ArrayBuffer(4096),{offset: 1,length: FILE_CONTENT.length,position: 5}); 1774 ``` 1775 1776 1777## Dir<a name="zh-cn_topic_0000001208447259_section189341937163212"></a> 1778 1779管理目录，在调用Dir的方法前，需要先通过[fileio.opendirSync](#zh-cn_topic_0000001208447259_section7741145112216)方法来构建一个Dir实例。 1780 1781### readSync<a name="zh-cn_topic_0000001208447259_section10198204912710"></a> 1782 1783readSync\(\): Dirent 1784 1785同步读取下一个目录项。 1786 1787- 返回值： 1788 1789 <a name="zh-cn_topic_0000001208447259_table91985491870"></a> 1790 <table><thead align="left"><tr id="zh-cn_topic_0000001208447259_row131981491775"><th class="cellrowborder" valign="top" width="17.01%" id="mcps1.1.3.1.1"><p id="zh-cn_topic_0000001208447259_p181983491370"><a name="zh-cn_topic_0000001208447259_p181983491370"></a><a name="zh-cn_topic_0000001208447259_p181983491370"></a>类型</p> 1791 </th> 1792 <th class="cellrowborder" valign="top" width="82.99%" id="mcps1.1.3.1.2"><p id="zh-cn_topic_0000001208447259_p10198114918711"><a name="zh-cn_topic_0000001208447259_p10198114918711"></a><a name="zh-cn_topic_0000001208447259_p10198114918711"></a>说明</p> 1793 </th> 1794 </tr> 1795 </thead> 1796 <tbody><tr id="zh-cn_topic_0000001208447259_row121981049275"><td class="cellrowborder" valign="top" width="17.01%" headers="mcps1.1.3.1.1 "><p id="zh-cn_topic_0000001208447259_p1519812491376"><a name="zh-cn_topic_0000001208447259_p1519812491376"></a><a name="zh-cn_topic_0000001208447259_p1519812491376"></a><a href="#zh-cn_topic_0000001208447259_section92331215118">Dirent</a></p> 1797 </td> 1798 <td class="cellrowborder" valign="top" width="82.99%" headers="mcps1.1.3.1.2 "><p id="zh-cn_topic_0000001208447259_p1919818491075"><a name="zh-cn_topic_0000001208447259_p1919818491075"></a><a name="zh-cn_topic_0000001208447259_p1919818491075"></a>表示一个目录项。</p> 1799 </td> 1800 </tr> 1801 </tbody> 1802 </table> 1803 1804- 示例： 1805 1806 ``` 1807 let dir = fileio.opendirSync(dpath); 1808 let dirent = dir.readSync(); 1809 console.log(dirent.name); 1810 ``` 1811 1812 1813### closeSync<a name="zh-cn_topic_0000001208447259_section1140053017119"></a> 1814 1815closeSync\(\): void 1816 1817用于关闭目录。目录被关闭后，Dir中持有的文件描述将被释放，后续将无法从Dir中读取目录项。 1818 1819- 示例： 1820 1821 ``` 1822 let dir = fileio.opendirSync(dpath); 1823 dir.closeSync(); 1824 ``` 1825 1826 1827## Dirent<a name="zh-cn_topic_0000001208447259_section92331215118"></a> 1828 1829在调用Dirent的方法前，需要先通过[readSync](#zh-cn_topic_0000001208447259_section10198204912710)方法来构建一个Dirent实例。 1830 1831### 属性<a name="zh-cn_topic_0000001208447259_section152315121617"></a> 1832 1833<a name="zh-cn_topic_0000001208447259_table15231112515"></a> 1834<table><thead align="left"><tr id="zh-cn_topic_0000001208447259_row4232012216"><th class="cellrowborder" valign="top" width="15.870000000000001%" id="mcps1.1.6.1.1"><p id="zh-cn_topic_0000001208447259_p5237121715"><a name="zh-cn_topic_0000001208447259_p5237121715"></a><a name="zh-cn_topic_0000001208447259_p5237121715"></a>名称</p> 1835</th> 1836<th class="cellrowborder" valign="top" width="10.86%" id="mcps1.1.6.1.2"><p id="zh-cn_topic_0000001208447259_p12313127119"><a name="zh-cn_topic_0000001208447259_p12313127119"></a><a name="zh-cn_topic_0000001208447259_p12313127119"></a>参数类型</p> 1837</th> 1838<th class="cellrowborder" valign="top" width="9.34%" id="mcps1.1.6.1.3"><p id="zh-cn_topic_0000001208447259_p192381217113"><a name="zh-cn_topic_0000001208447259_p192381217113"></a><a name="zh-cn_topic_0000001208447259_p192381217113"></a>可读</p> 1839</th> 1840<th class="cellrowborder" valign="top" width="11.51%" id="mcps1.1.6.1.4"><p id="zh-cn_topic_0000001208447259_p122320120117"><a name="zh-cn_topic_0000001208447259_p122320120117"></a><a name="zh-cn_topic_0000001208447259_p122320120117"></a>可写</p> 1841</th> 1842<th class="cellrowborder" valign="top" width="52.42%" id="mcps1.1.6.1.5"><p id="zh-cn_topic_0000001208447259_p62310121212"><a name="zh-cn_topic_0000001208447259_p62310121212"></a><a name="zh-cn_topic_0000001208447259_p62310121212"></a>说明</p> 1843</th> 1844</tr> 1845</thead> 1846<tbody><tr id="zh-cn_topic_0000001208447259_row122317124115"><td class="cellrowborder" valign="top" width="15.870000000000001%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001208447259_p323612718"><a name="zh-cn_topic_0000001208447259_p323612718"></a><a name="zh-cn_topic_0000001208447259_p323612718"></a>name</p> 1847</td> 1848<td class="cellrowborder" valign="top" width="10.86%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001208447259_p152314121810"><a name="zh-cn_topic_0000001208447259_p152314121810"></a><a name="zh-cn_topic_0000001208447259_p152314121810"></a>string</p> 1849</td> 1850<td class="cellrowborder" valign="top" width="9.34%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001208447259_p1243123110"><a name="zh-cn_topic_0000001208447259_p1243123110"></a><a name="zh-cn_topic_0000001208447259_p1243123110"></a>是</p> 1851</td> 1852<td class="cellrowborder" valign="top" width="11.51%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001208447259_p02410125111"><a name="zh-cn_topic_0000001208447259_p02410125111"></a><a name="zh-cn_topic_0000001208447259_p02410125111"></a>否</p> 1853</td> 1854<td class="cellrowborder" valign="top" width="52.42%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001208447259_p924212212"><a name="zh-cn_topic_0000001208447259_p924212212"></a><a name="zh-cn_topic_0000001208447259_p924212212"></a>目录项的名称。</p> 1855</td> 1856</tr> 1857</tbody> 1858</table> 1859 1860### isBlockDevice<a name="zh-cn_topic_0000001208447259_section121576105554"></a> 1861 1862isBlockDevice\(\): boolean 1863 1864用于判断当前目录项是否是块特殊文件。一个块特殊文件只能以块为粒度进行访问，且访问的时候带缓存。 1865 1866- 返回值： 1867 1868 <a name="zh-cn_topic_0000001208447259_table1215761019558"></a> 1869 <table><thead align="left"><tr id="zh-cn_topic_0000001208447259_row515717101557"><th class="cellrowborder" valign="top" width="17.01%" id="mcps1.1.3.1.1"><p id="zh-cn_topic_0000001208447259_p111571110175511"><a name="zh-cn_topic_0000001208447259_p111571110175511"></a><a name="zh-cn_topic_0000001208447259_p111571110175511"></a>类型</p> 1870 </th> 1871 <th class="cellrowborder" valign="top" width="82.99%" id="mcps1.1.3.1.2"><p id="zh-cn_topic_0000001208447259_p17157110185519"><a name="zh-cn_topic_0000001208447259_p17157110185519"></a><a name="zh-cn_topic_0000001208447259_p17157110185519"></a>说明</p> 1872 </th> 1873 </tr> 1874 </thead> 1875 <tbody><tr id="zh-cn_topic_0000001208447259_row715701065518"><td class="cellrowborder" valign="top" width="17.01%" headers="mcps1.1.3.1.1 "><p id="zh-cn_topic_0000001208447259_p1115761035510"><a name="zh-cn_topic_0000001208447259_p1115761035510"></a><a name="zh-cn_topic_0000001208447259_p1115761035510"></a>boolean</p> 1876 </td> 1877 <td class="cellrowborder" valign="top" width="82.99%" headers="mcps1.1.3.1.2 "><p id="zh-cn_topic_0000001208447259_p17157131020556"><a name="zh-cn_topic_0000001208447259_p17157131020556"></a><a name="zh-cn_topic_0000001208447259_p17157131020556"></a>表示当前目录项是否是块特殊设备。</p> 1878 </td> 1879 </tr> 1880 </tbody> 1881 </table> 1882 1883- 示例： 1884 1885 ``` 1886 let dir = fileio.opendirSync(dpath); 1887 let isBLockDevice = dir.readSync().isBlockDevice(); 1888 ``` 1889 1890 1891### isCharacterDevice<a name="zh-cn_topic_0000001208447259_section20158121011550"></a> 1892 1893isCharacterDevice\(\): boolean 1894 1895用于判断当前目录项是否是字符特殊设备。一个字符特殊设备可进行随机访问，且访问的时候不带缓存。 1896 1897- 返回值： 1898 1899 <a name="zh-cn_topic_0000001208447259_table315818109559"></a> 1900 <table><thead align="left"><tr id="zh-cn_topic_0000001208447259_row71588108555"><th class="cellrowborder" valign="top" width="17.01%" id="mcps1.1.3.1.1"><p id="zh-cn_topic_0000001208447259_p1415812103558"><a name="zh-cn_topic_0000001208447259_p1415812103558"></a><a name="zh-cn_topic_0000001208447259_p1415812103558"></a>类型</p> 1901 </th> 1902 <th class="cellrowborder" valign="top" width="82.99%" id="mcps1.1.3.1.2"><p id="zh-cn_topic_0000001208447259_p7158151085510"><a name="zh-cn_topic_0000001208447259_p7158151085510"></a><a name="zh-cn_topic_0000001208447259_p7158151085510"></a>说明</p> 1903 </th> 1904 </tr> 1905 </thead> 1906 <tbody><tr id="zh-cn_topic_0000001208447259_row715812103557"><td class="cellrowborder" valign="top" width="17.01%" headers="mcps1.1.3.1.1 "><p id="zh-cn_topic_0000001208447259_p915871035513"><a name="zh-cn_topic_0000001208447259_p915871035513"></a><a name="zh-cn_topic_0000001208447259_p915871035513"></a>boolean</p> 1907 </td> 1908 <td class="cellrowborder" valign="top" width="82.99%" headers="mcps1.1.3.1.2 "><p id="zh-cn_topic_0000001208447259_p1415815107557"><a name="zh-cn_topic_0000001208447259_p1415815107557"></a><a name="zh-cn_topic_0000001208447259_p1415815107557"></a>表示当前目录项是否是字符特殊设备。</p> 1909 </td> 1910 </tr> 1911 </tbody> 1912 </table> 1913 1914- 示例： 1915 1916 ``` 1917 let dir = fileio.opendirSync(dpath); 1918 let isCharacterDevice = dir.readSync().isCharacterDevice(); 1919 ``` 1920 1921 1922### isDirectory<a name="zh-cn_topic_0000001208447259_section181581010165520"></a> 1923 1924isDirectory\(\): boolean 1925 1926用于判断当前目录项是否是目录。 1927 1928- 返回值： 1929 1930 <a name="zh-cn_topic_0000001208447259_table51580109551"></a> 1931 <table><thead align="left"><tr id="zh-cn_topic_0000001208447259_row121581910155511"><th class="cellrowborder" valign="top" width="17.01%" id="mcps1.1.3.1.1"><p id="zh-cn_topic_0000001208447259_p1615821065511"><a name="zh-cn_topic_0000001208447259_p1615821065511"></a><a name="zh-cn_topic_0000001208447259_p1615821065511"></a>类型</p> 1932 </th> 1933 <th class="cellrowborder" valign="top" width="82.99%" id="mcps1.1.3.1.2"><p id="zh-cn_topic_0000001208447259_p111581104550"><a name="zh-cn_topic_0000001208447259_p111581104550"></a><a name="zh-cn_topic_0000001208447259_p111581104550"></a>说明</p> 1934 </th> 1935 </tr> 1936 </thead> 1937 <tbody><tr id="zh-cn_topic_0000001208447259_row1515851014554"><td class="cellrowborder" valign="top" width="17.01%" headers="mcps1.1.3.1.1 "><p id="zh-cn_topic_0000001208447259_p15158121011553"><a name="zh-cn_topic_0000001208447259_p15158121011553"></a><a name="zh-cn_topic_0000001208447259_p15158121011553"></a>boolean</p> 1938 </td> 1939 <td class="cellrowborder" valign="top" width="82.99%" headers="mcps1.1.3.1.2 "><p id="zh-cn_topic_0000001208447259_p0158151019551"><a name="zh-cn_topic_0000001208447259_p0158151019551"></a><a name="zh-cn_topic_0000001208447259_p0158151019551"></a>表示当前目录项是否是目录。</p> 1940 </td> 1941 </tr> 1942 </tbody> 1943 </table> 1944 1945- 示例： 1946 1947 ``` 1948 let dir = fileio.opendirSync(dpath); 1949 let isDirectory = dir.readSync().isDirectory(); 1950 ``` 1951 1952 1953### isFIFO<a name="zh-cn_topic_0000001208447259_section615811095517"></a> 1954 1955isFIFO\(\): boolean 1956 1957用于判断当前目录项是否是命名管道（有时也称为FIFO）。命名管道通常用于进程间通信。 1958 1959- 返回值： 1960 1961 <a name="zh-cn_topic_0000001208447259_table1015911017551"></a> 1962 <table><thead align="left"><tr id="zh-cn_topic_0000001208447259_row19159610125512"><th class="cellrowborder" valign="top" width="17.01%" id="mcps1.1.3.1.1"><p id="zh-cn_topic_0000001208447259_p2159810135510"><a name="zh-cn_topic_0000001208447259_p2159810135510"></a><a name="zh-cn_topic_0000001208447259_p2159810135510"></a>类型</p> 1963 </th> 1964 <th class="cellrowborder" valign="top" width="82.99%" id="mcps1.1.3.1.2"><p id="zh-cn_topic_0000001208447259_p1315951055512"><a name="zh-cn_topic_0000001208447259_p1315951055512"></a><a name="zh-cn_topic_0000001208447259_p1315951055512"></a>说明</p> 1965 </th> 1966 </tr> 1967 </thead> 1968 <tbody><tr id="zh-cn_topic_0000001208447259_row1159151085517"><td class="cellrowborder" valign="top" width="17.01%" headers="mcps1.1.3.1.1 "><p id="zh-cn_topic_0000001208447259_p15159201018555"><a name="zh-cn_topic_0000001208447259_p15159201018555"></a><a name="zh-cn_topic_0000001208447259_p15159201018555"></a>boolean</p> 1969 </td> 1970 <td class="cellrowborder" valign="top" width="82.99%" headers="mcps1.1.3.1.2 "><p id="zh-cn_topic_0000001208447259_p1715912105558"><a name="zh-cn_topic_0000001208447259_p1715912105558"></a><a name="zh-cn_topic_0000001208447259_p1715912105558"></a>表示当前目录项是否是FIFO。</p> 1971 </td> 1972 </tr> 1973 </tbody> 1974 </table> 1975 1976- 示例： 1977 1978 ``` 1979 let dir = fileio.opendirSync(dpath); 1980 let isFIFO = dir.readSync().isFIFO(); 1981 ``` 1982 1983 1984### isFile<a name="zh-cn_topic_0000001208447259_section91591310195520"></a> 1985 1986isFile\(\): boolean 1987 1988用于判断当前目录项是否是普通文件。 1989 1990- 返回值： 1991 1992 <a name="zh-cn_topic_0000001208447259_table10159710185513"></a> 1993 <table><thead align="left"><tr id="zh-cn_topic_0000001208447259_row13159210195517"><th class="cellrowborder" valign="top" width="17.01%" id="mcps1.1.3.1.1"><p id="zh-cn_topic_0000001208447259_p31595100554"><a name="zh-cn_topic_0000001208447259_p31595100554"></a><a name="zh-cn_topic_0000001208447259_p31595100554"></a>类型</p> 1994 </th> 1995 <th class="cellrowborder" valign="top" width="82.99%" id="mcps1.1.3.1.2"><p id="zh-cn_topic_0000001208447259_p115919106551"><a name="zh-cn_topic_0000001208447259_p115919106551"></a><a name="zh-cn_topic_0000001208447259_p115919106551"></a>说明</p> 1996 </th> 1997 </tr> 1998 </thead> 1999 <tbody><tr id="zh-cn_topic_0000001208447259_row715916105550"><td class="cellrowborder" valign="top" width="17.01%" headers="mcps1.1.3.1.1 "><p id="zh-cn_topic_0000001208447259_p141591310105518"><a name="zh-cn_topic_0000001208447259_p141591310105518"></a><a name="zh-cn_topic_0000001208447259_p141591310105518"></a>boolean</p> 2000 </td> 2001 <td class="cellrowborder" valign="top" width="82.99%" headers="mcps1.1.3.1.2 "><p id="zh-cn_topic_0000001208447259_p1016041011559"><a name="zh-cn_topic_0000001208447259_p1016041011559"></a><a name="zh-cn_topic_0000001208447259_p1016041011559"></a>表示当前目录项是否是普通文件。</p> 2002 </td> 2003 </tr> 2004 </tbody> 2005 </table> 2006 2007- 示例： 2008 2009 ``` 2010 let dir = fileio.opendirSync(dpath); 2011 let isFile = dir.readSync().isFile(); 2012 ``` 2013 2014 2015### isSocket<a name="zh-cn_topic_0000001208447259_section216031020555"></a> 2016 2017isSocket\(\): boolean 2018 2019用于判断当前目录项是否是套接字。 2020 2021- 返回值： 2022 2023 <a name="zh-cn_topic_0000001208447259_table7160131085517"></a> 2024 <table><thead align="left"><tr id="zh-cn_topic_0000001208447259_row6160101045511"><th class="cellrowborder" valign="top" width="17.01%" id="mcps1.1.3.1.1"><p id="zh-cn_topic_0000001208447259_p716015109555"><a name="zh-cn_topic_0000001208447259_p716015109555"></a><a name="zh-cn_topic_0000001208447259_p716015109555"></a>类型</p> 2025 </th> 2026 <th class="cellrowborder" valign="top" width="82.99%" id="mcps1.1.3.1.2"><p id="zh-cn_topic_0000001208447259_p1316041075518"><a name="zh-cn_topic_0000001208447259_p1316041075518"></a><a name="zh-cn_topic_0000001208447259_p1316041075518"></a>说明</p> 2027 </th> 2028 </tr> 2029 </thead> 2030 <tbody><tr id="zh-cn_topic_0000001208447259_row2016071005519"><td class="cellrowborder" valign="top" width="17.01%" headers="mcps1.1.3.1.1 "><p id="zh-cn_topic_0000001208447259_p131601210115514"><a name="zh-cn_topic_0000001208447259_p131601210115514"></a><a name="zh-cn_topic_0000001208447259_p131601210115514"></a>boolean</p> 2031 </td> 2032 <td class="cellrowborder" valign="top" width="82.99%" headers="mcps1.1.3.1.2 "><p id="zh-cn_topic_0000001208447259_p6160191085520"><a name="zh-cn_topic_0000001208447259_p6160191085520"></a><a name="zh-cn_topic_0000001208447259_p6160191085520"></a>表示当前目录项是否是套接字。</p> 2033 </td> 2034 </tr> 2035 </tbody> 2036 </table> 2037 2038- 示例： 2039 2040 ``` 2041 let dir = fileio.opendirSync(dpath); 2042 let isSocket = dir.readSync().isSocket(); 2043 ``` 2044 2045 2046### isSymbolicLink<a name="zh-cn_topic_0000001208447259_section1216010104553"></a> 2047 2048isSymbolicLink\(\): boolean 2049 2050用于判断当前目录项是否是符号链接。 2051 2052- 返回值： 2053 2054 <a name="zh-cn_topic_0000001208447259_table61602105554"></a> 2055 <table><thead align="left"><tr id="zh-cn_topic_0000001208447259_row191601510125517"><th class="cellrowborder" valign="top" width="17.01%" id="mcps1.1.3.1.1"><p id="zh-cn_topic_0000001208447259_p121601510175510"><a name="zh-cn_topic_0000001208447259_p121601510175510"></a><a name="zh-cn_topic_0000001208447259_p121601510175510"></a>类型</p> 2056 </th> 2057 <th class="cellrowborder" valign="top" width="82.99%" id="mcps1.1.3.1.2"><p id="zh-cn_topic_0000001208447259_p01611410175518"><a name="zh-cn_topic_0000001208447259_p01611410175518"></a><a name="zh-cn_topic_0000001208447259_p01611410175518"></a>说明</p> 2058 </th> 2059 </tr> 2060 </thead> 2061 <tbody><tr id="zh-cn_topic_0000001208447259_row716116106551"><td class="cellrowborder" valign="top" width="17.01%" headers="mcps1.1.3.1.1 "><p id="zh-cn_topic_0000001208447259_p216171020556"><a name="zh-cn_topic_0000001208447259_p216171020556"></a><a name="zh-cn_topic_0000001208447259_p216171020556"></a>boolean</p> 2062 </td> 2063 <td class="cellrowborder" valign="top" width="82.99%" headers="mcps1.1.3.1.2 "><p id="zh-cn_topic_0000001208447259_p131614106554"><a name="zh-cn_topic_0000001208447259_p131614106554"></a><a name="zh-cn_topic_0000001208447259_p131614106554"></a>表示当前目录项是否是符号链接。</p> 2064 </td> 2065 </tr> 2066 </tbody> 2067 </table> 2068 2069- 示例： 2070 2071 ``` 2072 let dir = fileio.opendirSync(dpath); 2073 let isSymbolicLink = dir.readSync().isSymbolicLink(); 2074 ``` 2075 2076 2077
