uTools-Manuals/docs/php/filesize.html
2019-04-28 19:00:34 +08:00

105 lines
4.6 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<title>取得文件大小</title>
</head>
<body class="docs"><div id="layout">
<div id="layout-content"><div id="function.filesize" class="refentry">
<div class="refnamediv">
<h1 class="refname">filesize</h1>
<p class="verinfo">(PHP 4, PHP 5, PHP 7)</p><p class="refpurpose"><span class="refname">filesize</span> &mdash; <span class="dc-title">取得文件大小</span></p>
</div>
<div class="refsect1 description" id="refsect1-function.filesize-description">
<h3 class="title">说明</h3>
<div class="methodsynopsis dc-description">
<span class="methodname"><strong>filesize</strong></span>
( <span class="methodparam"><span class="type">string</span> <code class="parameter">$filename</code></span>
) : <span class="type">int</span></div>
<p class="para rdfs-comment">
取得指定文件的大小。
</p>
</div>
<div class="refsect1 parameters" id="refsect1-function.filesize-parameters">
<h3 class="title">参数</h3>
<p class="para">
<dl>
<dt>
<code class="parameter">filename</code></dt>
<dd>
<p class="para">
文件的路径。
</p>
</dd>
</dl>
</p>
</div>
<div class="refsect1 returnvalues" id="refsect1-function.filesize-returnvalues">
<h3 class="title">返回值</h3>
<p class="para">
返回文件大小的字节数,如果出错返回 <strong><code>FALSE</code></strong> 并生成一条
<strong><code>E_WARNING</code></strong> 级的错误。
</p>
<blockquote class="note"><p><strong class="note">Note</strong>: <span class="simpara">
因为 PHP 的整数类型是有符号整型而且很多平台使用 32 位整型,对 2GB
以上的文件,一些文件系统函数可能返回无法预期的结果 。</span></p></blockquote>
</div>
<div class="refsect1 examples" id="refsect1-function.filesize-examples">
<h3 class="title">范例</h3>
<p class="para">
<div class="example" id="example-2793">
<p><strong>Example #1 <span class="function"><strong>filesize()</strong></span> 例子</strong></p>
<div class="example-contents">
<div class="phpcode"><pre><span style="color: #000000">
<span style="color: #0000BB">&lt;?php<br /><br /></span><span style="color: #FF8000">//&nbsp;输出类似somefile.txt:&nbsp;1024&nbsp;bytes<br /><br /></span><span style="color: #0000BB">$filename&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #DD0000">'somefile.txt'</span><span style="color: #007700">;<br />echo&nbsp;</span><span style="color: #0000BB">$filename&nbsp;</span><span style="color: #007700">.&nbsp;</span><span style="color: #DD0000">':&nbsp;'&nbsp;</span><span style="color: #007700">.&nbsp;</span><span style="color: #0000BB">filesize</span><span style="color: #007700">(</span><span style="color: #0000BB">$filename</span><span style="color: #007700">)&nbsp;.&nbsp;</span><span style="color: #DD0000">'&nbsp;bytes'</span><span style="color: #007700">;<br /><br /></span><span style="color: #0000BB">?&gt;</span>
</span>
</pre></div>
</div>
</div>
</p>
</div>
<div class="refsect1 errors" id="refsect1-function.filesize-errors">
<h3 class="title">错误/异常</h3>
<p class="para">
失败时抛出<strong><code>E_WARNING</code></strong>警告。
</p>
</div>
<div class="refsect1 notes" id="refsect1-function.filesize-notes">
<h3 class="title">注释</h3>
<blockquote class="note"><p><strong class="note">Note</strong>: <span class="simpara">此函数的结果会被缓存。参见
<span class="function"><a href="clearstatcache.html" class="function">clearstatcache()</a></span> 以获得更多细节。</span></p></blockquote>
<div class="tip"><strong class="tip">Tip</strong><p class="simpara">自 PHP 5.0.0 起, 此函数也用于<em class="emphasis">某些</em>
URL 包装器。请参见 <a href="wrappers.html" class="xref">支持的协议和封装协议</a>以获得支持 <span class="function"><a href="stat.html" class="function">stat()</a></span> 系列函数功能的包装器列表。</p></div>
</div>
<div class="refsect1 seealso" id="refsect1-function.filesize-seealso">
<h3 class="title">参见</h3>
<p class="para">
<ul class="simplelist">
<li class="member"><span class="function"><a href="file_exists.html" class="function" rel="rdfs-seeAlso">file_exists()</a> - 检查文件或目录是否存在</span></li>
</ul>
</p>
</div>
</div></div></div></body></html>