m4posix - En ligne dans le Cloud

PROGRAMME:

Nom

m4 — macroprocesseur

SYNOPSIS

m4 [-s] [-D prénom[=vague]] [−U prénom] filet

DESCRIPTION

La m4 l'utilitaire est un macroprocesseur qui doit lire un ou plusieurs fichiers texte, les traiter
selon leurs instructions de macro incluses, et écrivez les résultats sur la sortie standard.

OPTIONS

La m4 l'utilitaire doit être conforme au volume Base Definitions de POSIX.1‐2008, Section 12.2,
utilitaire Syntaxe Recommandations, sauf que l'ordre du -D ainsi que −U les options doivent être
significatif, et les options peuvent être entrecoupées d'opérandes.

Les options suivantes doivent être prises en charge :

-s Activer la sortie de synchronisation de ligne pour le c99 phase de préprocesseur (c'est-à-dire
#ligne directives).

-D prénom[=vague]
Définir prénom à vague ou à null si =vague est omis.

−U prénom Indéfinir prénom.

OPÉRANDES

L'opérande suivant doit être pris en charge :

filet Un chemin d'accès d'un fichier texte à traiter. Sinon filet est donné, ou s'il est '−',
l'entrée standard doit être lue.

STDIN

L'entrée standard doit être un fichier texte qui est utilisé si aucun filet l'opérande est donné, ou s'il
is '−'.

CONTRIBUTION DES DOSSIERS

Le fichier d'entrée nommé par le filet l'opérande doit être un fichier texte.

ENVIRONNEMENT VARIABLES

Les variables d'environnement suivantes doivent affecter l'exécution de m4:

LANGUE Fournissez une valeur par défaut pour les variables d'internationalisation qui ne sont pas définies ou
nul. (Voir le volume Définitions de base de POSIX.1‐2008, Section 8.2,
Internationalisation Variables pour la priorité de l'internationalisation
variables utilisées pour déterminer les valeurs des catégories de paramètres régionaux.)

LC_TOUS S'il est défini sur une valeur de chaîne non vide, remplace les valeurs de tous les autres
variables d'internationalisation.

LC_CTYPE Déterminer la localisation pour l'interprétation des séquences d'octets de données de texte
sous forme de caractères (par exemple, des caractères à un octet par opposition aux caractères à plusieurs octets dans
arguments et fichiers d'entrée).

LC_MESSAGES
Déterminez les paramètres régionaux qui doivent être utilisés pour affecter le format et le contenu de
messages de diagnostic écrits dans l'erreur standard.

NLSPATH Déterminer l'emplacement des catalogues de messages pour le traitement des LC_MESSAGES.

ASYNCHRONE ÉVÉNEMENTS

Par défaut.

SORTIE STD

La sortie standard doit être la même que les fichiers d'entrée, après avoir été traitée pour la macro
vous propose d’explorer.

STDERR

L'erreur standard doit être utilisée pour afficher les chaînes avec le erreur d'impression macro, suivi de macro
activé par le traceur macro, le texte défini pour les macros écrites par le dumpdef macro, ou
pour les messages de diagnostic.

SORTIE DES DOSSIERS

Aucun.

ÉLARGI DESCRIPTION

La m4 L'utilitaire doit comparer chaque jeton de l'entrée à l'ensemble des éléments intégrés et
macros définies par l'utilisateur. Si le jeton correspond au nom d'une macro, alors le jeton doit être
remplacé par le texte de définition de la macro, le cas échéant, et réanalysé pour les noms de macro correspondants.
Une fois qu'aucune partie du jeton ne correspond au nom d'une macro, elle doit être écrite dans le format standard
sortir. Les macros peuvent avoir des arguments, auquel cas les arguments doivent être remplacés par
le texte de définition avant qu'il ne soit renumérisé.

Les appels de macro ont la forme :

prénom(argument1, argument2, ..., argn)

Les noms de macro doivent être constitués de lettres, de chiffres et de traits de soulignement, le premier caractère
n'est pas un chiffre. Les jetons qui n'ont pas cette forme ne doivent pas être traités comme des macros.

La demande garantit que le suit immédiatement le nom de
la macro. Si un jeton correspondant au nom d'une macro n'est pas suivi d'un
parenthèse>, il est traité comme une utilisation de cette macro sans arguments.

Si un nom de macro est suivi d'un , ses arguments sont les
-des jetons séparés entre le et la correspondance
parenthèse>. Les espaces blancs sans guillemets précédant chaque argument doivent être ignorés.
Tous les autres caractères, y compris les espaces blancs de fin, sont conservés.
caractères entre et les personnages ne
délimiter les arguments.

Les arguments sont définis et référencés positionnellement. La chaîne «$ 1» dans le texte de définition
est remplacé par le premier argument. Les systèmes doivent prendre en charge au moins neuf arguments ;
seuls les neuf premiers peuvent être référencés, en utilisant les chaînes «$ 1» à «$ 9», inclus. Les
un magnifique «$ 0» est remplacé par le nom de la macro. La chaîne "$ #" est remplacé par le
nombre d'arguments sous forme de chaîne. La chaîne "$*" est remplacé par une liste de tous les
arguments, séparés par personnages. La chaîne "$@" est remplacé par une liste de tous
des arguments séparés par caractères, et chaque argument est cité en utilisant le
les chaînes de guillemets gauche et droite actuelles. La chaîne "${" produit un comportement non spécifié.

Si moins d'arguments sont fournis que dans la définition de macro, les arguments omis
sont considérés comme nuls. Ce n'est pas une erreur si plus d'arguments sont fournis que dans le
définition des macros.

Aucune signification particulière n'est donnée aux caractères compris entre la gauche et la droite correspondantes
citant les chaînes, mais les chaînes entre guillemets sont elles-mêmes rejetées. Par défaut, la gauche
la chaîne de citation se compose d'un accent grave (citation arrière) et de la chaîne de citation droite
consiste en un accent aigu (guillemet simple); voir aussi le changer devis macro.

Les commentaires sont écrits mais pas analysés pour les noms de macro correspondants ; par défaut, le début-
la chaîne de commentaire se compose du caractère et la chaîne de commentaire de fin se compose
d'un . Voir aussi le changecom ainsi que dnl macro.

La m4 L'utilitaire doit rendre disponibles les macros intégrées suivantes. Ils peuvent être redéfinis,
mais une fois cela fait, le sens originel est perdu. Leurs valeurs sont nulles à moins que
autrement dit. Dans les descriptions ci-dessous, le terme définir texte fait référence à la valeur de
la macro : le deuxième argument du Vous permet de définir macro, entre autres. Sauf pour le
premier argument à la eval macro, tous les arguments numériques des macros intégrées doivent être
interprétés comme des valeurs décimales. Les valeurs de chaîne produites comme texte de définition du
diminuer, numéro divin, augmenter, indice, lenet Syval les macros intégrées doivent être sous la forme d'un
constante décimale telle que définie dans le langage C.

changecom La changecom La macro doit définir les chaînes de début et de fin de commentaire. Sans
arguments, le mécanisme de commentaire doit être désactivé. Avec un seul non nul
argument, cet argument deviendra le début-commentaire et le doit
devenir la chaîne de commentaire de fin. Avec deux arguments non nuls, le premier argument
deviendra la chaîne de début de commentaire et le deuxième argument deviendra le
chaîne de commentaire de fin. Le comportement n'est pas spécifié si l'un des arguments est fourni
mais nul. Les systèmes doivent prendre en charge des chaînes de commentaires d'au moins cinq caractères.

changer devis
La changer devis La macro doit définir les chaînes de guillemets de début et de fin. Sans
arguments, les chaînes de guillemets doivent être définies sur les valeurs par défaut (c'est-à-dire `').
Le comportement n'est pas spécifié s'il y a un seul argument ou si l'un des arguments est
nul. Avec deux arguments non nuls, le premier argument deviendra le début-
chaîne de guillemets et le deuxième argument deviendra la chaîne de guillemets de fin. Systèmes
doit prendre en charge les chaînes de guillemets d'au moins cinq caractères.

diminuer Le texte déterminant de la diminuer macro sera son premier argument décrémenté de
1. Ce sera une erreur de spécifier un argument contenant un argument non numérique
personnages. Le comportement n'est pas spécifié si diminuer n'est pas immédiatement suivi de
une .

Vous permet de définir Le deuxième argument deviendra le texte de définition de la macro dont le nom est
le premier argument. Il n'est pas précisé si le Vous permet de définir la macro supprime tous les précédents
définitions de la macro nommée par son premier argument ou conserve tout sauf le
définition actuelle de la macro. Le comportement n'est pas spécifié si Vous permet de définir n'est pas
immédiatement suivi d'un .

défn Le texte déterminant de la défn macro doit être la définition citée (en utilisant le
chaînes de guillemets actuelles) de ses arguments. Le comportement n'est pas spécifié si défn
n'est pas immédiatement suivi d'un .

détourner La m4 L'utilitaire maintient neuf tampons temporaires, numérotés de 1 à 9 inclus.
Lorsque la dernière entrée a été traitée, toute sortie qui a été placée
dans ces tampons doivent être écrits sur la sortie standard dans l'ordre numérique des tampons.
La détourner la macro détournera la sortie future vers le tampon spécifié par son
argument. La spécification d'aucun argument ou d'un argument de 0 reprendra la normale
processus de sortie. La sortie déviée vers un flux avec un nombre négatif doit être
mis au rebut. Le comportement est défini par l'implémentation si un nombre de flux supérieur à 9
est spécifié. Ce sera une erreur de spécifier un argument contenant un
caractères numériques.

numéro divin Le texte déterminant de la numéro divin macro doit être le numéro de la sortie actuelle
flux sous forme de chaîne.

dnl La dnl macro doit provoquer m4 pour supprimer tous les caractères saisis jusqu'à et y compris
le suivant .

dumpdef La dumpdef macro doit écrire le texte défini à l'erreur standard pour chacun des
macros spécifiées comme arguments, ou, si aucun argument n'est spécifié, pour tous
macro.

erreur d'impression La erreur d'impression la macro écrira ses arguments dans l'erreur standard. Le comportement est
non spécifié si erreur d'impression n'est pas immédiatement suivi d'un .

eval La eval la macro évaluera son premier argument comme une expression arithmétique,
en utilisant l'arithmétique des entiers signés avec une précision d'au moins 32 bits. Au moins le
les opérateurs de langage C suivants doivent être pris en charge, avec priorité,
l'associativité et le comportement tels que décrits dans Section 1.1.2.1, Arithmétique
La précision ainsi que Opérations:

()
unaire +
unaire -
~

!
binaire *
/
%
binaire +
binaire −
<<
>>
<
<=
>
>=
==
!=
binaire &
^
|
&&
||

Les systèmes doivent prendre en charge les nombres octaux et hexadécimaux comme dans la norme ISO C.
Le deuxième argument, s'il est spécifié, doit définir la base du résultat ; si la
l'argument est vide ou non spécifié, la valeur par défaut est 10. Le comportement n'est pas spécifié si
la base n'est pas comprise entre 2 et 36 inclus. Le troisième argument, si
spécifié, définit le nombre minimum de chiffres dans le résultat. Le comportement est
non spécifié si le troisième argument est inférieur à zéro. Ce sera une erreur de
spécifiez le deuxième ou le troisième argument contenant des caractères non numériques. Les
le comportement n'est pas spécifié si eval n'est pas immédiatement suivi d'un
parenthèse>.

ifdef Si le premier argument du ifdef macro est définie, le texte de définition doit être
le deuxième argument. Sinon, le texte de définition sera le troisième argument,
si spécifié, ou la chaîne nulle, sinon. Le comportement n'est pas spécifié si ifdef
n'est pas immédiatement suivi d'un .

sinon La sinon macro prend trois arguments ou plus. Si les deux premiers arguments
comparer en tant que chaînes égales (après expansion macro des deux arguments), la définition
le texte sera le troisième argument. Si les deux premiers arguments ne se comparent pas comme
des chaînes égales et il y a trois arguments, le texte de définition doit être nul. Si
les deux premiers arguments ne se comparent pas comme des chaînes égales et il y a quatre ou
cinq arguments, le texte de définition sera le quatrième argument. Si les deux premiers
les arguments ne se comparent pas comme des chaînes égales et il y a six arguments ou plus,
les trois premiers arguments doivent être rejetés et le traitement doit reprendre avec
les arguments restants. Le comportement n'est pas spécifié si sinon n'est pas
immédiatement suivi d'un .

comprendre Le texte définissant le comprendre macro doit être le contenu du fichier nommé
par le premier argument. Ce sera une erreur si le fichier ne peut pas être lu. Les
le comportement n'est pas spécifié si comprendre n'est pas immédiatement suivi d'un
parenthèse>.

augmenter Le texte déterminant de la augmenter macro sera son premier argument incrémenté de
1. Ce sera une erreur de spécifier un argument contenant un argument non numérique
personnages. Le comportement n'est pas spécifié si augmenter n'est pas immédiatement suivi de
une .

indice Le texte déterminant de la indice macro doit être la première position de caractère (en tant que
chaîne) dans le premier argument où commence une chaîne correspondant au deuxième argument
(origine zéro), ou -1 si le deuxième argument n'apparaît pas. Le comportement est
non spécifié si indice n'est pas immédiatement suivi d'un .

len Le texte déterminant de la len macro doit être la longueur (sous forme de chaîne) de la
premier argument. Le comportement n'est pas spécifié si len n'est pas immédiatement suivi
par un .

m4sortie Sortir de la m4 utilitaire. Si le premier argument est spécifié, c'est la sortie
code. La valeur par défaut est zéro. Ce sera une erreur de spécifier un argument
contenant des caractères non numériques.

m4wrap Le premier argument doit être traité lorsque EOF est atteint. Si la m4wrap macro
est utilisé plusieurs fois, les arguments spécifiés doivent être traités dans l'ordre
dans lequel le m4wrap les macros ont été traitées. Le comportement n'est pas spécifié si m4wrap
n'est pas immédiatement suivi d'un .

fairetemp Le texte de définition doit être le premier argument, avec 'X' caractères
remplacé par l'ID de processus actuel sous forme de chaîne. Le comportement n'est pas spécifié
if fairetemp n'est pas immédiatement suivi d'un .

mkstemp Le premier argument doit être pris comme modèle pour créer un fichier vide, avec
traînant 'X' caractères remplacés par des caractères du nom de fichier portable
jeu de caractères. Le comportement n'est pas spécifié si le premier argument ne se termine pas par
au moins six 'X' personnages. Si un fichier temporaire est créé avec succès, alors
le texte de définition de la macro doit être le nom du nouveau fichier. L'identifiant de l'utilisateur
du fichier doit être défini sur l'ID utilisateur effectif du processus. L'identifiant du groupe
du fichier doit être défini sur l'ID de groupe du répertoire parent du fichier ou sur
l'ID de groupe effectif du processus. Les bits d'autorisation d'accès aux fichiers sont définis
de telle sorte que seul le propriétaire puisse à la fois lire et écrire le fichier, quel que soit le
actuel umask du processus. Si un fichier n'a pas pu être créé, le texte de définition
de la macro doit être la chaîne vide. Le comportement n'est pas spécifié si mkstemp
n'est pas immédiatement suivi d'un .

popdef La popdef macro doit supprimer la définition actuelle de ses arguments, remplaçant
cette définition avec la précédente. S'il n'y a pas de définition précédente, le
la macro n'est pas définie. Le comportement n'est pas spécifié si popdef n'est pas immédiatement
suivi d'un .

pushdef La pushdef macro doit être équivalente à la Vous permet de définir macro à l'exception
qu'il préserve toute définition actuelle pour une récupération future en utilisant le
popdef macro. Le comportement n'est pas spécifié si pushdef n'est pas immédiatement suivi
par un .

décalage Le texte définissant le décalage macro doit être une liste séparée par des virgules de ses
arguments sauf le premier. Chaque argument doit être cité en utilisant le courant
citant des chaînes. Le comportement n'est pas spécifié si décalage n'est pas immédiatement
suivi d'un .

inclure La inclure macro doit être équivalente à la comprendre macro, sauf qu'il
ne doit pas être une erreur si le fichier est inaccessible. Le comportement n'est pas spécifié
if inclure n'est pas immédiatement suivi d'un .

substr Le texte définissant le substr macro doit être la sous-chaîne du premier
argument commençant à la position de caractère décalée de zéro spécifiée par le deuxième
argument. Le troisième argument, s'il est spécifié, doit être le nombre de caractères à
sélectionner; si non spécifié, les caractères du point de départ à la fin de
le premier argument deviendra le texte de définition. Ce ne sera pas une erreur de
spécifier un point de départ au-delà de la fin du premier argument et de la définition
le texte doit être nul. Ce sera une erreur de spécifier un argument contenant
caractères non numériques. Le comportement n'est pas spécifié si substr n'est pas
immédiatement suivi d'un .

syscmd La syscmd la macro doit interpréter son premier argument comme une ligne de commande shell. Les
le texte de définition doit être le résultat de la chaîne de cette commande. Le résultat de la chaîne
ne doit pas être réanalysé pour les macros lors de la définition du texte de définition. Aucune sortie
la redirection est effectuée par le m4 utilitaire. La valeur de l'état de sortie du
la commande peut être récupérée à l'aide de la Syval macro. Le comportement n'est pas spécifié si
syscmd n'est pas immédiatement suivi d'un .

Syval Le texte déterminant de la Syval macro doit être la valeur de sortie de l'utilitaire
invoqué en dernier lieu par le syscmd macro (sous forme de chaîne).

traceur La traceur la macro doit permettre le traçage des macros spécifiées en arguments,
ou, si aucun argument n'est spécifié, pour toutes les macros. La sortie de trace doit être
écrit à l'erreur standard dans un format non spécifié.

tracer La tracer la macro doit désactiver le traçage pour les macros spécifiées comme arguments,
ou, si aucun argument n'est spécifié, pour toutes les macros.

translit Le texte déterminant de la translit macro doit être le premier argument de chaque
caractère qui apparaît dans le deuxième argument remplacé par le correspondant
caractère du troisième argument. Si aucun caractère de remplacement n'est spécifié pour
un caractère source car le deuxième argument est plus long que le troisième
argument, ce caractère doit être supprimé du premier argument dans translit's
texte définissant. Le comportement n'est pas spécifié si le '−' le caractère apparaît dans
le deuxième ou le troisième argument ailleurs que sur le premier ou le dernier caractère. Les
le comportement n'est pas spécifié si le même caractère apparaît plus d'une fois dans le
deuxième argument. Le comportement n'est pas spécifié si translit n'est pas immédiatement
suivi d'un .

indéfinir La indéfinir macro supprimera toutes les définitions (y compris celles conservées en utilisant
le pushdef macro) des macros nommées par ses arguments. Le comportement est
non spécifié si indéfinir n'est pas immédiatement suivi d'un .

ne pas détourner La ne pas détourner la macro doit provoquer la sortie immédiate de tout texte dans les tampons temporaires
nommés comme arguments, ou tous les tampons temporaires si aucun argument n'est spécifié.
Les tampons peuvent être non détournés vers d'autres tampons temporaires. Ne détournera pas
supprimer le contenu du tampon temporaire. Le comportement n'est pas spécifié si un
L'argument contient des caractères non numériques.

EXIT STATUT

Les valeurs de sortie suivantes doivent être renvoyées :

0 Achèvement réussi.

>0 Une erreur s'est produite

Si la m4sortie macro est utilisée, la valeur de sortie peut être spécifiée par le fichier d'entrée.

CONSÉQUENCES OF LES ERREURS

Par défaut.

La Abonnement les sections informatif.

INSCRIPTION UTILISATION

La défn macro est utile pour renommer les macros, en particulier les macros intégrées.

Depuis que eval s'en remet à la norme ISO C, certaines opérations ont un comportement indéfini. Dans certaines
les implémentations, la division ou le reste par zéro provoquent un signal fatal, même si la division
se produit sur la branche court-circuitée de "&&" or "||". Toute opération qui déborde dans
l'arithmétique signée produit un comportement indéfini. De même, en utilisant le décalage opérateurs avec un
la quantité de décalage qui n'est pas positive et inférieure à la précision n'est pas définie, comme c'est le cas
décaler un nombre négatif vers la droite. Historiquement, toutes les implémentations n'obéissaient pas à C-
règles de priorité des langues : '~' ainsi que '!' étaient inférieurs à ceux '=='; '==' ainsi que '!=' n'étaient pas inférieurs
que «<»Et '|' n'était pas inférieur à '^'; l'utilisation libérale de "()" peut forcer le désiré
priorité même avec ces implémentations non conformes. De plus, certaines traditions
implémentations traitées '^' comme opérateur d'exponentiation, bien que la plupart des implémentations
maintenant utiliser "**" comme une extension à cet effet.

Lorsqu'une macro a été définie de manière multiple via le pushdef macro, il n'est pas précisé si
le Vous permet de définir macro ne modifiera que la définition la plus récente (comme si par popdef ainsi que
pushdef), ou remplacez toute la pile de définitions par une seule définition (comme si
by indéfinir ainsi que pushdef). Une application désirant un comportement particulier pour le Vous permet de définir
macro dans ce cas peut le redéfinir en conséquence.

Les applications doivent utiliser le mkstemp macro au lieu de l'obsolescent fairetemp macro pour
création de fichiers temporaires.

EXEMPLES

Si le fichier m4src contient les lignes :

La Plus-value of 'VER' is "VER".
ifdef(`VER', ``VER'' is défini à be VER., VER is ne sauraient défini.)
sinon(VER, 1, ``VER'' is 'VER'.)
sinon(VER, 2, ``VER'' is 'VER'., ``VER'' is ne sauraient 2.)
fin

puis la commande

m4 m4src

ou la commande :

m4 −U VER m4src

produit la sortie:

La Plus-value of VER is "VER".
VER is ne sauraient Défini.

VER n'est pas 2.
fin

La commande:

m4 -D VER m4src

produit la sortie:

La Plus-value of VER is "".
VER is défini à be .

VER n'est pas 2.
fin

La commande:

m4 -D VOIR=1 m4src

produit la sortie:

La Plus-value of VER is "1".
VER is défini à be 1.
VER is 1.
VER is ne sauraient 2.
fin

La commande:

m4 -D VOIR=2 m4src

produit la sortie:

La Plus-value of VER is "2".
VER is défini à be 2.

VER est 2.
fin

RAISONNEMENT

Comportement historique basé sur le système V traité "${" dans une définition de macro comme deux littéraux
personnages. Cependant, cette séquence n'est pas spécifiée afin que les implémentations puissent offrir
des extensions telles que "${11}" signifiant le onzième paramètre de position. Les macros peuvent toujours être
défini avec des utilisations appropriées de guillemets imbriqués pour aboutir à un littéral "${" dans la sortie
après une nouvelle analyse, les guillemets imbriqués sont supprimés.

Dans le translit comportement intégré et historique basé sur le système V traité '−' comme un littéral ; GNOU
le comportement le traite comme une plage. Cette version de la norme autorise l'un ou l'autre comportement.

FUTUR DIRECTIONS

Aucun.

Utilisez m4posix en ligne en utilisant les services onworks.net