Files
hustoj/web/cppreference-zh/chmhelp/cpp-io-c-fopen.html
2025-08-01 12:57:54 +08:00

188 lines
13 KiB
HTML

<!DOCTYPE html>
<html lang="zh" dir="ltr" class="client-nojs" xmlns="http://www.w3.org/1999/xhtml" xml:lang="zh">
<head><meta http-equiv="x-ua-compatible" content="ie=edge">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>std::fopen</title>
<link rel="stylesheet" href="ext.css" />
<link rel="stylesheet" href="site_modules.css" />
</head>
<body class="mediawiki ltr sitedir-ltr ns-0 ns-subject page-cpp_io_c_fopen skin-cppreference2 action-view cpp-navbar">
<div id="cpp-content-base">
<div id="content"><a id="top"></a>
<h1 id="firstHeading" class="firstHeading"><span style="font-size:0.7em; line-height:130%">std::</span>fopen</h1>
<div id="bodyContent">
<div id="contentSub"><span class="subpages">&lt; <a href="cpp.html">cpp</a>&lrm; | <a href="cpp-io.html">io</a>&lrm; | <a href="cpp-io-c.html">c</a></span></div>
<div id="mw-content-text" lang="zh" dir="ltr" class="mw-content-ltr" xml:lang="zh">
<table class="t-dcl-begin">
<tbody>
<tr class="t-dsc-header">
<td>
<div>&#23450;&#20041;&#20110;&#22836;&#25991;&#20214; <code><a href="cpp-header-cstdio.html">&lt;cstdio&gt;</a></code></div>
</td>
<td></td>
<td></td>
</tr>
<tr class="t-dcl">
<td class="t-dcl-nopad">
<div><span class="mw-geshi cpp source-cpp"><a href="cpp-io-c.html"><span class="kw1876">std::<span class="me2">FILE</span></span></a><span class="sy2">*</span> fopen<span class="br0">(</span> <span class="kw4">const</span> <span class="kw4">char</span><span class="sy2">*</span> filename, <span class="kw4">const</span> <span class="kw4">char</span><span class="sy2">*</span> mode <span class="br0">)</span><span class="sy4">;</span></span></div>
</td>
<td class="t-dcl-nopad"></td>
<td class="t-dcl-nopad"></td>
</tr>
<tr class="t-dcl-sep">
<td></td>
<td></td>
<td></td>
</tr>
</tbody>
</table>
<p>&#25171;&#24320; <code>filename</code> &#25152;&#25351;&#31034;&#30340;&#25991;&#20214;&#24182;&#36820;&#22238;&#19982;&#35813;&#25991;&#20214;&#20851;&#32852;&#30340;&#27969;&#12290;&#29992; <code>mode</code> &#30830;&#23450;&#25991;&#20214;&#35775;&#38382;&#27169;&#24335;&#12290;</p>
<h3><span class="mw-headline" id=".E5.8F.82.E6.95.B0">&#21442;&#25968;</span></h3>
<table class="t-par-begin">
<tr class="t-par">
<td>filename</td>
<td>-</td>
<td>&#35201;&#20851;&#32852;&#25991;&#20214;&#27969;&#21040;&#30340;&#25991;&#20214;&#21517;</td>
</tr>
<tr class="t-par">
<td>mode</td>
<td>-</td>
<td>&#30830;&#23450;&#25991;&#20214;&#35775;&#38382;&#27169;&#24335;&#30340;&#31354;&#32456;&#27490;&#23383;&#31526;&#20018;
<table class="wikitable">
<tr>
<th>&#25991;&#20214;&#35775;&#38382;&#27169;&#24335;&#23383;&#31526;&#20018;</th>
<th>&#21547;&#20041;</th>
<th>&#35299;&#37322;</th>
<th>&#33509;&#25991;&#20214;&#24050;&#23384;&#22312;&#30340;&#34892;&#21160;</th>
<th>&#33509;&#25991;&#20214;&#19981;&#23384;&#22312;&#30340;&#34892;&#21160;</th>
</tr>
<tr>
<td><code>&quot;r&quot;</code></td>
<td>&#35835;</td>
<td>&#20026;&#35835;&#21462;&#25171;&#24320;&#25991;&#20214;</td>
<td>&#20174;&#36215;&#22987;&#35835;&#21462;</td>
<td>&#25171;&#24320;&#22833;&#36133;</td>
</tr>
<tr>
<td><code>&quot;w&quot;</code></td>
<td>&#20889;</td>
<td>&#20026;&#20889;&#20837;&#21019;&#24314;&#25991;&#20214;</td>
<td>&#38144;&#27585;&#20869;&#23481;</td>
<td>&#21019;&#24314;&#26032;&#25991;&#20214;</td>
</tr>
<tr>
<td><code>&quot;a&quot;</code></td>
<td>&#36861;&#21152;</td>
<td>&#36861;&#21152;&#21040;&#25991;&#20214;</td>
<td>&#20889;&#20837;&#21040;&#26411;&#23614;</td>
<td>&#21019;&#24314;&#26032;&#25991;&#20214;</td>
</tr>
<tr>
<td><code>&quot;r+&quot;</code></td>
<td>&#25193;&#23637;&#35835;</td>
<td>&#20026;&#35835;&#21462;/&#20889;&#20837;&#25171;&#24320;&#25991;&#20214;</td>
<td>&#20174;&#36215;&#22987;&#35835;&#21462;</td>
<td>&#38169;&#35823;</td>
</tr>
<tr>
<td><code>&quot;w+&quot;</code></td>
<td>&#25193;&#23637;&#20889;</td>
<td>&#20026;&#35835;&#21462;/&#20889;&#20837;&#21019;&#24314;&#25991;&#20214;</td>
<td>&#38144;&#27585;&#20869;&#23481;</td>
<td>&#21019;&#24314;&#26032;&#25991;&#20214;</td>
</tr>
<tr>
<td><code>&quot;a+&quot;</code></td>
<td>&#25193;&#23637;&#36861;&#21152;</td>
<td>&#20026;&#35835;&#21462;/&#20889;&#20837;&#25171;&#24320;&#25991;&#20214;</td>
<td>&#20889;&#20837;&#21040;&#26411;&#23614;</td>
<td>&#21019;&#24314;&#26032;&#25991;&#20214;</td>
</tr>
<tr>
<td>&#25991;&#20214;&#35775;&#38382;&#27169;&#24335;&#26631;&#24535; <code>&quot;b&quot;</code> &#33021;&#21487;&#36873;&#22320;&#25351;&#23450;&#65292;&#20197;<a href="cpp-io-c-FILE.html#.E4.BA.8C.E8.BF.9B.E5.88.B6.E4.B8.8E.E6.96.87.E6.9C.AC.E6.A8.A1.E5.BC.8F">&#29992;&#20108;&#36827;&#21046;&#27169;&#24335;</a>&#25171;&#24320;&#25991;&#20214;&#12290;&#27492;&#26631;&#24535;&#22312; POSIX &#31995;&#32479;&#19978;&#26080;&#25928;&#26524;&#65292;&#20294;&#20363;&#22914;&#22312; Windows &#19978;&#65292;&#23427;&#31105;&#29992; <span class="t-c"><span class="mw-geshi cpp source-cpp"><span class="st0">&#39;<span class="es1">\n</span>&#39;</span></span></span> &#21644; <span class="t-c"><span class="mw-geshi cpp source-cpp"><span class="st0">&#39;<span class="es2">\x1A</span>&#39;</span></span></span> &#30340;&#29305;&#27530;&#22788;&#29702;&#12290;<br />
&#22312;&#36861;&#21152;&#25991;&#20214;&#35775;&#38382;&#27169;&#24335;&#19978;&#65292;&#20889;&#20837;&#25968;&#25454;&#21040;&#25991;&#20214;&#23614;&#65292;&#24573;&#30053;&#25991;&#20214;&#20301;&#32622;&#25351;&#31034;&#22120;&#30340;&#24403;&#21069;&#20301;&#32622;&#12290;</td>
</tr>
<tr>
<td>&#25991;&#20214;&#35775;&#38382;&#27169;&#24335;&#26631;&#24535; <code>&quot;x&quot;</code> &#33021;&#21487;&#36873;&#22320;&#36861;&#21152;&#21040; &quot;w&quot; &#25110; &quot;w+&quot; &#25351;&#23450;&#31526;&#12290;&#27492;&#26631;&#24535;&#24378;&#21046;&#20989;&#25968;&#22312;&#25991;&#20214;&#23384;&#22312;&#30340;&#24773;&#20917;&#19979;&#22833;&#36133;&#65292;&#32780;&#38750;&#37325;&#20889;&#25991;&#20214;&#12290;<span class="t-mark-rev t-since-cxx17">(C++17)</span></td>
</tr>
<tr>
<td>&#33509;&#27169;&#24335;&#19981;&#26159;&#20197;&#19978;&#23383;&#31526;&#20018;&#20043;&#19968;&#65292;&#21017;&#34892;&#20026;&#26410;&#23450;&#20041;&#12290;&#19968;&#20123;&#23454;&#29616;&#23450;&#20041;&#39069;&#22806;&#30340;&#25903;&#25345;&#27169;&#24335;&#65288;&#20363;&#22914; <a rel="nofollow" class="external text" href="https://docs.microsoft.com/zh-cn/cpp/c-runtime-library/reference/fopen-wfopen">MSVC</a> &#65289;&#12290;</td>
</tr>
</table>
</td>
</tr>
</table>
<h3><span class="mw-headline" id=".E8.BF.94.E5.9B.9E.E5.80.BC">&#36820;&#22238;&#20540;</span></h3>
<p>&#33509;&#25104;&#21151;&#65292;&#21017;&#36820;&#22238;&#25351;&#21521;&#25511;&#21046;&#25171;&#24320;&#30340;&#25991;&#20214;&#27969;&#30340;&#23545;&#35937;&#30340;&#25351;&#38024;&#65292;&#24182;&#28165;&#38500;&#25991;&#20214;&#23614;&#21644;&#38169;&#35823;&#20301;&#12290;&#27969;&#20026;&#23436;&#20840;&#32531;&#20914;&#65292;&#38500;&#38750; <span class="t-spar">filename</span> &#25351;&#20195;&#20132;&#20114;&#35774;&#22791;&#12290;</p>
<p>&#38169;&#35823;&#26102;&#65292;&#36820;&#22238;&#31354;&#25351;&#38024;&#12290; <a rel="nofollow" class="external text" href="http://pubs.opengroup.org/onlinepubs/9699919799/functions/fopen.html">POSIX &#35201;&#27714;</a>&#27492;&#24773;&#20917;&#19979;&#35774;&#32622; <span class="t-lc"><a href="cpp-error-errno.html">errno</a></span> &#12290;</p>
<h3><span class="mw-headline" id=".E6.B3.A8.E6.84.8F">&#27880;&#24847;</span></h3>
<p><code>filename</code> &#30340;&#26684;&#24335;&#26159;&#23454;&#29616;&#23450;&#20041;&#30340;&#65292;&#19988;&#19981;&#24517;&#25351;&#20195;&#19968;&#20010;&#25991;&#20214;&#65288;&#20363;&#22914;&#23427;&#21487;&#20197;&#26159;&#25511;&#21046;&#21488;&#25110;&#21478;&#19968;&#33021;&#36890;&#36807;&#25991;&#20214;&#31995;&#32479; API &#35775;&#38382;&#30340;&#35774;&#22791;&#65289;&#12290;&#22312;&#25903;&#25345;&#30340;&#24179;&#21488;&#19978;&#65292; <code>filename</code> &#21487;&#21253;&#21547;&#32477;&#23545;&#25110;&#30456;&#23545;&#25991;&#20214;&#31995;&#32479;&#36335;&#24452;&#12290;</p>
<p>&#21487;&#31227;&#26893;&#30340;&#30446;&#24405;&#21644;&#25991;&#20214;&#21629;&#21517;&#65292;&#35265; <a href="cpp-filesystem.html">C++ &#25991;&#20214;&#31995;&#32479;&#24211;</a>&#25110; <a rel="nofollow" class="external text" href="http://www.boost.org/doc/libs/1_56_0/libs/filesystem/doc/index.htm">boost.filesystem</a> &#12290;</p>
<h3><span class="mw-headline" id=".E7.A4.BA.E4.BE.8B">&#31034;&#20363;</span></h3>
<div class="t-example">
<div class="t-example-live-link"></div>
<div dir="ltr" class="mw-geshi" style="text-align: left;">
<div class="cpp source-cpp">
<pre class="de1"><span class="co2">#include &lt;cstdio&gt;</span>
<span class="co2">#include &lt;cstdlib&gt;</span>
<span class="kw4">int</span> main<span class="br0">(</span><span class="br0">)</span>
<span class="br0">{</span>
FILE<span class="sy2">*</span> fp <span class="sy1">=</span> std<span class="sy4">::</span><span class="me2">fopen</span><span class="br0">(</span><span class="st0">&quot;test.txt&quot;</span>, <span class="st0">&quot;r&quot;</span><span class="br0">)</span><span class="sy4">;</span>
<span class="kw1">if</span><span class="br0">(</span><span class="sy3">!</span>fp<span class="br0">)</span> <span class="br0">{</span>
<a href="cpp-io-c-perror.html"><span class="kw1872">std::<span class="me2">perror</span></span></a><span class="br0">(</span><span class="st0">&quot;File opening failed&quot;</span><span class="br0">)</span><span class="sy4">;</span>
<span class="kw1">return</span> <a href="cpp-utility-program-EXIT_status.html"><span class="kw973">EXIT_FAILURE</span></a><span class="sy4">;</span>
<span class="br0">}</span>
<span class="kw4">int</span> c<span class="sy4">;</span> <span class="co1">// &#27880;&#24847;&#65306;&#26159; int &#32780;&#38750; char &#65292;&#35201;&#27714;&#22788;&#29702; EOF</span>
<span class="kw1">while</span> <span class="br0">(</span><span class="br0">(</span>c <span class="sy1">=</span> <a href="cpp-io-c-fgetc.html"><span class="kw1820">std::<span class="me2">fgetc</span></span></a><span class="br0">(</span>fp<span class="br0">)</span><span class="br0">)</span> <span class="sy3">!</span><span class="sy1">=</span> <a href="cpp-io-c.html"><span class="kw1881">EOF</span></a><span class="br0">)</span> <span class="br0">{</span> <span class="co1">// &#26631;&#20934; C I/O &#25991;&#20214;&#35835;&#21462;&#24490;&#29615;</span>
<a href="cpp-io-c-putchar.html"><span class="kw1828">std::<span class="me2">putchar</span></span></a><span class="br0">(</span>c<span class="br0">)</span><span class="sy4">;</span>
<span class="br0">}</span>
<span class="kw1">if</span> <span class="br0">(</span><a href="cpp-io-c-ferror.html"><span class="kw1871">std::<span class="me2">ferror</span></span></a><span class="br0">(</span>fp<span class="br0">)</span><span class="br0">)</span>
<a href="cpp-io-c-puts.html"><span class="kw1829">std::<span class="me2">puts</span></span></a><span class="br0">(</span><span class="st0">&quot;I/O error when reading&quot;</span><span class="br0">)</span><span class="sy4">;</span>
<span class="kw1">else</span> <span class="kw1">if</span> <span class="br0">(</span><a href="cpp-io-c-feof.html"><span class="kw1870">std::<span class="me2">feof</span></span></a><span class="br0">(</span>fp<span class="br0">)</span><span class="br0">)</span>
<a href="cpp-io-c-puts.html"><span class="kw1829">std::<span class="me2">puts</span></span></a><span class="br0">(</span><span class="st0">&quot;End of file reached successfully&quot;</span><span class="br0">)</span><span class="sy4">;</span>
<a href="cpp-io-c-fclose.html"><span class="kw1815">std::<span class="me2">fclose</span></span></a><span class="br0">(</span>fp<span class="br0">)</span><span class="sy4">;</span>
<span class="br0">}</span></pre></div>
</div>
</div>
<h3><span class="mw-headline" id=".E5.8F.82.E9.98.85">&#21442;&#38405;</span></h3>
<table class="t-dsc-begin">
<tr class="t-dsc">
<td>
<div class="t-dsc-member-div">
<div><a href="cpp-io-c-fclose.html"><span class="t-lines"><span>fclose</span></span></a></div>
</div>
</td>
<td>&#20851;&#38381;&#25991;&#20214;<br />
<span class="t-mark">(&#20989;&#25968;)</span></td>
</tr>
<tr class="t-dsc">
<td>
<div class="t-dsc-member-div">
<div><a href="cpp-io-c-fflush.html"><span class="t-lines"><span>fflush</span></span></a></div>
</div>
</td>
<td>&#23558;&#36755;&#20986;&#27969;&#19982;&#23454;&#38469;&#25991;&#20214;&#21516;&#27493;<br />
<span class="t-mark">(&#20989;&#25968;)</span></td>
</tr>
<tr class="t-dsc">
<td>
<div class="t-dsc-member-div">
<div><a href="cpp-io-c-freopen.html"><span class="t-lines"><span>freopen</span></span></a></div>
</div>
</td>
<td>&#20197;&#19981;&#21516;&#21517;&#31216;&#25171;&#24320;&#26082;&#23384;&#27969;<br />
<span class="t-mark">(&#20989;&#25968;)</span></td>
</tr>
</table>
</div>
<div class="visualClear"></div>
</div>
</div>
</div>
</body>
</html>