Fonctions

Afin de pouvoir insérer les valeurs de certaines variables d’environnement au cours du processus d’évaluation, le générateur de document fournit plusieurs fonctions qui peuvent être utilisées dans des définitions d’entité ou des modèles :

&base(file);     
supprime l’information du chemin d’accès et l’extension à partir du fichier de spécification.   
Exemple : &base(/home/bscw/www/faq.dtm); résultats à faq

&rel(path);
génère un nom de chemin relatif à partir d’un nom de chemin absolu. Le nom du chemin d’accès généré est relatif au document qui sera généré (défini dans le para­mètre d’évaluation document).   
Exemple : Si l’expression &rel(/Images); est utilisé dans un modèle, ceci génère le document /faq/index.htm, cette expression sera évalué à ../Images. Si quelqu’un utilise la même expression dans un modèle qui génère le document /faq/question/ install.htm, il sera évalué à ../../Images.

&size(file, [B|K|M|G]);
retourne la taille d’un fichier en octets, kilooctets, mégaoctets or giga-octets, dépen­damment de la valeur du second paramètre.        
Exemple : &size(/Download/bscw34.exe, M); résultats à 8.43

&date(format);   
retourne la date courante et l’heure. Les directives suivantes peuvent être utilisées dans le format chaîne de caractères. Ils sont ici affichés sans les spécifications optionnelles de largeur de champ et de précision.

 

Directive   

Sens

%a

Nom abrégé du jour de la semaine des paramètres régionaux.

%A

Nom complet du jour de la semaine des paramètres régionaux.

%b

Nom abrégé du mois des paramètres régionaux.

%B

Nom complet du mois des paramètres régionaux.

%c

Représentation appropriée de la date et de l’heure des paramètres régionaux.

%d

Jour du mois comme un nombre décimal [01, 31].

%H

Heure (horloge 24-heure) comme un nombre décimal [00, 23].

%I

Heure (horloge 12-heure) comme un nombre décimal [01, 12].

%j

Jour de l’année comme un nombre décimal [001, 366].

%m

Mois comme un nombre décimal [01, 12].

%M

Minute comme un nombre décimal [00, 59].

%p

Équivalent d’AM ou PM des paramètres régionaux.

%S

Seconde comme un nombre décimal [00, 61].

%U

Numéro de semaine de l’année (Dimanche comme le premier jour de la semaine) comme un nombre décimal [00, 53]. Tous les jours de l’année précédant le premier dimanche appartiennent à la semaine 0.

%w

Jour de la semaine comme un nombre décimal [0 (Dimanche), 6].

%W

Numéro de la semaine de l’année (Lundi comme premier jour de la semaine) comme un nombre décimal [00, 53]. Tous les jours de l’année précédant le premier lundi font partie de la semaine 0.

%x

Représentation appropriée de la date dans les paramètres régionaux.

%X

Représentation appropriée de l’heure dans les paramètres régionaux.

%y

Année sans le siècle comme un nombre décimal [00, 99].

%Y

Année avec le siècle comme un nombre décimal.

%Z

Nom du fuseau horaire (ou chaîne vide si le fuseau horaire n’existe pas).

%%

Le caractère %.

Exemple : Le 10 octobre 2005, le résultat de &date(%B %Y); est octobre 2005.