Manuel PHP
PrécédentSuivant

xattr_set

(PECL)

xattr_set --  Définie un attribut étendu

Description

bool xattr_set ( string filename, string name, string value [, int flags] )

xattr_set() définie la valeur d'un attribut étendu nommé name à la valeur value d'un fichier désigné par le paramètre path.

Les attributs étendus ont deux espaces de noms différents : user et root. L'espace de noms user est disponible pour tous les utilisateurs tandis que l'espace de noms root n'est disponible que pour les utilisateurs ayant les privilèges root. xattr opère sur l'espace de noms user par défaut, mais vous pouvez changer cela en utilisant l'argument flags.

Liste de paramètres

filename

Le fichier dans lequel nous devons définir l'attribut.

name

Le nom de l'attribut étendu. Cet attribut sera créé s'il n'existe pas encore ou remplacé sinon. Vous pouvez modifier ce comportement en utilisant le paramètre flags parameter.

value

La valeur de l'attribut.

flags

Tableau 1. Flags xattr supportés

XATTR_CREATELa fonction échouera si l'attribut étendu existe déjà.
XATTR_REPLACELa fonction échouera si l'attribut étendu n'existe pas.
XATTR_DONTFOLLOWNe pas suivre les liens symboliques mais opère directement sur le lien lui-même.
XATTR_ROOTDéfinie l'attribut dans l'espace de noms racine. Nécessaire les privilèges d'administrateur.

Valeurs de retour

Cette fonction retourne TRUE en cas de succès, FALSE en cas d'échec.

Exemples

Exemple 1. Définission des attributs étendus dans un fichier .wav

<?php
$file = 'ma_chanson_favorite.wav';
xattr_set($file, 'Artist', 'Someone');
xattr_set($file, 'My ranking', 'Good');
xattr_set($file, 'Listen count', '34');

/* ... autres codes ... */

printf("Vous avez écouté cette chanson %d fois", xattr_get($file, 'Listen count'));
?>

Voir aussi

xattr_get()
xattr_remove()

PrécédentSommaireSuivant
xattr_removeNiveau supérieurxattr_supported

Hosting by: Hurra Communications GmbH
Generated: 2007-01-26 18:01:58