id3_set_tag

(PECL)

id3_set_tag -- Modifica la información contenida en la etiqueta ID3

Descripción

bool id3_set_tag ( string nombre_archivo, array etiqueta [, int version] )

id3_set_tag() se emplea para modificar la información almacenada en una etiqueta ID3. Si el archivo no tiene ninguna etiqueta asociada, se le añade como nueva etiqueta.

Nota: Además del nombre de un archivo, también se puede indicar el nombre de un recurso de tipo stream.

El parámetro opcional version permite indicar la versión de la etiqueta que se va a utilizar, ya que los archivos MP3 pueden contener de forma simultanea etiquetas tanto versión 1.x como versión 2.x.

Ejemplo 1. Ejemplo de id3_set_tag()

<?php
$data
= array(
              
"title" => "Re:Start",
              
"artist" => "Re:\Legion",
              
"comment" => "A nice track"
             
);
$result = id3_set_tag( "ruta/al/ejemplo.mp3", $data, ID3_V1_0 );
if (
$result === true) {
    echo
"La etiqueta ha sido modificada correctamente\n";
}
?>

Si el archivo nombre_archivo tiene permiso de escritura, la salida del programa será la siguiente:

La etiqueta ha sido modificada correctamente

Nota: Actualmente, la función id3_set_tag() solamente soporta las versiones 1.0 y 1.1.

El array asociativo empleado puede contener las siguientes claves:

Tabla 1. Claves del array asociativo

ClaveValores posiblesDisponible en la versión
titlecadena con un máximo de 30 caracteresv1.0, v1.1
artistcadena con un máximo de 30 caracteresv1.0, v1.1
albumcadena con un máximo de 30 caracteresv1.0, v1.1
year4 digitosv1.0, v1.1
genreentero con un valor entre 0 y 147v1.0, v1.1
commentcadena con un máximo de 30 caracteres (28 en v1.1)v1.0, v1.1
trackentero con un valor entre 0 y 255v1.1

Vea también id3_get_tag(), id3_remove_tag() y id3_get_version().

Hosting by: hurra.com
Generated: 2007-01-26 18:00:59