Script
Les scripts sont utilisés pour contrôler certains aspects du fonctionnement de Picard.
Il existe deux types de scripts utilisés dans Picard: le script de dénomination de fichier et les scripts de balisage. Ceux-ci sont gérés à partir des sections « Nom du fichier » et « Script » du menu
.Les scripts sont souvent abordés dans le MetaBrainz Community Forum, et il existe un fil de discussion spécifique à la dénomination de fichier et les extraits de script.
Voir aussi
Veuillez vous référer à la section sur Scripts dans Extending Picard pour plus de détails sur les deux types de scripts, y compris comment et quand chacun des scripts est exécuté.
Syntaxe
La syntaxe est dérivée du format de titre de Foobar2000. Il existe trois éléments de base: le texte, la variable et la fonction. Les variables sont constituées de caractères alphanumériques entourés de signes de pourcentage (par exemple: %artiste%
). Les fonctions commencent par un signe dollar et se terminent par une liste d’arguments entre parenthèses (par exemple: $lower(...)
).
Note
Lorsque vous entrez des chaînes d’entrée dans des scripts Picard, vous devez échapper une barre oblique inverse « \ », un signe dollar « $ », une virgule « , » et les parenthèses gauche et droite « ( » et « ) » afin de forcer Picard à ne pas les interpréter dans le cadre de la commande de script. Cela se fait en insérant une barre oblique inverse avant le caractère à échapper. Par exemple, pour définir une valeur de balise sur ($1,000,000)
, il faudrait la saisir sous la forme $set(test_tag,\(\$1\,000\,000\))
.
Note
En général, vous pouvez accéder aux valeurs d’une balise par le nom de variable approprié. Par exemple, si votre balise s’appelle « rerecorded », vous pouvez utiliser %rerecorded%
. Mais le trait d’union n’est pas un caractère valide pour une variable de script, donc %re-recorded%
donne une erreur de syntaxe. Dans des cas comme celui-ci, vous devez utiliser $get(re-recorded)
.
Variables de métadonnées
Voir Balises & Variables pour la liste des variables fournies par Picard.
Les variables de Picard peuvent être soit de simples variables contenant une seule chaîne de texte, soit des variables à valeurs multiples contenant plusieurs chaînes de texte. Dans les scripts, les variables à valeurs multiples sont automatiquement converties en une seule chaîne de texte en joignant les valeurs par un point-virgule “;”, sauf lorsqu’elles sont utilisées avec des fonctions spéciales à valeurs multiples.
Fonctions de script
La liste complète des fonctions de script disponibles est disponible, soit trié par ordre alphabétique ou groupé par type de fonction.