m4posix - Online în cloud

PROGRAM:

NUME

m4 — macroprocesor

REZUMAT

m4 [−s] [−D nume[=val]]... [−U nume]... fişier...

DESCRIERE

m4 utilitarul este un macroprocesor care va citi unul sau mai multe fișiere text și le va procesa
conform instrucțiunilor macro incluse și scrieți rezultatele în rezultatul standard.

OPŢIUNI

m4 utilitatea trebuie să se conformeze volumului Definiții de bază din POSIX.1-2008, Secțiune 12.2,
Utilitate Sintaxă Instrucțiuni, cu excepția faptului că ordinul −D și −U opțiunile vor fi
semnificative, iar opțiunile pot fi intercalate cu operanzi.

Următoarele opțiuni vor fi acceptate:

−s Activați ieșirea de sincronizare a liniei pentru c99 faza de preprocesor (adică
#linia directive).

−D nume[=val]
Defini nume la val sau a nul dacă =val este omis.

−U nume Nedefinit nume.

OPERANDE

Următorul operand va fi suportat:

fişier O cale a unui fișier text care urmează să fie procesat. Daca nu fişier este dat, sau dacă este '-',
se citește intrarea standard.

Stdin

Intrarea standard va fi un fișier text care este utilizat dacă nu fişier operand este dat, sau dacă acesta
is '-'.

INTRARE DOSARE

Fișierul de intrare numit de fişier operandul va fi un fișier text.

MEDIUL VARIABILE

Următoarele variabile de mediu vor afecta execuția m4:

LIMBA Furnizați o valoare implicită pentru variabilele de internaționalizare care sunt nesetate sau
nul. (A se vedea volumul Definiții de bază din POSIX.1‐2008, Secțiune 8.2,
Internaționalizare Variabile pentru prioritatea internaţionalizării
variabile utilizate pentru a determina valorile categoriilor locale.)

LC_ALL Dacă este setată la o valoare șir nevid, suprascrieți valorile tuturor celorlalte
variabile de internaţionalizare.

LC_CTYPE Determinați locația pentru interpretarea secvențelor de octeți de date text
ca caractere (de exemplu, caractere pe un singur octet, spre deosebire de caractere pe mai mulți octeți în
argumente și fișiere de intrare).

LC_MESSAGES
Determinați locația care ar trebui utilizată pentru a afecta formatul și conținutul
mesaje de diagnostic scrise la eroare standard.

NLSPATH Determinați locația cataloagelor de mesaje pentru procesarea LC_MESSAGES.

ASINCRON EVENIMENTE

Implicit.

Stdout

Ieșirea standard va fi aceeași cu fișierele de intrare, după ce au fost procesate pentru macro
expansiune.

Stderr

Eroarea standard va fi utilizată pentru a afișa șiruri cu errprint trasare macro, macro
activată de către traceon macro, textul definit pentru macrocomenzi scrise de dumpdef macro, sau
pentru mesaje de diagnosticare.

REZULTATE DOSARE

Nici unul.

EXTENDED DESCRIERE

m4 utilitatea va compara fiecare jeton de la intrare cu setul de încorporate și
macrocomenzi definite de utilizator. Dacă jetonul se potrivește cu numele unei macrocomenzi, atunci jetonul va fi
înlocuit cu textul definitoriu al macrocomenzii, dacă există, și rescanat pentru a se potrivi nume de macrocomandă.
Odată ce nicio porțiune a jetonului nu se potrivește cu numele unei macrocomenzi, acesta va fi scris la standard
ieșire. Macro-urile pot avea argumente, caz în care argumentele vor fi substituite în
textul definitoriu înainte de a fi rescanat.

Apelurile macro au forma:

nume(arg1, arg2, ..., argn)

Numele macrocomenzilor vor consta din litere, cifre și caractere de subliniere, unde primul caracter
nu este o cifră. Tokenurile care nu au această formă nu vor fi tratate ca macrocomenzi.

Cererea trebuie să asigure că urmează imediat numele de
macroul. Dacă un simbol care se potrivește cu numele unei macrocomenzi nu este urmat de a
paranteză>, este tratată ca o utilizare a acelei macrocomenzi fără argumente.

Dacă un nume de macrocomandă este urmat de a , argumentele sale sunt
-jetoane separate între si potrivirea
paranteză>. Caracterele de spațiu alb fără ghilimele care preced fiecare argument vor fi ignorate.
Toate celelalte caractere, inclusiv caracterele cu spații albe din urmă, sunt păstrate.
caractere cuprinse între și personajele nu
delimitează argumentele.

Argumentele sunt definite pozițional și referite. Șirul „1 $” în textul definitoriu
se înlocuiește cu primul argument. Sistemele trebuie să susțină cel puțin nouă argumente;
numai primele nouă pot fi referite, folosind șirurile „1 $” la „9 $”, inclusiv. The
şir „0 $” este înlocuit cu numele macrocomenzii. Șirul „$ #” este înlocuit cu
numărul de argumente ca șir. Șirul „$*” este înlocuit cu o listă cu toate
argumente, separate prin personaje. Șirul „$@” este înlocuit cu o listă cu toate
a argumentelor separate prin caractere, iar fiecare argument este citat folosind
șiruri de ghilimele din stânga și dreapta curente. Șirul „${” produce un comportament nespecificat.

Dacă sunt furnizate mai puține argumente decât sunt în definiția macro, argumentele omise
sunt considerate nule. Nu este o eroare dacă sunt furnizate mai multe argumente decât sunt în
definiție macro.

Nu se acordă nicio semnificație specială caracterelor cuprinse între stânga și dreapta
șiruri de ghilimele, dar șirurile de ghilimele sunt ele însele eliminate. Implicit, stânga
șirul de ghilimele constă dintr-un accent grav (ghilimele din spate) și șirul de ghilimele din dreapta
constă dintr-un accent acut (ghilimele simple); vezi si pe schimbare cota macro.

Comentariile sunt scrise, dar nu sunt scanate pentru nume de macrocomenzi care se potrivesc; implicit, începutul-
șirul de comentarii este format din caracterul și șirul de comentariu final constă
de a . Vezi și changecom și dnl macro-uri.

m4 utilitarul va pune la dispoziție următoarele macrocomenzi încorporate. Ele pot fi redefinite,
dar odată ce se face acest lucru, sensul inițial se pierde. Valorile acestora vor fi nule, cu excepția cazului în care
altfel spus. În descrierile de mai jos, termenul definire a) Sport and Nutrition Awareness Day in Manasia Around XNUMX people from the rural commune Manasia have participated in a sports and healthy nutrition oriented activity in one of the community’s sports ready yards. This activity was meant to gather, mainly, middle-aged people from a Romanian rural community and teach them about the benefits that sports have on both their mental and physical health and on how sporting activities can be used to bring people from a community closer together. Three trainers were made available for this event, so that the participants would get the best possible experience physically and so that they could have the best access possible to correct information and good sports/nutrition practices. b) Sports Awareness Day in Poiana Țapului A group of young participants have taken part in sporting activities meant to teach them about sporting conduct, fairplay, and safe physical activities. The day culminated with a football match. se referă la valoarea de
macro-ul: al doilea argument al defini macro, printre altele. Cu excepția
primul argument la eval macro, toate argumentele numerice ale macrocomenzilor încorporate vor fi
interpretate ca valori zecimale. Valorile șirurilor produse ca text definitoriu al
decr, divnum, incr, index, len, și sysval macrocomenzile încorporate trebuie să fie sub forma unui
constantă zecimală așa cum este definită în limbajul C.

changecom changecom macro va seta șirurile de început-coment și sfârșit de comentariu. Cu nu
argumente, mecanismul de comentarii va fi dezactivat. Cu un singur non-null
argument, acel argument va deveni începutul-comentar și trebuie
devin șirul de comentariu final. Cu două argumente non-nule, primul argument
va deveni șirul de început-comentare și al doilea argument va deveni
șir de comentariu final. Comportamentul este nespecificat dacă este furnizat oricare dintre argumentele
dar nulă. Sistemele trebuie să accepte șiruri de comentarii de cel puțin cinci caractere.

schimbare cota
schimbare cota macro va seta șirurile de ghilimele de început și ghilimele de sfârșit. Cu nu
argumente, șirurile de ghilimele vor fi setate la valorile implicite (adică `').
Comportamentul este nespecificat dacă există un singur argument sau oricare dintre argumente este
nul. Cu două argumente non-nule, primul argument va deveni începutul
șirul de ghilimele și al doilea argument va deveni șirul de ghilimele de la capăt. Sisteme
trebuie să accepte șiruri de ghilimele de cel puțin cinci caractere.

decr Textul definitoriu al decr macro va fi primul argument decrementat de
1. Specificarea unui argument care conține orice non-numerică este o eroare
personaje. Comportamentul este nespecificat dacă decr nu este urmat imediat de
A .

defini Al doilea argument va deveni textul definitoriu al macrocomenzii al cărei nume este
primul argument. Nu este precizat dacă defini macro șterge toate anterioare
definițiile macrocomenzii numite de primul argument sau păstrează toate, cu excepția
definiția actuală a macro-ului. Comportamentul este nespecificat dacă defini nu este
urmat imediat de a .

defn Textul definitoriu al defn macro va fi definiția citată (folosind codul
șirurile de ghilimele curente) ale argumentelor sale. Comportamentul este nespecificat dacă defn
nu este urmată imediat de a .

abate m4 utilitatea menține nouă tampoane temporare, numerotate de la 1 la 9, inclusiv.
Când ultima intrare a fost procesată, orice ieșire care a fost plasată
în aceste buffer-uri vor fi scrise la ieșirea standard în ordinea numerică a tamponului.
abate macro va devia ieșirea viitoare către buffer-ul specificat de acesta
argument. Specificarea niciunui argument sau a unui argument de 0 va relua normalul
proces de ieșire. Ieșirea redirecționată către un flux cu un număr negativ trebuie să fie
aruncat. Comportamentul este definit de implementare dacă un număr de flux mai mare de 9
este specificat. Va fi o eroare să specificați un argument care conține orice non-
caractere numerice.

divnum Textul definitoriu al divnum macro va fi numărul ieșirii curente
curge ca un șir.

dnl dnl macro va cauza m4 pentru a renunța la toate caracterele introduse până la și inclusiv
urmatorul .

dumpdef dumpdef macro va scrie textul definit la eroare standard pentru fiecare dintre
macrocomenzi specificate ca argumente sau, dacă nu sunt specificate argumente, pentru toate
macro-uri.

errprint errprint macro își va scrie argumentele la eroare standard. Comportamentul este
nespecificat dacă errprint nu este urmată imediat de a .

eval eval macro va evalua primul argument ca o expresie aritmetică,
folosind aritmetica cu numere întregi cu semn cu precizie de cel puțin 32 de biți. Cel puțin cel
următorii operatori în limbajul C vor fi acceptați, cu prioritate,
asociativitatea și comportamentul descris în Secțiune 1.1.2.1, Aritmetică
Precizie și Operațiuni:

()
unar +
unar -
~

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

Sistemele trebuie să accepte numere octale și hexazecimale ca în standardul ISO C.
Al doilea argument, dacă este specificat, va stabili baza rezultatului; dacă
argumentul este gol sau nespecificat, valoarea implicită este 10. Comportamentul este nespecificat dacă
radixul se încadrează în afara intervalului de la 2 la 36, ​​inclusiv. Al treilea argument, dacă
specificat, setează numărul minim de cifre din rezultat. Comportamentul este
nespecificat dacă al treilea argument este mai mic decât zero. Va fi o eroare
specificați al doilea sau al treilea argument care conține orice caractere nenumerice. The
comportamentul este nespecificat dacă eval nu este urmată imediat de a
paranteză>.

ifdef Dacă primul argument la ifdef macro este definită, textul definitoriu va fi
al doilea argument. În caz contrar, textul definitoriu va fi al treilea argument,
dacă este specificat, sau șirul nul, dacă nu. Comportamentul este nespecificat dacă ifdef
nu este urmată imediat de a .

dacă nu dacă nu macro acceptă trei sau mai multe argumente. Dacă primele două argumente
comparați ca șiruri egale (după extinderea macro a ambelor argumente), definiția
textul va fi al treilea argument. Dacă primele două argumente nu se compară ca
șiruri egale și există trei argumente, textul definitoriu va fi nul. Dacă
primele două argumente nu se compară ca șiruri egale și există patru sau
cinci argumente, textul definitoriu va fi al patrulea argument. Dacă primele două
argumentele nu se compară ca șiruri egale și există șase sau mai multe argumente,
primele trei argumente vor fi eliminate și procesarea va reporni cu
argumentele rămase. Comportamentul este nespecificat dacă dacă nu nu este
urmat imediat de a .

include Textul definitoriu pentru include macro va fi conținutul fișierului numit
prin primul argument. Va fi o eroare dacă fișierul nu poate fi citit. The
comportamentul este nespecificat dacă include nu este urmată imediat de a
paranteză>.

incr Textul definitoriu al incr macro va fi primul argument incrementat cu
1. Specificarea unui argument care conține orice non-numerică este o eroare
personaje. Comportamentul este nespecificat dacă incr nu este urmat imediat de
A .

index Textul definitoriu al index macro trebuie să fie prima poziție a caracterului (ca a
șir) în primul argument unde începe un șir care se potrivește cu al doilea argument
(origine zero), sau −1 dacă al doilea argument nu apare. Comportamentul este
nespecificat dacă index nu este urmată imediat de a .

len Textul definitoriu al len macro va fi lungimea (ca un șir) a
primul argument. Comportamentul este nespecificat dacă len nu este urmată imediat
de către a .

m4exit Ieșiți din m4 utilitate. Dacă este specificat primul argument, acesta este ieșirea
cod. Valoarea implicită este zero. Specificarea unui argument va fi o eroare
care conțin orice caractere nenumerice.

m4wrap Primul argument va fi procesat când se atinge EOF. Dacă m4wrap macro
este folosit de mai multe ori, argumentele specificate vor fi procesate în ordine
în care m4wrap macro-urile au fost procesate. Comportamentul este nespecificat dacă m4wrap
nu este urmată imediat de a .

maketemp Textul definitoriu va fi primul argument, cu orice urmă 'X' caractere
înlocuit cu ID-ul procesului curent ca șir. Comportamentul este nespecificat
if maketemp nu este urmată imediat de a .

mkstemp Primul argument va fi luat ca șablon pentru crearea unui fișier gol, cu
adulmecător 'X' caractere înlocuite cu caractere din numele fișierului portabil
set de caractere. Comportamentul este nespecificat dacă primul argument nu se termină în
cel putin sase 'X' personaje. Dacă un fișier temporar este creat cu succes, atunci
textul definitoriu al macro-ului va fi numele noului fișier. ID-ul utilizatorului
al fișierului va fi setat la ID-ul de utilizator efectiv al procesului. ID-ul grupului
al fișierului va fi setat la ID-ul de grup al directorului părinte al fișierului sau la
ID-ul de grup efectiv al procesului. Biții de permisiuni de acces la fișiere sunt setați
astfel încât numai proprietarul poate citi și scrie fișierul, indiferent de
curent masca a procesului. Dacă un fișier nu a putut fi creat, textul definitoriu
al macrocomenzii va fi șirul gol. Comportamentul este nespecificat dacă mkstemp
nu este urmată imediat de a .

popdef popdef macro va șterge definiția curentă a argumentelor sale, înlocuind
acea definiție cu cea anterioară. Dacă nu există o definiție anterioară,
macro este nedefinită. Comportamentul este nespecificat dacă popdef nu este imediat
urmat de a .

pushdef pushdef macro va fi echivalentă cu defini macro cu excepția
că va păstra orice definiție curentă pentru o recuperare viitoare folosind
popdef macro. Comportamentul este nespecificat dacă pushdef nu este urmată imediat
de către a .

schimbare Textul definitoriu pentru schimbare macro va fi o listă separată prin virgulă
argumente cu excepția primului. Fiecare argument va fi citat folosind curentul
cite șiruri. Comportamentul este nespecificat dacă schimbare nu este imediat
urmat de a .

sinclude sinclude macro va fi echivalentă cu include macro, cu excepția faptului că acesta
nu va fi o eroare dacă fișierul este inaccesibil. Comportamentul este nespecificat
if sinclude nu este urmată imediat de a .

substr Textul definitoriu pentru substr macro va fi subșirul primului
argument care începe la poziția caracterului zero-offset specificată de al doilea
argument. Al treilea argument, dacă este specificat, va fi numărul de caractere pentru
Selectați; dacă nu sunt specificate, caracterele de la punctul de început până la sfârșitul
primul argument va deveni textul definitoriu. Nu va fi o eroare
specificați un punct de plecare dincolo de sfârșitul primului argument și al definiției
textul va fi nul. Specificarea unui argument care conține oricare ar fi o eroare
caractere nenumerice. Comportamentul este nespecificat dacă substr nu este
urmat imediat de a .

syscmd syscmd macro va interpreta primul argument ca o linie de comandă shell. The
textul definitoriu va fi rezultatul șirului respectivei comenzi. Rezultatul șirului
nu va fi rescanat pentru macrocomenzi în timpul setării textului definitoriu. Fără ieșire
redirecționarea va fi efectuată de către m4 utilitate. Valoarea stării de ieșire din
comanda poate fi preluată folosind sysval macro. Comportamentul este nespecificat dacă
syscmd nu este urmată imediat de a .

sysval Textul definitoriu al sysval macro va fi valoarea de ieșire a utilității
ultima invocata de catre syscmd macro (sub formă de șir).

traceon traceon macro va permite urmărirea macrocomenzilor specificate ca argumente,
sau, dacă nu sunt specificate argumente, pentru toate macrocomenzile. Ieșirea urmei trebuie să fie
scris la eroare standard într-un format nespecificat.

traceoff traceoff macro va dezactiva urmărirea pentru macrocomenzile specificate ca argumente,
sau, dacă nu sunt specificate argumente, pentru toate macrocomenzile.

translit Textul definitoriu al translit macro va fi primul argument cu fiecare
caracter care apare în al doilea argument înlocuit cu cel corespunzător
personaj din al treilea argument. Dacă nu este specificat niciun caracter de înlocuire pentru
un caracter sursă deoarece al doilea argument este mai lung decât al treilea
argument, acel caracter va fi șters din primul argument din translit's
text definitoriu. Comportamentul este nespecificat dacă '-' personajul apare în interior
al doilea sau al treilea argument oriunde în afară de primul sau ultimul caracter. The
comportamentul este nespecificat dacă același personaj apare de mai multe ori în
al doilea argument. Comportamentul este nespecificat dacă translit nu este imediat
urmat de a .

nedefinit nedefinit macro va șterge toate definițiile (inclusiv cele păstrate folosind
il pushdef macro) a macrocomenzilor numite prin argumentele sale. Comportamentul este
nespecificat dacă nedefinit nu este urmată imediat de a .

nedeturnată nedeturnată macro va determina ieșirea imediată a oricărui text în buffer-uri temporare
numite drept argumente sau toate bufferele temporare dacă nu sunt specificate argumente.
Tampoanele pot fi nedeviate în alte tampoane temporare. Nedeturnarea trebuie
aruncați conținutul tamponului temporar. Comportamentul este nespecificat dacă an
argumentul conține orice caractere nenumerice.

EXIT STAREA

Următoarele valori de ieșire vor fi returnate:

0 Finalizare cu succes.

>0 A apărut o eroare

În cazul în care m4exit este utilizată macro, valoarea de ieșire poate fi specificată de fișierul de intrare.

CONSECINȚE OF ERORI

Implicit.

următor secțiuni sunt informativ.

APLICARE UTILIZARE

defn macro este utilă pentru redenumirea macrocomenzilor, în special a celor încorporate.

Întrucât eval defera de standardul ISO C, unele operatii au un comportament nedefinit. În unele
implementările, împărțirea sau restul cu zero provoacă un semnal fatal, chiar dacă împărțirea
apare pe ramura scurtcircuitată a „&&” or "||". Orice operațiune care se revarsă
aritmetica semnată produce un comportament nedefinit. La fel, folosind schimbare operatori cu a
valoarea deplasării care nu este pozitivă și mai mică decât precizia este nedefinită, așa cum este
deplasarea unui număr negativ la dreapta. Din punct de vedere istoric, nu toate implementările au respectat C-
reguli de prioritate a limbii: '~' și '!' au fost mai mici decât '=='; '==' și '!=' nu erau mai jos
decât „<”Şi '|' nu era mai mică decât '^'; folosirea liberală a "()" poate forța doritul
prioritate chiar și cu aceste implementări neconforme. În plus, unele tradiționale
implementari tratate '^' ca operator de exponențiere, deși majoritatea implementărilor
acum folosiți "**" ca o extensie în acest scop.

Când o macrocomandă a fost definită prin multiplicare prin intermediul pushdef macro, nu este specificat dacă
il defini macro va modifica doar cea mai recentă definiție (ca și cum prin popdef și
pushdef), sau înlocuiți întregul teanc de definiții cu o singură definiție (ca și cum
by nedefinit și pushdef). O aplicație care dorește un comportament special pentru defini
macro în acest caz o poate redefini în consecință.

Aplicațiile ar trebui să folosească mkstemp macro în loc de învechit maketemp macro pentru
crearea de fișiere temporare.

EXEMPLE

Dacă dosarul m4src contine liniile:

valoare of `VER' is „VER”.
ifdef(`VER', ``VER'' is definit la be VER., VER is nu definit.)
ifelse(VER, 1, ``VER'' is „VER”.)
ifelse(VER, 2, ``VER'' is `VER'., ``VER'' is nu 2.)
capăt

apoi comanda

m4 m4src

sau comanda:

m4 −U VER m4src

produce rezultatul:

valoare of VER is „VER”.
VER is nu definit.

VER nu este 2.
capăt

Comanda:

m4 −D VER m4src

produce rezultatul:

valoare of VER is "".
VER is definit la be .

VER nu este 2.
capăt

Comanda:

m4 −D VER=1 m4src

produce rezultatul:

valoare of VER is „1”.
VER is definit la be 1.
VER is 1.
VER is nu 2.
capăt

Comanda:

m4 −D VER=2 m4src

produce rezultatul:

valoare of VER is „2”.
VER is definit la be 2.

VER este 2.
capăt

FUNDAMENTARE

Comportament istoric bazat pe sistemul V tratat „${” într-o definiție macro ca două literale
personaje. Cu toate acestea, această secvență este lăsată nespecificată, astfel încât implementările să poată oferi
extensii precum „${11}” adică al unsprezecelea parametru pozițional. Macro-urile mai pot fi
definit cu utilizări adecvate de ghilimele imbricate pentru a rezulta într-un literal „${” în ieșire
după rescanare elimină ghilimele imbricate.

În translit încorporat, comportament istoric bazat pe System V tratat '-' ca un literal; GNU
comportamentul îl tratează ca pe un interval. Această versiune a standardului permite ambele comportamente.

VIITOR INSTRUCTIUNI

Nici unul.

Utilizați m4posix online folosind serviciile onworks.net