m4posix - Online nel cloud

PROGRAMMA:

NOME

m4 — macroprocessore

SINOSSI

m4 [-s] [−D Nome[=val]]... [-U Nome]... filetto...

DESCRIZIONE

I m4 utility è un processore di macro che legge uno o più file di testo, li elabora
in base alle istruzioni macro incluse e scrivere i risultati nell'output standard.

VERSIONI

I m4 l'utilità deve essere conforme al volume delle definizioni di base di POSIX.1‐2008, Sezione 12.2,
Utilità Sintassi Linee Guida, salvo che l'ordine del −D ed -U le opzioni devono essere
significativo e le opzioni possono essere intervallate da operandi.

Sono supportate le seguenti opzioni:

-s Abilita l'uscita di sincronizzazione di linea per il c99 fase del preprocessore (ovvero
#linea direttive).

−D Nome[=val]
Define Nome a val o null se =val è omesso.

-U Nome indefinito Nome.

OPERANDI

Il seguente operando deve essere supportato:

filetto Un percorso di un file di testo da elaborare. se no filetto è dato, o se lo è '-',
lo standard input deve essere letto.

STDIN

Lo standard input deve essere un file di testo che viene utilizzato se no filetto l'operando è dato, o se è
is '-'.

INGRESSO FILE

Il file di input denominato da filetto l'operando deve essere un file di testo.

AMBIENTE VARIABILI

Le seguenti variabili d'ambiente influiranno sull'esecuzione di m4:

LUNGO Fornire un valore predefinito per le variabili di internazionalizzazione non impostate o
nullo. (Vedi il volume Definizioni di base di POSIX.1-2008, Sezione 8.2,
Internazionalizzazione Variabili per il primato dell'internazionalizzazione
variabili utilizzate per determinare i valori delle categorie locali.)

LC_TUTTI Se impostato su un valore di stringa non vuoto, sovrascrive i valori di tutti gli altri
variabili di internazionalizzazione.

LC_CTYPE Determinare la localizzazione per l'interpretazione di sequenze di byte di dati di testo
come caratteri (ad esempio, caratteri a byte singolo anziché caratteri multibyte in
argomenti e file di input).

LC_MESSAGGI
Determinare la localizzazione che dovrebbe essere usata per influenzare il formato e il contenuto di
messaggi di diagnostica scritti nell'errore standard.

NLSPATH Determinare la posizione dei cataloghi dei messaggi per l'elaborazione di LC_MESSAGGI.

ASINCRONO EVENTI

Predefinito.

STDOUT

Lo standard output deve essere lo stesso dei file di input, dopo essere stato elaborato per la macro
espansione.

Stderr

L'errore standard deve essere utilizzato per visualizzare le stringhe con il errore di stampa macro, macro tracciatura
abilitato dal traceon macro, il testo definito per le macro scritte dal discarica macro, o
per i messaggi di diagnostica.

USCITA FILE

Nessuno.

EXTENDED DESCRIZIONE

I m4 l'utilità confronterà ogni token dall'input con l'insieme di built-in e
macro definite dall'utente. Se il token corrisponde al nome di una macro, il token deve essere
sostituito dal testo che definisce la macro, se presente, e scansionato nuovamente per i nomi di macro corrispondenti.
Una volta che nessuna parte del token corrisponde al nome di una macro, deve essere scritta nello standard
produzione. Le macro possono avere argomenti, nel qual caso gli argomenti devono essere sostituiti in
il testo di definizione prima che venga scansionato di nuovo.

Le chiamate macro hanno la forma:

Nome(arg1, arg2, ..., argomento)

I nomi delle macro sono costituiti da lettere, cifre e trattini bassi, dove il primo carattere
non è una cifra. I token non di questa forma non devono essere trattati come macro.

L'applicazione garantisce che il segue immediatamente il nome di
la macro. Se un token che corrisponde al nome di una macro non è seguito da a
parentesi>, viene gestito come un uso di quella macro senza argomenti.

Se il nome di una macro è seguito da a , i suoi argomenti sono i
-token separati tra i e l'abbinamento
parentesi>. I caratteri di spazio bianco senza virgolette che precedono ogni argomento devono essere ignorati.
Tutti gli altri caratteri, inclusi gli spazi finali, vengono mantenuti.
caratteri racchiusi tra e i personaggi no
delimitare gli argomenti.

Gli argomenti sono definiti in modo posizionale e referenziati. La stringa "$ 1" nel testo di definizione
è sostituito dal primo argomento. I sistemi devono supportare almeno nove argomenti;
solo i primi nove possono essere referenziati, usando le stringhe "$ 1" a "$ 9", compreso. Il
stringa "$ 0" viene sostituito con il nome della macro. La stringa "$ #" è sostituito da
numero di argomenti come stringa. La stringa "$*" è sostituito da un elenco di tutti i
argomenti, separati da caratteri. La stringa "$@" è sostituito da un elenco di tutti
degli argomenti separati da caratteri, e ogni argomento è citato usando il
stringhe di virgolette correnti sinistra e destra. La stringa "${" produce un comportamento non specificato.

Se vengono forniti meno argomenti di quelli nella definizione della macro, gli argomenti omessi
sono considerati nulli. Non è un errore se vengono forniti più argomenti di quelli contenuti nel
definizione macro.

Non viene dato alcun significato speciale ai caratteri racchiusi tra la corrispondenza sinistra e destra
stringhe di virgolette, ma le stesse stringhe di virgolette vengono scartate. Per impostazione predefinita, il sinistro
la stringa di citazione consiste in un accento grave (virgolette inverse) e la stringa di citazione corretta
consiste in un accento acuto (virgoletta singola); vedi anche il cambia citazione macro.

I commenti vengono scritti ma non scansionati per i nomi di macro corrispondenti; per impostazione predefinita, l'inizio
la stringa di commento è composta da carattere e la stringa del commento finale consiste
di una . Vedi anche il cambiacom ed dnl macro.

I m4 utility renderà disponibili le seguenti macro integrate. Possono essere ridefiniti,
ma una volta fatto questo si perde il significato originario. I loro valori sono nulli a meno che
diversamente indicato. Nelle descrizioni seguenti, il termine definizione testo si riferisce al valore di
la macro: il secondo argomento per il definire macro, tra le altre cose. Fatta eccezione per il
primo argomento per il eval macro, tutti gli argomenti numerici delle macro integrate devono essere
interpretati come valori decimali. I valori di stringa prodotti come testo che definisce il
decreta, div, aumento, Index, lene sysval le macro integrate devono essere sotto forma di a
costante decimale come definito nel linguaggio C.

cambiacom I cambiacom macro deve impostare le stringhe di inizio-commento e di fine-commento. Senza
argomenti, il meccanismo di commento deve essere disabilitato. Con un unico non nullo
argomento, tale argomento deve diventare l'inizio-commento e il deve
diventa la stringa di commento finale. Con due argomenti non nulli, il primo argomento
deve diventare la stringa di inizio-commento e il secondo argomento deve diventare il
stringa di fine commento. Il comportamento non è specificato se viene fornito uno degli argomenti
ma nullo. I sistemi devono supportare stringhe di commento di almeno cinque caratteri.

cambia citazione
I cambia citazione macro deve impostare le stringhe di virgolette iniziali e finali. Senza
argomenti, le stringhe di virgolette devono essere impostate sui valori predefiniti (ovvero, `').
Il comportamento non è specificato se c'è un singolo argomento o se uno degli argomenti è
nullo. Con due argomenti non nulli, il primo argomento diventa l'inizio
stringa di virgolette e il secondo argomento devono diventare la stringa di virgolette finali. Sistemi
deve supportare stringhe di virgolette di almeno cinque caratteri.

decreta Il testo che definisce il decreta macro deve essere il suo primo argomento decrementato di
1. Deve essere un errore specificare un argomento contenente qualsiasi elemento non numerico
caratteri. Il comportamento non è specificato se decreta non è immediatamente seguito da
un .

definire Il secondo argomento deve diventare il testo che definisce la macro il cui nome è
il primo argomento. Non è specificato se il definire la macro cancella tutto prima
definizioni della macro nominata dal suo primo argomento o conserva tutto tranne il
definizione attuale della macro. Il comportamento non è specificato se definire non è
immediatamente seguito da a .

def Il testo che definisce il def macro deve essere la definizione citata (usando il
stringhe di virgolette correnti) dei suoi argomenti. Il comportamento non è specificato se def
non è immediatamente seguito da a .

deviare I m4 utility mantiene nove buffer temporanei, numerati da 1 a 9, inclusi.
Quando l'ultimo input è stato elaborato, qualsiasi output che è stato posizionato
in questi buffer devono essere scritti sullo standard output in ordine numerico del buffer.
I deviare macro deve deviare l'output futuro al buffer specificato dal suo
discussione. Specificare nessun argomento o un argomento pari a 0 deve riprendere il normale
processo di uscita. L'output deviato su un flusso con un numero negativo deve essere
scartato. Il comportamento è definito dall'implementazione se un numero di flusso maggiore di 9
è specificato. Deve essere un errore specificare un argomento contenente qualsiasi
caratteri numerici.

div Il testo che definisce il div macro deve essere il numero dell'uscita corrente
flusso come una stringa.

dnl I dnl macro deve causare m4 per scartare tutti i caratteri inseriti fino a compreso
il prossimo .

discarica I discarica macro deve scrivere il testo definito in errore standard per ciascuno dei
macro specificate come argomenti o, se non vengono specificati argomenti, per tutti
macro.

errore di stampa I errore di stampa macro deve scrivere i suoi argomenti nell'errore standard. Il comportamento è
non specificato se errore di stampa non è immediatamente seguito da a .

eval I eval la macro valuterà il suo primo argomento come un'espressione aritmetica,
utilizzando l'aritmetica di interi con segno con una precisione di almeno 32 bit. almeno il
i seguenti operatori di linguaggio C devono essere supportati, con precedenza,
associatività e comportamento come descritto in Sezione 1.1.2.1, Aritmetica
Precisione ed Operazioni:

()
unario +
unario -
~

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

I sistemi devono supportare numeri ottali ed esadecimali come nello standard ISO C.
Il secondo argomento, se specificato, imposterà la radice del risultato; se la
l'argomento è vuoto o non specificato, il valore predefinito è 10. Il comportamento non è specificato se
la radice cade al di fuori dell'intervallo da 2 a 36 inclusi. Il terzo argomento, se
specificato, imposta il numero minimo di cifre nel risultato. Il comportamento è
non specificato se il terzo argomento è minore di zero. Sarà un errore
specificare il secondo o il terzo argomento contenente caratteri non numerici. Il
il comportamento non è specificato se eval non è immediatamente seguito da a
parentesi>.

se def Se il primo argomento per il se def macro è definita, il testo di definizione deve essere
il secondo argomento. In caso contrario, il testo di definizione sarà il terzo argomento,
se specificato, o la stringa nulla, in caso contrario. Il comportamento non è specificato se se def
non è immediatamente seguito da a .

se altro I se altro macro accetta tre o più argomenti. Se i primi due argomenti
confronta come stringhe uguali (dopo l'espansione macro di entrambi gli argomenti), la definizione
il testo deve essere il terzo argomento. Se i primi due argomenti non si confrontano come
stringhe uguali e ci sono tre argomenti, il testo di definizione deve essere null. Se
i primi due argomenti non si confrontano come stringhe uguali e ci sono quattro o
cinque argomenti, il testo di definizione sarà il quarto argomento. Se i primi due
gli argomenti non vengono confrontati come stringhe uguali e ci sono sei o più argomenti,
i primi tre argomenti devono essere scartati e l'elaborazione deve ricominciare con
i restanti argomenti. Il comportamento non è specificato se se altro non è
immediatamente seguito da a .

includere Il testo che definisce il includere macro deve essere il contenuto del file denominato
dal primo argomento. Sarà un errore se il file non può essere letto. Il
il comportamento non è specificato se includere non è immediatamente seguito da a
parentesi>.

aumento Il testo che definisce il aumento macro deve essere il suo primo argomento incrementato di
1. Deve essere un errore specificare un argomento contenente qualsiasi elemento non numerico
caratteri. Il comportamento non è specificato se aumento non è immediatamente seguito da
un .

Index Il testo che definisce il Index macro deve essere la posizione del primo carattere (come a
stringa) nel primo argomento dove inizia una stringa che corrisponde al secondo argomento
(origine zero), o -1 se il secondo argomento non si verifica. Il comportamento è
non specificato se Index non è immediatamente seguito da a .

len Il testo che definisce il len macro deve essere la lunghezza (come una stringa) del
primo argomento. Il comportamento non è specificato se len non è immediatamente seguito
di a .

m4uscita Esci dal m4 utilità. Se viene specificato il primo argomento, è l'uscita
codice. Il valore predefinito è zero. Deve essere un errore specificare un argomento
contenente caratteri non numerici.

m4 avvolgere Il primo argomento deve essere elaborato quando viene raggiunto EOF. Se la m4 avvolgere macro
viene utilizzato più volte, gli argomenti specificati devono essere elaborati nell'ordine
in cui il m4 avvolgere le macro sono state elaborate. Il comportamento non è specificato se m4 avvolgere
non è immediatamente seguito da a .

maketemp Il testo di definizione deve essere il primo argomento, con eventuali finali 'X' caratteri
sostituito con l'ID del processo corrente come stringa. Il comportamento non è specificato
if maketemp non è immediatamente seguito da a .

mkstemp Il primo argomento deve essere preso come modello per la creazione di un file vuoto, con
finale 'X' caratteri sostituiti con caratteri dal nome del file portatile
set di caratteri. Il comportamento non è specificato se il primo argomento non termina in
almeno sei 'X' caratteri. Se un file temporaneo è stato creato con successo, allora
il testo che definisce la macro sarà il nome del nuovo file. L'ID utente
del file deve essere impostato sull'ID utente effettivo del processo. L'ID del gruppo
del file deve essere impostato sull'ID di gruppo della directory padre del file o su
l'ID di gruppo effettivo del processo. I bit di autorizzazione di accesso ai file sono impostati
tale che solo il proprietario può leggere e scrivere il file, indipendentemente dal
corrente umask del processo. Se non è stato possibile creare un file, il testo di definizione
della macro deve essere la stringa vuota. Il comportamento non è specificato se mkstemp
non è immediatamente seguito da a .

popdef I popdef macro eliminerà la definizione corrente dei suoi argomenti, sostituendo
quella definizione con la precedente. Se non esiste una definizione precedente, il
la macro non è definita. Il comportamento non è specificato se popdef non è immediatamente
seguito da a .

pushdef I pushdef macro deve essere equivalente a definire macro con l'eccezione
che conserverà qualsiasi definizione attuale per un futuro recupero utilizzando il
popdef macro. Il comportamento non è specificato se pushdef non è immediatamente seguito
di a .

spostamento Il testo che definisce il spostamento macro deve essere un elenco separato da virgole dei suoi
argomenti tranne il primo. Ogni argomento deve essere citato utilizzando l'attuale
stringhe di citazione. Il comportamento non è specificato se spostamento non è immediatamente
seguito da a .

includere I includere macro deve essere equivalente a includere macro, tranne che
non deve essere un errore se il file è inaccessibile. Il comportamento non è specificato
if includere non è immediatamente seguito da a .

substr Il testo che definisce il substr macro deve essere la sottostringa della prima
argomento che inizia dalla posizione del carattere di spostamento zero specificato dal secondo
discussione. Il terzo argomento, se specificato, deve essere il numero di caratteri da
Selezionare; se non specificato, i caratteri dal punto iniziale alla fine di
il primo argomento diventa il testo di definizione. Non deve essere un errore per
specificare un punto di partenza oltre la fine del primo argomento e la definizione
il testo deve essere nullo. Deve essere un errore specificare un argomento contenente any
caratteri non numerici. Il comportamento non è specificato se substr non è
immediatamente seguito da a .

syscmd I syscmd macro interpreterà il suo primo argomento come una riga di comando della shell. Il
il testo di definizione deve essere il risultato della stringa di quel comando. Il risultato della stringa
non deve essere riesaminato per le macro durante l'impostazione del testo di definizione. Nessuna uscita
il reindirizzamento deve essere eseguito dal m4 utilità. Il valore dello stato di uscita dal
il comando può essere recuperato usando il sysval macro. Il comportamento non è specificato se
syscmd non è immediatamente seguito da a .

sysval Il testo che definisce il sysval macro deve essere il valore di uscita dell'utilità
ultimo invocato dal syscmd macro (come una stringa).

traceon I traceon macro deve abilitare la traccia per le macro specificate come argomenti,
o, se non vengono specificati argomenti, per tutte le macro. L'output della traccia deve essere
scritto su errore standard in un formato non specificato.

tracciare I tracciare la macro disabiliterà la traccia per le macro specificate come argomenti,
oppure, se non vengono specificati argomenti, per tutte le macro.

translit Il testo che definisce il translit macro deve essere il primo argomento con ogni
carattere che ricorre nel secondo argomento sostituito con il corrispondente
carattere dal terzo argomento. Se non viene specificato alcun carattere sostitutivo per
qualche carattere sorgente perché il secondo argomento è più lungo del terzo
argomento, quel carattere deve essere cancellato dal primo argomento in translit's
definizione del testo. Il comportamento non è specificato se il '-' il personaggio appare all'interno
il secondo o il terzo argomento in qualsiasi punto oltre al primo o all'ultimo carattere. Il
il comportamento non è specificato se lo stesso carattere compare più di una volta nel
secondo argomento. Il comportamento non è specificato se translit non è immediatamente
seguito da a .

indefinito I indefinito la macro cancellerà tutte le definizioni (comprese quelle conservate usando
, il pushdef macro) delle macro denominate dai relativi argomenti. Il comportamento è
non specificato se indefinito non è immediatamente seguito da a .

non deviare I non deviare macro deve causare l'output immediato di qualsiasi testo nei buffer temporanei
denominati come argomenti o tutti i buffer temporanei se non vengono specificati argomenti.
I buffer possono essere non deviati in altri buffer temporanei. Non deviare deve
scartare il contenuto del buffer temporaneo. Il comportamento non è specificato se an
argomento contiene caratteri non numerici.

EXIT STATUS

Devono essere restituiti i seguenti valori di uscita:

0 Completamento riuscito.

>0 Si è verificato un errore

Se l' m4uscita viene utilizzata la macro, il valore di uscita può essere specificato dal file di input.

CONSEGUENZE OF ERRORI

Predefinito.

I i seguenti sezioni sono Informativo.

APPLICAZIONI USO

I def macro è utile per rinominare le macro, in particolare quelle integrate.

Dal eval si riferisce allo standard ISO C, alcune operazioni hanno un comportamento indefinito. In qualche
implementazioni, divisione o resto per zero causano un segnale fatale, anche se la divisione
avviene sul ramo in cortocircuito di "&&" or "||". Qualsiasi operazione che trabocca in
l'aritmetica con segno produce un comportamento indefinito. Allo stesso modo, usando il spostamento operatori con a
la quantità di spostamento che non è positiva e inferiore alla precisione non è definita, così com'è
spostando un numero negativo a destra. Storicamente, non tutte le implementazioni obbedivano a C-
regole di precedenza linguistica: '~' ed '!' erano inferiori '=='; '==' ed '!=' non erano inferiori
di '<', E '|' non era inferiore a '^'; l'uso liberale di "()" può forzare il desiderato
precedenza anche con queste implementazioni non conformi. Inoltre, alcuni tradizionali
implementazioni trattate '^' come operatore di elevazione a potenza, sebbene la maggior parte delle implementazioni
ora usa "**" come estensione a questo scopo.

Quando una macro è stata definita in modo moltiplicato tramite il pushdef macro, non è specificato se
, il definire macro modificherà solo la definizione più recente (come se da popdef ed
pushdef), o sostituire l'intero stack di definizioni con una singola definizione (come se
by indefinito ed pushdef). Un'applicazione che desidera un comportamento particolare per il definire
macro in questo caso può ridefinirlo di conseguenza.

Le applicazioni devono utilizzare il mkstemp macro invece dell'obsoleto maketemp macro per
creazione di file temporanei.

ESEMPI

Se il file m4src contiene le righe:

I APPREZZIAMO of `VER' is "VER".
ifdef(`VER', ``VER'' is definito a be VER., VER is non definito.)
se (VER, 1, ``VER'' is `VER'.)
se (VER, 2, ``VER'' is `VER'., ``VER'' is non 2.)
fine

poi il comando

m4 m4src

oppure il comando:

m4 -U VER m4src

produce l'output:

I APPREZZIAMO of VER is "VER".
VER is non definito.

VER non è 2.
fine

Il comando:

m4 −D VER m4src

produce l'output:

I APPREZZIAMO of VER is "".
VER is definito a be .

VER non è 2.
fine

Il comando:

m4 −D VEDI=1 m4src

produce l'output:

I APPREZZIAMO of VER is "1".
VER is definito a be 1.
VER is 1.
VER is non 2.
fine

Il comando:

m4 −D VEDI=2 m4src

produce l'output:

I APPREZZIAMO of VER is "2".
VER is definito a be 2.

VER è 2.
fine

FONDAMENTO LOGICO

Comportamento storico basato su System V trattato "${" in una definizione macro come due letterali
caratteri. Tuttavia, questa sequenza non è specificata in modo che le implementazioni possano offrire
estensioni come "${11}" ovvero l'undicesimo parametro posizionale. Le macro possono ancora essere
definito con usi appropriati di virgolette annidate per risultare in un letterale "${" in uscita
dopo la nuova scansione rimuove le virgolette annidate.

Nel translit integrato, storico comportamento basato su System V trattato '-' come letterale; GNU
comportamento lo tratta come un intervallo. Questa versione dello standard consente entrambi i comportamenti.

FUTURE INDICAZIONI

Nessuno.

Usa m4posix online utilizzando i servizi onworks.net