id3_get_version

(PECL id3 >= 0.1)

id3_get_version — ID3 タグのバージョンを取得する

説明

id3_get_version ( string $filename ) : int

id3_get_version() は、MP3 ファイル内の ID3 タグのバージョンを取得します。

あるファイルが ID3 v1.1 タグを含んでいるのなら、そのファイルは 常に 1.0 タグも含んでいます。というのも、バージョン 1.1 は単に 1.0 を拡張したものであるからです。

パラメータ

filename

MP3 ファイルへのパス。

ファイル名のかわりに、ストリームリソースを渡すことも可能です。

返り値

MP3 ファイル内の ID3 タグのバージョンを返します。 ID3 v1.x のタグおよび v2.x のタグを同時に保持することも可能なので、 この関数の返す値を利用する際には 定義済みの定数 ID3_V1_0、 ID3_V1_1 および ID3_V2 とのビット比較を行わなければなりません。

例

例1 id3_get_version() の例

<?php
$version = id3_get_version( "path/to/example.mp3" );
if ($version & ID3_V1_0) {
    echo "1.x タグを含んでいます\n";
}
if ($version & ID3_V1_1) {
    echo "1.1 タグを含んでいます\n";
}
if ($version & ID3_V2) {
    echo "2.x タグを含んでいます\n";
}
?>

上の例の出力は、 たとえば以下のようになります。

1.x タグを含んでいます
1.1 タグを含んでいます

参考