m4posix - Online in de cloud

PROGRAMMA:

NAAM

m4 — macroprocessor

KORTE INHOUD

m4 [s] [D naam[=golf]]... [U naam]... filet...

PRODUCTBESCHRIJVING

De m4 utility is een macroprocessor die een of meer tekstbestanden zal lezen en verwerken
volgens hun meegeleverde macro-statements, en schrijf de resultaten naar de standaarduitvoer.

OPTIES

De m4 hulpprogramma zal voldoen aan het Base Definitions-volume van POSIX.1‐2008, sectie 12.2,
utility Syntaxis Richtlijnen, behalve dat de volgorde van de D en U opties zijn:
significant, en opties kunnen worden afgewisseld met operanden.

De volgende opties worden ondersteund:

s Lijnsynchronisatie-uitgang inschakelen voor de c99 preprocessorfase (dat wil zeggen,
#lijn richtlijnen).

D naam[=golf]
Definiëren van naam naar golf of naar null als =golf is weggelaten.

U naam Ondefinieer naam.

OPERANDEN

De volgende operand wordt ondersteund:

filet Een padnaam van een tekstbestand dat moet worden verwerkt. Als Nee filet wordt gegeven, of als het is '−',
de standaardinvoer wordt gelezen.

STDIN

De standaardinvoer is een tekstbestand dat wordt gebruikt als er geen filet operand wordt gegeven, of als het
is '−'.

INVOER FILES

Het invoerbestand genoemd door de filet operand zal een tekstbestand zijn.

MILIEU VARIABELEN

De volgende omgevingsvariabelen zijn van invloed op de uitvoering van: m4:

TAAL Geef een standaardwaarde op voor de internationaliseringsvariabelen die niet zijn ingesteld of
nul. (Zie het volume Basisdefinities van POSIX.1‐2008, sectie 8.2,
internationalisering Variabelen voor de prioriteit van internationalisering
variabelen die worden gebruikt om de waarden van landinstellingen te bepalen.)

LC_ALL Indien ingesteld op een niet-lege tekenreekswaarde, overschrijf dan de waarden van alle andere
internationaliseringsvariabelen.

LC_CTYPE Bepaal de landinstelling voor de interpretatie van reeksen bytes tekstgegevens
als tekens (bijvoorbeeld single-byte in plaats van multi-byte tekens in
argumenten en invoerbestanden).

LC_MESSAGES
Bepaal de landinstelling die moet worden gebruikt om het formaat en de inhoud van te beïnvloeden
diagnostische berichten geschreven naar standaardfout.

NLSPAT Bepaal de locatie van berichtencatalogi voor de verwerking van: LC_MESSAGES.

ASYNCHROON EVENEMENTEN

Standaard.

STDOUT

De standaarduitvoer zal hetzelfde zijn als de invoerbestanden, na te zijn verwerkt voor macro
uitbreiding.

STDERR

De standaardfout wordt gebruikt om strings weer te geven met de foutje macro, macro-tracering
ingeschakeld door de traceren macro, de gedefinieerde tekst voor macro's geschreven door de dumpdef macro, of
voor diagnostische berichten.

OUTPUT FILES

Geen.

UITGEBREID PRODUCTBESCHRIJVING

De m4 hulpprogramma vergelijkt elk token van de invoer met de set ingebouwde en
door de gebruiker gedefinieerde macro's. Als het token overeenkomt met de naam van een macro, wordt het token
vervangen door de definiërende tekst van de macro, indien aanwezig, en opnieuw gescand op overeenkomende macronamen.
Zodra geen enkel deel van het token overeenkomt met de naam van een macro, wordt het naar de standaard geschreven
uitvoer. Macro's kunnen argumenten hebben, in welk geval de argumenten worden vervangen door:
de definiërende tekst voordat deze opnieuw wordt gescand.

Macro-oproepen hebben de vorm:

naam(arg1, arg2, ..., arg)

Macronamen bestaan ​​uit letters, cijfers en onderstrepingstekens, waarbij het eerste teken
is geen cijfer. Tokens die niet van deze vorm zijn, worden niet als macro's behandeld.

De aanvraag zorgt ervoor dat de volgt onmiddellijk de naam van
de macro. Als een token dat overeenkomt met de naam van een macro niet wordt gevolgd door a
haakjes>, wordt het behandeld als een gebruik van die macro zonder argumenten.

Als een macronaam wordt gevolgd door a , zijn argumenten zijn de
-gescheiden tokens tussen de en de bijpassende
haakjes>. Witruimtetekens zonder aanhalingstekens die aan elk argument voorafgaan, worden genegeerd.
Alle andere tekens, inclusief de volgende witruimtetekens, blijven behouden.
tekens tussen en karakters niet
argumenten afbakenen.

Argumenten worden positioneel gedefinieerd en er wordt naar verwezen. De snaar '$ 1' in de bepalende tekst
wordt vervangen door het eerste argument. Systemen moeten ten minste negen argumenten ondersteunen;
er kan alleen naar de eerste negen worden verwezen, met behulp van de tekenreeksen '$ 1' naar '$ 9', inclusief. De
snaar '$ 0' wordt vervangen door de naam van de macro. De snaar '$ #' wordt vervangen door de
aantal argumenten als een string. De snaar "$*" wordt vervangen door een lijst van alle
argumenten, gescheiden door karakters. De snaar "$@" wordt vervangen door een lijst van alle
van de argumenten gescheiden door karakters, en elk argument wordt geciteerd met de
huidige links en rechts aanhalingstekens. De snaar "${" produceert ongespecificeerd gedrag.

Als er minder argumenten zijn opgegeven dan in de macrodefinitie staan, worden de weggelaten argumenten
worden als nul beschouwd. Het is geen fout als er meer argumenten worden opgegeven dan in de
macro definitie.

Er wordt geen speciale betekenis gegeven aan tekens die tussen links en rechts overeenkomen
aanhalingstekens, maar de aanhalingstekens worden zelf weggegooid. Standaard is de linker
quote string bestaat uit een grave accent (backquote) en de juiste quote string
bestaat uit een acuut accent (enkel aanhalingsteken); zie ook de verandercitaat macro.

Opmerkingen worden geschreven maar niet gescand op overeenkomende macronamen; standaard is de begin-
commentaarreeks bestaat uit de teken en de tekenreeks voor het eindcommentaar bestaat uit
van een . Zie ook de verander com en dnl macro's.

De m4 hulpprogramma zal de volgende ingebouwde macro's beschikbaar stellen. Ze kunnen opnieuw worden gedefinieerd,
maar als dit eenmaal is gedaan, gaat de oorspronkelijke betekenis verloren. Hun waarden zijn nul tenzij
anders aangegeven. In de onderstaande beschrijvingen wordt de term het definiëren van tekst verwijst naar de waarde van
de macro: het tweede argument voor de bepalen onder andere macro. Behalve de
eerste argument tegen de eval macro, alle numerieke argumenten voor ingebouwde macro's zijn:
geïnterpreteerd als decimale waarden. De tekenreekswaarden geproduceerd als de definiërende tekst van de
afl, div, incl, index, len en systeem ingebouwde macro's hebben de vorm van a
decimale constante zoals gedefinieerd in de C-taal.

verander com De verander com macro stelt de begin-opmerking en eind-opmerking strings in. Zonder
argumenten, wordt het commentaarmechanisme uitgeschakeld. Met een enkele niet-null
argument, wordt dat argument de begin-opmerking en de zullen
wordt de tekenreeks voor het einde van de opmerking. Met twee niet-null-argumenten, het eerste argument
wordt de tekenreeks voor het begin-opmerking en het tweede argument wordt de
eindcommentaar string. Het gedrag is niet gespecificeerd als een van de argumenten wordt opgegeven
maar nul. Systemen moeten commentaarreeksen van ten minste vijf tekens ondersteunen.

verandercitaat
De verandercitaat macro stelt de begin-aanhalingstekens en eind-aanhalingstekens in. Zonder
argumenten, worden de aanhalingstekens ingesteld op de standaardwaarden (dat wil zeggen `').
Het gedrag is niet gespecificeerd als er een enkel argument is of als een van beide argumenten is
nul. Met twee niet-null-argumenten wordt het eerste argument het begin-
quote string en het tweede argument wordt de end-quote string. Systemen
ondersteunt aanhalingstekens van ten minste vijf tekens.

afl De bepalende tekst van de afl macro zal zijn eerste argument zijn, verminderd met
1. Het is een fout om een ​​argument op te geven dat een niet-numerieke
karakters. Het gedrag is niet gespecificeerd als: afl wordt niet onmiddellijk gevolgd door
een .

bepalen Het tweede argument wordt de definiërende tekst van de macro waarvan de naam is
het eerste argument. Het is niet gespecificeerd of de bepalen macro verwijdert alle eerdere
definities van de macro genoemd door zijn eerste argument of behoudt alles behalve de
huidige definitie van de macro. Het gedrag is niet gespecificeerd als: bepalen is niet
onmiddellijk gevolgd door een .

def De bepalende tekst van de def macro zal de geciteerde definitie zijn (met behulp van de
huidige aanhalingstekens) van zijn argumenten. Het gedrag is niet gespecificeerd als: def
wordt niet onmiddellijk gevolgd door een .

afleiden De m4 hulpprogramma onderhoudt negen tijdelijke buffers, genummerd van 1 t/m 9, inclusief.
Wanneer de laatste invoer is verwerkt, wordt elke uitvoer die is geplaatst
in deze buffers worden in buffer-numerieke volgorde naar de standaarduitvoer geschreven.
De afleiden macro zal toekomstige output omleiden naar de buffer gespecificeerd door zijn
argument. Het specificeren van geen argument of een argument van 0 zal de normale hervatten
output proces. Uitgang die wordt omgeleid naar een stream met een negatief getal moet zijn
weggegooid. Gedrag wordt door de implementatie bepaald als een streamnummer groter is dan 9
is gespecificeerd. Het is een fout om een ​​argument op te geven dat een niet-
numerieke tekens.

div De bepalende tekst van de div macro is het nummer van de huidige output
streamen als een string.

dnl De dnl macro zal veroorzaken m4 om alle ingevoerde karakters te verwijderen tot en met
de volgende .

dumpdef De dumpdef macro schrijft de gedefinieerde tekst naar de standaardfout voor elk van de
macro's opgegeven als argumenten, of, als er geen argumenten zijn opgegeven, voor alle
macro's.

foutje De foutje macro schrijft zijn argumenten naar de standaardfout. Het gedrag is
niet gespecificeerd als foutje wordt niet onmiddellijk gevolgd door een .

eval De eval macro zal zijn eerste argument evalueren als een rekenkundige uitdrukking,
met behulp van getekende integer-berekeningen met een nauwkeurigheid van ten minste 32 bits. tenminste de
volgende C-taal operators worden ondersteund, met voorrang,
associativiteit en gedrag zoals beschreven in sectie 1.1.2.1, Rekenkunde
precisie en Operations:

()
unaire +
unaire -
~

!
binair *
/
%
binair +
binair
<<
>>
<
<=
>
>=
==
!=
binair &
^
|
&&
||

Systemen moeten octale en hexadecimale getallen ondersteunen, zoals in de ISO C-norm.
Het tweede argument, indien gespecificeerd, zal de radix voor het resultaat bepalen; als de
argument is leeg of niet gespecificeerd, de standaardwaarde is 10. Gedrag is niet gespecificeerd als
de radix valt buiten het bereik van 2 tot en met 36. Het derde argument, als
opgegeven, stelt het minimum aantal cijfers in het resultaat in. Gedrag is
niet gespecificeerd als het derde argument kleiner is dan nul. Het zal een fout zijn om
specificeer het tweede of derde argument dat niet-numerieke tekens bevat. De
gedrag is niet gespecificeerd als: eval wordt niet onmiddellijk gevolgd door een
haakjes>.

alsdef Als het eerste argument voor de alsdef macro is gedefinieerd, wordt de definiërende tekst
het tweede argument. Anders zal de definiërende tekst het derde argument zijn,
indien opgegeven, of de null-tekenreeks, indien niet. Het gedrag is niet gespecificeerd als: alsdef
wordt niet onmiddellijk gevolgd door een .

anders De anders macro heeft drie of meer argumenten nodig. Als de eerste twee argumenten
vergelijk als gelijke strings (na macro-uitbreiding van beide argumenten), de bepalende
tekst is het derde argument. Als de eerste twee argumenten niet te vergelijken zijn als
gelijke strings en er zijn drie argumenten, de definiërende tekst zal null zijn. Indien
de eerste twee argumenten zijn niet vergelijkbaar als gelijke strings en er zijn vier of
vijf argumenten, zal de bepalende tekst het vierde argument zijn. Als de eerste twee
argumenten zijn niet vergelijkbaar als gelijke strings en er zijn zes of meer argumenten,
de eerste drie argumenten worden weggegooid en de verwerking wordt opnieuw gestart met
de overige argumenten. Het gedrag is niet gespecificeerd als: anders is niet
onmiddellijk gevolgd door een .

omvatten De bepalende tekst voor de omvatten macro zal de inhoud zijn van het bestand met de naam
door het eerste argument. Het is een fout als het bestand niet kan worden gelezen. De
gedrag is niet gespecificeerd als: omvatten wordt niet onmiddellijk gevolgd door een
haakjes>.

incl De bepalende tekst van de incl macro zal het eerste argument zijn, vermeerderd met
1. Het is een fout om een ​​argument op te geven dat een niet-numerieke
karakters. Het gedrag is niet gespecificeerd als: incl wordt niet onmiddellijk gevolgd door
een .

index De bepalende tekst van de index macro zal de eerste tekenpositie zijn (als a
string) in het eerste argument waar een string die overeenkomt met het tweede argument begint
(oorsprong nul), of -1 als het tweede argument niet voorkomt. Het gedrag is
niet gespecificeerd als index wordt niet onmiddellijk gevolgd door een .

len De bepalende tekst van de len macro is de lengte (als een string) van de
eerste argument. Het gedrag is niet gespecificeerd als: len wordt niet meteen gevolgd
door een .

m4uitgang Sluit af van de m4 nut. Als het eerste argument is opgegeven, is dit de exit
code. De standaardwaarde is nul. Het zal een fout zijn om een ​​argument op te geven
met niet-numerieke tekens.

m4wrap Het eerste argument wordt verwerkt wanneer EOF is bereikt. Als de m4wrap macro
meerdere keren wordt gebruikt, worden de opgegeven argumenten in de volgorde verwerkt
waarin de m4wrap macro's zijn verwerkt. Het gedrag is niet gespecificeerd als: m4wrap
wordt niet onmiddellijk gevolgd door een .

maaktemp De definiërende tekst zal het eerste argument zijn, met eventuele trailing 'X' tekens
vervangen door de huidige proces-ID als een tekenreeks. Het gedrag is niet gespecificeerd
if maaktemp wordt niet onmiddellijk gevolgd door een .

mktemp Het eerste argument moet worden genomen als een sjabloon voor het maken van een leeg bestand, met
trailing 'X' tekens vervangen door tekens uit de draagbare bestandsnaam
karakterset. Het gedrag is niet gespecificeerd als het eerste argument niet eindigt op
ten minste zes 'X' karakters. Als een tijdelijk bestand is aangemaakt, dan:
de definiërende tekst van de macro is de naam van het nieuwe bestand. De gebruikers-ID
van het bestand wordt ingesteld op de effectieve gebruikers-ID van het proces. De groeps-ID
van het bestand wordt ingesteld op de groeps-ID van de bovenliggende map van het bestand of op
de effectieve groeps-ID van het proces. De machtigingsbits voor bestandstoegang zijn ingesteld
zodat alleen de eigenaar het bestand zowel kan lezen als schrijven, ongeacht de
actueel umasker van het proces. Als een bestand niet kon worden gemaakt, wordt de definiërende tekst
van de macro zal de lege string zijn. Het gedrag is niet gespecificeerd als: mktemp
wordt niet onmiddellijk gevolgd door een .

popdef De popdef macro zal de huidige definitie van zijn argumenten verwijderen, ter vervanging van
die definitie met de vorige. Als er geen eerdere definitie is, is de
macro is niet gedefinieerd. Het gedrag is niet gespecificeerd als: popdef is niet meteen
gevolgd door een .

pushdef De pushdef macro is gelijk aan de bepalen macro met uitzondering
dat het elke huidige definitie bewaart voor later gebruik met behulp van de
popdef macro. Het gedrag is niet gespecificeerd als: pushdef wordt niet meteen gevolgd
door een .

verschuiving De bepalende tekst voor de verschuiving macro is een door komma's gescheiden lijst van zijn
argumenten behalve de eerste. Elk argument wordt geciteerd met de current
strings citeren. Het gedrag is niet gespecificeerd als: verschuiving is niet meteen
gevolgd door een .

afzonderen De afzonderen macro is gelijk aan de omvatten macro, behalve dat het
mag geen fout zijn als het bestand ontoegankelijk is. Het gedrag is niet gespecificeerd
if afzonderen wordt niet onmiddellijk gevolgd door een .

substr De bepalende tekst voor de substr macro is de substring van de eerste
argument beginnend bij de nul-offset tekenpositie gespecificeerd door de tweede
argument. Het derde argument, indien gespecificeerd, is het aantal tekens dat moet worden gebruikt
selecteer; indien niet gespecificeerd, de tekens van het beginpunt tot het einde van
het eerste argument wordt de bepalende tekst. Het mag geen fout zijn om
specificeer een startpunt voorbij het einde van het eerste argument en de definiërende
tekst is nul. Het is een fout om een ​​argument op te geven dat om het even welke bevat
niet-numerieke tekens. Het gedrag is niet gespecificeerd als: substr is niet
onmiddellijk gevolgd door een .

systeem De systeem macro zal zijn eerste argument interpreteren als een shell-opdrachtregel. De
het definiëren van tekst is het tekenreeksresultaat van dat commando. Het tekenreeksresultaat
worden niet opnieuw gescand op macro's tijdens het instellen van de definiërende tekst. Geen uitvoer
omleiding wordt uitgevoerd door de m4 nut. De uitgangsstatuswaarde van de
commando kan worden opgehaald met de systeem macro. Het gedrag is niet gespecificeerd als:
systeem wordt niet onmiddellijk gevolgd door een .

systeem De bepalende tekst van de systeem macro is de exit-waarde van het hulpprogramma
laatst ingeroepen door de systeem macro (als een string).

traceren De traceren macro zal tracering mogelijk maken voor de macro's die zijn gespecificeerd als argumenten,
of, als er geen argumenten zijn opgegeven, voor alle macro's. De traceeruitvoer zal zijn:
geschreven naar standaardfout in een niet-gespecificeerd formaat.

trace-off De trace-off macro schakelt tracering uit voor de macro's die zijn opgegeven als argumenten,
of, als er geen argumenten zijn opgegeven, voor alle macro's.

oversteken De bepalende tekst van de oversteken macro zal het eerste argument zijn bij elke
teken dat voorkomt in het tweede argument vervangen door het corresponderende
karakter uit het derde argument. Als er geen vervangend teken is opgegeven voor
een bronkarakter omdat het tweede argument langer is dan het derde
argument, wordt dat teken verwijderd uit het eerste argument in oversteken's
tekst definiëren. Het gedrag is niet gespecificeerd als de '−' karakter verschijnt binnen
het tweede of derde argument ergens anders dan het eerste of laatste teken. De
gedrag is niet gespecificeerd als hetzelfde teken meer dan eens voorkomt in de
tweede argument. Het gedrag is niet gespecificeerd als: oversteken is niet meteen
gevolgd door een .

ondefinieer De ondefinieer macro verwijdert alle definities (inclusief de definities die zijn bewaard met
de pushdef macro) van de macro's genoemd door zijn argumenten. Het gedrag is
niet gespecificeerd als ondefinieer wordt niet onmiddellijk gevolgd door een .

ongedaan maken De ongedaan maken macro zal onmiddellijke uitvoer van tekst in tijdelijke buffers veroorzaken
genoemd als argumenten, of alle tijdelijke buffers als er geen argumenten zijn opgegeven.
Buffers kunnen niet worden omgezet in andere tijdelijke buffers. Undiverting zal
gooi de inhoud van de tijdelijke buffer weg. Het gedrag is niet gespecificeerd als een
argument geen niet-numerieke tekens bevat.

EXIT STATUS

De volgende exit-waarden worden geretourneerd:

0 Succesvolle afronding.

>0 Er is een fout opgetreden

Indien de m4uitgang macro wordt gebruikt, kan de exit-waarde worden gespecificeerd door het invoerbestand.

GEVOLGEN OF FOUTEN

Standaard.

De volgend secties zijn informatief.

TOEPASSING GEBRUIK

De def macro is handig voor het hernoemen van macro's, vooral ingebouwde.

Sinds eval afwijkt van de ISO C-norm, hebben sommige bewerkingen ongedefinieerd gedrag. In bepaalde
implementaties, deling of rest door nul veroorzaken een fataal signaal, zelfs als de deling
komt voor op de kortgesloten tak van "&&" or "||". Elke operatie die overloopt in
getekende rekenkunde produceert ongedefinieerd gedrag. Evenzo, met behulp van de verschuiving operators met a
verschuivingshoeveelheid die niet positief is en kleiner dan de precisie is ongedefinieerd, zoals is
een negatief getal naar rechts verschuiven. Historisch gezien gehoorzaamden niet alle implementaties C-
taalvoorrangsregels: '~' en '!' lager dan waren '=='; '==' en '!=' waren niet lager
neem contact '<'und '|' was niet lager dan '^'; het liberale gebruik van "()" kan het gewenste forceren
zelfs bij deze niet-conforme implementaties prioriteit. Verder sommige traditionele
implementaties behandeld '^' als exponentiatie-operator, hoewel de meeste implementaties
nu gebruiken "**" als extensie hiervoor.

Wanneer een macro meervoudig is gedefinieerd via de pushdef macro, het is niet gespecificeerd of
de bepalen macro zal alleen de meest recente definitie wijzigen (alsof door popdef en
pushdef), of vervang de hele stapel definities door een enkele definitie (alsof
by ondefinieer en pushdef). Een applicatie die specifiek gedrag wenst voor de bepalen
macro kan het in dit geval dienovereenkomstig opnieuw definiëren.

Toepassingen moeten gebruik maken van de mktemp macro in plaats van het verouderde maaktemp macro voor
tijdelijke bestanden maken.

Voorbeelden

Als het bestand m4src bevat de regels:

De waarde of `VER' is "VER".
ifdef(`VER', ``VER'' is gedefinieerd naar be VER., VER is niet bepaald.)
anders (VER, 1, ``VER'' is `VER'.)
anders (VER, 2, ``VER'' is `VER'., ``VER'' is niet 2.)
einde

dan het commando

m4 m4src

of het commando:

m4 U VER m4src

produceert de uitvoer:

De waarde of VER is "VER".
VER is niet gedefinieerd.

VER is niet 2.
einde

Het bevel:

m4 D VER m4src

produceert de uitvoer:

De waarde of VER is "".
VER is gedefinieerd naar be .

VER is niet 2.
einde

Het bevel:

m4 D ZIE=1 m4src

produceert de uitvoer:

De waarde of VER is "1/XNUMX/XNUMX".
VER is gedefinieerd naar be 1.
VER is 1.
VER is niet 2.
einde

Het bevel:

m4 D ZIE=2 m4src

produceert de uitvoer:

De waarde of VER is "2/XNUMX/XNUMX".
VER is gedefinieerd naar be 2.

VER is 2.
einde

BEWEEGREDENEN

Historisch systeem V-gebaseerd gedrag behandeld "${" in een macrodefinitie als twee letterlijke
karakters. Deze volgorde wordt echter niet gespecificeerd, zodat implementaties kunnen bieden:
extensies zoals "${11}" wat de elfde positionele parameter betekent. Macro's kunnen nog steeds worden
gedefinieerd met het juiste gebruik van geneste aanhalingstekens om te resulteren in een letterlijke "${" in de uitvoer
na opnieuw scannen worden de geneste aanhalingstekens verwijderd.

In het oversteken ingebouwd, historisch systeem V-gebaseerd gedrag behandeld '−' als een letterlijke; GNU
gedrag behandelt het als een bereik. Deze versie van de standaard staat beide gedragingen toe.

TOEKOMST ROUTEBESCHRIJVING

Geen.

Gebruik m4posix online met onworks.net-services