Manual de PHP
AnteriorSiguiente

xattr_set

(PECL)

xattr_set --  Establece un atributo extendido

Descripción

bool xattr_set ( string nombre_archivo, string atributo, string valor [, int opciones] )

La función establece el valor de un atributo extendido del archivo.

Extended attributes have two different namespaces: user and root namespace. User namespace is available for all users while root namespace is available only for user with root privileges. xattr operates on user namespace by default, but you can change that using flags argument.

Lista de parámetros

nombre_archivo

El archivo al que se establecerá el atributo.

atributo

Nombre del atributo extendido. El atributo se crea si no existe y se reemplaza si ya existía. Se puede modificar este comportamiento con el parámetro opciones.

valor

El valor del atributo.

opciones

Tabla 1. Opciones de xattr soportadas

XATTR_CREATELa función falla si el atributo extendido ya existía.
XATTR_REPLACELa función falla si el atributo extendido no existe.
XATTR_DONTFOLLOWRealizar las operaciones en el propio enlace simbólico (no seguirlo).
XATTR_ROOTEstablecer atributo en el espacio de nombres raíz (y de confianza). Requiere privilegios de root.

Valores retornados

Devuelve TRUE si todo se llevó a cabo correctamente, FALSE en caso de fallo.

Ejemplos

Ejemplo 1. Establecer atributos extendidos en un archivo de extensión .wav

<?php
$archivo = 'mi_cancion_favorita.wav';
xattr_set($archivo, 'Artista', 'Algun artista');
xattr_set($archivo, 'Mi nota', 'Buena');
xattr_set($archivo, 'Veces escuchada', '34');

/* ... mas codigo ... */

printf("Has escuchado esta cancion %d veces", xattr_get($archivo, 'Veces escuchada'));
?>

Ver también

xattr_get()
xattr_remove()

AnteriorInicioSiguiente
xattr_removeSubirxattr_supported

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