filesize
(PHP 4, PHP 5)
filesize — ファイルのサイズを取得する
ファイルのサイズを返し、エラーの場合は FALSE を返します (また E_WARNING レベルのエラーを発生させます) 。
注意: PHP の数値型は符号付整数であり、 多くのプラットフォームでは 32 ビットの整数を取るため、 filesize() は 2GB より大きなファイルについては期待とは違う値を返すことがあります。 2GB から 4GB のサイズのファイルについては sprintf("%u", filesize($file)) を使うことで打開されます。
注意: この関数の結果は キャッシュされます。詳細は、clearstatcache() を参照してください。
例 602. filesize() の例
file_exists() も参照してください。
filesize — ファイルのサイズを取得する
説明
int filesize ( string filename )ファイルのサイズを返し、エラーの場合は FALSE を返します (また E_WARNING レベルのエラーを発生させます) 。
注意: PHP の数値型は符号付整数であり、 多くのプラットフォームでは 32 ビットの整数を取るため、 filesize() は 2GB より大きなファイルについては期待とは違う値を返すことがあります。 2GB から 4GB のサイズのファイルについては sprintf("%u", filesize($file)) を使うことで打開されます。
注意: この関数の結果は キャッシュされます。詳細は、clearstatcache() を参照してください。
ティップ
PHP 5.0.0 以降、この関数は、 何らかの URL ラッパーと組合せて使用することができます。 どのラッパーが stat() ファミリーをサポートしているか のリストについては、付録 M. サポートされるプロトコル/ラッパー を参照してください。例 602. filesize() の例
<?php
// 出力例 somefile.txt: 1024 bytes
$filename = 'somefile.txt';
echo $filename . ': ' . filesize($filename) . ' bytes';
?>
file_exists() も参照してください。
ファイルサイズ
ファイルサイズ（英語: File size）は、コンピュータのファイルの大きさである。基本的にバイトで表現される。ファイルシステムの最大ファイルサイズはファイルシステムによって異なる。例えば、ext4は最大16 TiBのファイルサイズに対応しており[1]、Btrfsは最大64 EiBのファイルサイズに対応している[2]。
ファイルサイズを表す単位には、2進接頭辞（210n）とSI接頭語（103n）が使用されている。
ファイルシステムはストレージをブロック単位で管理している。ファイルサイズがブロックサイズの整数倍と必ず一致するわけではないので、ストレージ上で未使用の領域が発生する。
| 2進接頭辞 | SI接頭語 | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| 名称 | 記号 | 乗数 | バイト数 | 同一 | 名称 | 単位 | 乗数 | ビット数 | 同一 | |
| キビバイト | KiB | 210 | 1,024 | 1024 B | キロバイト | kB | 103 | 1,000 | 1000 B | |
| メビバイト | MiB | 220 | 1,048,576 | 1024 KiB | メガバイト | MB | 106 | 1,000,000 | 1000 kB | |
| ギビバイト | GiB | 230 | 1,073,741,824 | 1024 MiB | ギガバイト | GB | 109 | 1,000,000,000 | 1000 MB | |
| テビバイト | TiB | 240 | 1,099,511,627,776 | 1024 GiB | テラバイト | TB | 1012 | 1,000,000,000,000 | 1000 GB | |
| ペビバイト | PiB | 250 | 1,125,899,906,842,624 | 1024 TiB | ペタバイト | PB | 1015 | 1,000,000,000,000,000 | 1000 TB | |
| エクスビバイト | EiB | 260 | 1,152,921,504,606,846,976 | 1024 PiB | エクサバイト | EB | 1018 | 1,000,000,000,000,000,000 | 1000 PB | |
| ゼビバイト | ZiB | 270 | 1,180,591,620,717,411,303,424 | 1024 EiB | ゼタバイト | ZB | 1021 | 1,000,000,000,000,000,000,000 | 1000 EB | |
| ヨビバイト | YiB | 280 | 1,208,925,801,182,629,174,706,176 | 1024 ZiB | ヨタバイト | YB | 1024 | 1,000,000,000,000,000,000,000,000 | 1000 ZB | |
脚注
- ^ “Ext4 Howto”. kernel.org. 2018年8月8日閲覧。
- ^ “btrfs Wiki”. kernel.org. 2018年8月8日閲覧。
固有名詞の分類
- file sizeのページへのリンク
