m4posix - Bulutta Çevrimiçi

Program:

ADI

m4 — makro işlemci

SİNOPSİS

m4 [-s] [-D isim[=val]]... [-U isim]... dosya...

TANIM

The m4 yardımcı program, bir veya daha fazla metin dosyasını okuyacak, işleyecek bir makro işlemcidir.
içerdikleri makro ifadelerine göre ve sonuçları standart çıktıya yazın.

SEÇENEKLER

The m4 yardımcı program, POSIX.1‐2008'in Temel Tanımlar hacmine uygun olacaktır, Bölüm 12.2,
Yarar Sözdizimi Kuralları, sırasının dışında -D ve -U seçenekler
önemlidir ve seçenekler işlenenlerle serpiştirilebilir.

Aşağıdaki seçenekler desteklenecektir:

-s için hat senkronizasyon çıkışını etkinleştirin. c99 önişlemci aşaması (yani,
#hat direktifler).

-D isim[=val]
Tanımlama isim için val veya = ise nullval atlanmıştır.

-U isim tanımsız isim.

İŞLENENLER

Aşağıdaki işlenen desteklenecektir:

dosya İşlenecek bir metin dosyasının yol adı. Eğer hayırsa dosya verilmişse veya verilmişse '-',
standart giriş okunacaktır.

STDIN

Standart girdi, eğer yoksa kullanılan bir metin dosyası olacaktır. dosya işlenen verilirse veya
is '-'.

GİRİŞ DOSYALAR

tarafından adlandırılan girdi dosyası dosya işlenen bir metin dosyası olacaktır.

ÇEVRE DEĞİŞKENLER

Aşağıdaki ortam değişkenleri, aşağıdakilerin yürütülmesini etkiler: m4:

DİL Ayarlanmamış veya ayarlanmamış uluslararasılaştırma değişkenleri için varsayılan bir değer sağlayın.
boş. (Bkz. POSIX.1‐2008'in Temel Tanımlar cildi, Bölüm 8.2,
Uluslararasılaşma Değişkenler uluslararasılaşmanın önceliği için
yerel kategorilerin değerlerini belirlemek için kullanılan değişkenler.)

LC_ALL Boş olmayan bir dize değerine ayarlanırsa, diğer tüm değerlerin değerlerini geçersiz kılın
uluslararasılaştırma değişkenleri.

LC_CTYPE Metin verisi bayt dizilerinin yorumlanması için yerel ayarı belirleyin
karakter olarak (örneğin, çoklu bayt karakterlerin aksine tek bayt
argümanlar ve girdi dosyaları).

LC_MESSAGES
biçimini ve içeriğini etkilemek için kullanılması gereken yerel ayarı belirleyin.
standart hataya yazılan teşhis mesajları.

NLSPATH İşleme için mesaj kataloglarının yerini belirleyin. LC_MESSAGES.

ASENKRON ETKİNLİKLER

Varsayılan.

STDOUT

Standart çıktı, makro için işlendikten sonra girdi dosyalarıyla aynı olacaktır.
genişleme.

STDER

Standart hata, dizeleri görüntülemek için kullanılacaktır. hata baskısı makro, makro izleme
tarafından etkinleştirildi iz makro, tarafından yazılan makrolar için tanımlı metin dumpdef makro veya
teşhis mesajları için.

ÇIKTI DOSYALAR

Yok.

GENİŞLETİLMİŞ TANIM

The m4 yardımcı program, girişteki her bir belirteci yerleşik ve
kullanıcı tanımlı makrolar. Belirteç bir makronun adıyla eşleşirse belirteç
varsa, makronun tanımlayıcı metniyle değiştirilir ve eşleşen makro adları için yeniden taranır.
Belirtecin hiçbir kısmı bir makronun adıyla eşleşmediğinde, standart olarak yazılacaktır.
çıktı. Makroların argümanları olabilir, bu durumda argümanlar
tanımlayıcı metin yeniden taranmadan önce.

Makro çağrıları şu şekildedir:

isim(arg1, arg2, ..., argüman)

Makro adları, ilk karakterin bulunduğu harfler, rakamlar ve alt çizgilerden oluşacaktır.
rakam değildir. Bu formda olmayan jetonlar makro olarak değerlendirilmeyecektir.

Uygulama, adının hemen ardından
makro. Bir makronun adıyla eşleşen bir belirtecin ardından bir
parantez>, bu makronun argümanlar olmadan kullanımı olarak ele alınır.

Bir makro adının ardından bir , onun argümanları
-arasında ayrılmış belirteçler ve eşleştirme
parantez>. Her argümandan önceki tırnak içine alınmamış beyaz boşluk karakterleri dikkate alınmaz.
Sondaki boşluk karakterleri de dahil olmak üzere diğer tüm karakterler korunur.
arasına alınmış karakterler ve karakterler yok
argümanları sınırlayın.

Bağımsız değişkenler konumsal olarak tanımlanır ve başvurulur. dize "1 $" tanımlayıcı metinde
ilk argüman ile değiştirilecektir. Sistemler en az dokuz argümanı destekleyecektir;
dizeler kullanılarak yalnızca ilk dokuza başvurulabilir "1 $" için "9 $", dahil. NS
dizi "0 $" makronun adıyla değiştirilir. dize "$ #" ile değiştirilir
dize olarak argüman sayısı. dize "$*" tümünün bir listesi ile değiştirilir.
argümanlar, ayrılmış karakterler. dize "$@" hepsinin bir listesiyle değiştirilir
ile ayrılan argümanların karakterler ve her argüman kullanılarak alıntılanır
geçerli sol ve sağ alıntı dizeleri. dize "${" tanımlanmamış davranış üretir.

Makro tanımındakinden daha az argüman sağlanırsa, atlanan argümanlar
null olarak alınır. Aşağıdakilerden daha fazla argüman sağlanmışsa bu bir hata değildir.
makro tanımı.

Sol ve sağ eşleştirme arasında yer alan hiçbir karaktere özel bir anlam verilmez
alıntı dizeleri, ancak alıntı dizelerinin kendileri atılır. Varsayılan olarak, sol
alıntı dizesi, ciddi bir vurgu (geri alıntı) ve sağ alıntı dizesinden oluşur
keskin bir vurgudan oluşur (tek tırnak); ayrıca bkz. değişiklik teklifi makro.

Yorumlar yazılır ancak eşleşen makro adları için taranmaz; varsayılan olarak, başlangıç-
yorum dizesinden oluşur karakter ve son yorum dizesinden oluşur
bir . Ayrıca bkz. değişim şirketi ve dnl makrolar.

The m4 yardımcı program aşağıdaki yerleşik makroları kullanıma sunacaktır. Yeniden tanımlanabilirler,
ancak bu yapıldığında orijinal anlam kaybolur. Değerleri, olmadıkça null olacaktır.
aksi belirtildi. Aşağıdaki açıklamalarda, terim tanımlarken metin değerini ifade eder
makro: ikinci argüman tanımlamak makro, diğer şeylerin yanı sıra. hariç
ilk argüman değerlendirme makro, yerleşik makrolara yönelik tüm sayısal argümanlar
ondalık değerler olarak yorumlanır. Tanımlayıcı metin olarak üretilen dize değerleri
azalan, divnum, artış, indeks, len, ve sistem yerleşik makrolar bir
C dilinde tanımlandığı gibi ondalık sabit.

değişim şirketi The değişim şirketi makro, başlangıç-yorum ve bitiş-yorum dizelerini belirler. hayır ile
argümanlar, yorum mekanizması devre dışı bırakılır. Tek bir boş olmayan
argüman, bu argüman başlangıç ​​​​yorumu olacak ve acak
son yorum dizesi olur. İki boş olmayan argümanla, ilk argüman
başlangıç-yorum dizesi olacak ve ikinci argüman
son yorum dizesi. Argümanlardan herhangi biri sağlanırsa davranış belirtilmez
ama boş. Sistemler, en az beş karakterlik yorum dizilerini destekleyecektir.

değişiklik teklifi
The değişiklik teklifi makro, başlangıç-alıntı ve bitiş-teklif dizelerini belirler. hayır ile
argümanlar, alıntı dizeleri varsayılan değerlere ayarlanacaktır (yani, `').
Tek bir argüman varsa veya argümanlardan biri geçerliyse davranış belirtilmez.
boş. İki boş olmayan argümanla, ilk argüman başlangıç ​​olacaktır.
alıntı dizesi ve ikinci argüman son alıntı dizesi olur. Sistemler
en az beş karakterlik alıntı dizelerini destekleyecektir.

azalan Tanımlayıcı metin azalan makro, tarafından azaltılan ilk argümanı olacaktır.
1. Sayısal olmayan herhangi bir argüman içeren bir argüman belirtmek bir hata olacaktır.
karakterler. davranış belirtilmemişse azalan hemen takip edilmez
a .

tanımlamak İkinci argüman, adı şu olan makronun tanımlayıcı metni olacaktır.
ilk argüman. olup olmadığı belirtilmemiştir. tanımlamak makro tüm öncekileri siler
ilk argümanı tarafından adlandırılan makronun tanımları veya aşağıdakiler dışında tümünü korur.
makronun geçerli tanımı. davranış belirtilmemişse tanımlamak değil
hemen ardından bir .

tanım Tanımlayıcı metin tanım makro alıntılanan tanım olacaktır (kullanarak
argümanlarının geçerli alıntı dizeleri). davranış belirtilmemişse tanım
hemen ardından bir .

yönlendirmek The m4 yardımcı program, 1'den 9'a kadar numaralandırılmış dokuz geçici arabellek tutar.
Girdinin sonuncusu işlendiğinde, yerleştirilen herhangi bir çıktı
bu tamponlarda standart çıktıya tampon-sayısal sırayla yazılacaktır.
The yönlendirmek makro, gelecekteki çıktıyı kendi belirlediği arabelleğe yönlendirecektir.
argüman. Argüman olmaması veya 0 argümanının belirtilmesi normale dönecektir.
çıktı süreci. Negatif sayıya sahip bir akışa yönlendirilen çıktı,
atılan. Akış numarası 9'dan büyükse, davranış uygulama tarafından tanımlanır
belirtilir. olmayan herhangi bir argümanı belirtmek bir hata olacaktır.
sayısal karakterler.

divnum Tanımlayıcı metin divnum makro, mevcut çıkışın sayısı olacaktır
bir dize olarak akış.

dnl The dnl makro neden olur m4 dahil tüm giriş karakterlerini atmak için
sonraki .

dumpdef The dumpdef makro tanımlı metni standart hataya yazacaktır.
bağımsız değişken olarak belirtilen makrolar veya herhangi bir bağımsız değişken belirtilmemişse, tümü için
makrolar.

hata baskısı The hata baskısı makro, argümanlarını standart hataya yazacaktır. davranış
belirtilmemiş ise hata baskısı hemen ardından bir .

değerlendirme The değerlendirme makro ilk argümanını aritmetik bir ifade olarak değerlendirecektir,
en az 32 bit hassasiyetle işaretli tamsayı aritmetiği kullanarak. en azından
aşağıdaki C dili operatörleri öncelikli olarak desteklenecektir,
ilişkilendirilebilirlik ve açıklandığı gibi davranış Bölüm 1.1.2.1, Aritmetik
Hassas ve Operasyon:

()
birli +
birli -
~

!
ikili *
/
%
ikili +
ikili -
<<
>>
<
<=
>
>=
==
!=
ikili &
^
|
&&
||

Sistemler, ISO C standardında olduğu gibi sekizli ve onaltılı sayıları destekleyecektir.
Belirtilmişse, ikinci argüman sonuç için sayı tabanını belirler; Eğer
argüman boş veya belirtilmemiş, varsayılan 10'dur.
sayı tabanı, 2 ila 36 (dahil) aralığının dışında kalır. Üçüncü argüman, eğer
belirtilen, sonuçtaki minimum basamak sayısını ayarlar. davranış
üçüncü bağımsız değişken sıfırdan küçükse belirtilmemiş. için bir hata olacaktır
sayısal olmayan karakterleri içeren ikinci veya üçüncü bağımsız değişkeni belirtin. NS
davranış belirtilmemişse değerlendirme hemen ardından bir
parantez>.

ifdef Eğer ilk argüman ifdef makro tanımlıysa, tanımlayıcı metin
ikinci argüman. Aksi takdirde, tanımlayıcı metin üçüncü argüman olacaktır,
belirtilmişse, yoksa boş dize. davranış belirtilmemişse ifdef
hemen ardından bir .

eğer başka The eğer başka makro üç veya daha fazla bağımsız değişken alır. Eğer ilk iki argüman
eşit dizeler olarak karşılaştırın (her iki argümanın makro genişlemesinden sonra), tanımlayıcı
metin üçüncü argüman olacaktır. İlk iki argüman olarak karşılaştırılmazsa
eşit dizeler ve üç argüman var, tanımlayıcı metin null olacaktır. Eğer
ilk iki argüman eşit dizeler olarak karşılaştırılmaz ve dört veya
beş argüman, tanımlayıcı metin dördüncü argüman olacaktır. eğer ilk ikisi
argümanlar eşit dizeler olarak karşılaştırılmaz ve altı veya daha fazla argüman vardır,
ilk üç argüman atılır ve işleme şu şekilde yeniden başlar:
kalan argümanlar. davranış belirtilmemişse eğer başka değil
hemen ardından bir .

dahil için tanımlayıcı metin dahil makro adlı dosyanın içeriği olacaktır
ilk argümana göre. Dosya okunamıyorsa bu bir hata olacaktır. NS
davranış belirtilmemişse dahil hemen ardından bir
parantez>.

artış Tanımlayıcı metin artış makro, artırılan ilk argümanı olacaktır.
1. Sayısal olmayan herhangi bir argüman içeren bir argüman belirtmek bir hata olacaktır.
karakterler. davranış belirtilmemişse artış hemen takip edilmez
a .

indeks Tanımlayıcı metin indeks makro ilk karakter konumu olacaktır (bir
dize) ikinci argümanla eşleşen bir dizenin başladığı ilk argümanda
(sıfır kaynak) veya ikinci bağımsız değişken oluşmazsa -1. davranış
belirtilmemiş ise indeks hemen ardından bir .

len Tanımlayıcı metin len makronun uzunluğu (bir dize olarak) olacaktır.
ilk argüman. davranış belirtilmemişse len hemen takip edilmez
tarafından .

m4çıkış -Den çık m4 Yarar. İlk argüman belirtilirse, çıkıştır.
kod. Varsayılan sıfırdır. Bir argüman belirtmek bir hata olacaktır.
herhangi bir sayısal olmayan karakter içeren.

m4wrap İlk argüman, EOF'ye ulaşıldığında işlenecektir. Eğer m4wrap makro
birden çok kez kullanılırsa, belirtilen argümanlar sırayla işlenir
içinde m4wrap makrolar işlendi. davranış belirtilmemişse m4wrap
hemen ardından bir .

geçici sıcaklık Tanımlayıcı metin, herhangi bir takip eden ilk argüman olacaktır. 'X' karakterler
dize olarak geçerli işlem kimliğiyle değiştirilir. Davranış belirtilmemiş
if geçici sıcaklık hemen ardından bir .

mkstemp İlk argüman, boş bir dosya oluşturmak için şablon olarak alınacaktır.
sondaki 'X' taşınabilir dosya adındaki karakterlerle değiştirilen karakterler
karakter seti. İlk argüman ile bitmiyorsa davranış belirtilmemiştir.
en az altı 'X' karakterler. Geçici bir dosya başarıyla oluşturulduysa, o zaman
makronun tanımlayıcı metni yeni dosyanın adı olacaktır. kullanıcı kimliği
dosyanın, işlemin etkin kullanıcı kimliğine ayarlanacaktır. grup kimliği
dosyanın üst dizininin grup kimliğine veya
sürecin etkin grup kimliği. Dosya erişim izni bitleri ayarlandı
öyle ki, dosyanın içeriğinden bağımsız olarak yalnızca sahibi dosyayı hem okuyabilir hem de yazabilir.
akım Umask sürecin. Bir dosya oluşturulamadıysa, tanımlayıcı metin
makronun boş dizesi olacaktır. davranış belirtilmemişse mkstemp
hemen ardından bir .

popdef The popdef makro, argümanlarının geçerli tanımını silerek
bu tanım bir öncekiyle. Daha önce bir tanım yoksa,
makro tanımsız. davranış belirtilmemişse popdef hemen değil
ardından bir .

pushdef The pushdef makro eşdeğer olacaktır tanımlamak istisna dışında makro
kullanarak gelecekteki erişim için herhangi bir mevcut tanımı koruyacağını
popdef makro. davranış belirtilmemişse pushdef hemen takip edilmez
tarafından .

çalışma için tanımlayıcı metin çalışma makrosunun virgülle ayrılmış bir listesi olacaktır.
İlki hariç argümanlar. Her argüman, geçerli olan kullanılarak alıntılanacaktır.
dizeleri alıntı. davranış belirtilmemişse çalışma hemen değil
ardından bir .

dahil etmek The dahil etmek makro eşdeğer olacaktır dahil bunun dışında makro
dosyaya erişilemiyorsa bir hata olmayacaktır. Davranış belirtilmemiş
if dahil etmek hemen ardından bir .

substr için tanımlayıcı metin substr makro birincinin alt dizisi olacaktır
ikinci tarafından belirtilen sıfır ofset karakter konumundan başlayan argüman
argüman. Üçüncü argüman, belirtilirse, yazılacak karakter sayısı olacaktır.
Seçme; belirtilmemişse, başlangıç ​​noktasından sonuna kadar olan karakterler
ilk argüman tanımlayıcı metin olacaktır. için bir hata olmayacaktır
ilk argümanın ve tanımlayıcının sonunun ötesinde bir başlangıç ​​noktası belirtin
metin null olacaktır. Herhangi bir argümanı içeren bir argüman belirtmek bir hata olacaktır.
sayısal olmayan karakterler davranış belirtilmemişse substr değil
hemen ardından bir .

sistem The sistem makro, ilk argümanını bir kabuk komut satırı olarak yorumlayacaktır. NS
tanımlama metni, bu komutun dize sonucu olacaktır. dize sonucu
tanımlama metni ayarlanırken makrolar için yeniden taranmayacaktır. Çıktı yok
yönlendirme tarafından yapılacaktır. m4 Yarar. Çıkış durumu değeri
komutu kullanılarak alınabilir. sistem makro. davranış belirtilmemişse
sistem hemen ardından bir .

sistem Tanımlayıcı metin sistem makro, yardımcı programın çıkış değeri olacaktır
tarafından en son çağrılan sistem makro (dize olarak).

iz The iz makro, argüman olarak belirtilen makrolar için izlemeyi sağlar,
veya herhangi bir bağımsız değişken belirtilmemişse, tüm makrolar için. İzleme çıktısı
belirtilmemiş bir biçimde standart hataya yazılır.

iz bırakma The iz bırakma makro, argüman olarak belirtilen makrolar için izlemeyi devre dışı bırakır,
veya herhangi bir bağımsız değişken belirtilmemişse, tüm makrolar için.

translite Tanımlayıcı metin translite makro, her biriyle ilk argüman olacaktır.
karşılık gelen ile değiştirilen ikinci argümanda meydana gelen karakter
üçüncü argümandan karakter. için herhangi bir değiştirme karakteri belirtilmemişse
bazı kaynak karakter çünkü ikinci argüman üçüncüden daha uzun
argüman, bu karakter ilk argümandan silinecektir. translite's
tanımlayan metin. davranış belirtilmemişse, '-' karakter içinde görünür
ilk veya son karakterin yanında herhangi bir yerde ikinci veya üçüncü argüman. NS
aynı karakter bir defadan fazla görünüyorsa davranış belirtilmemiştir.
ikinci argüman. davranış belirtilmemişse translite hemen değil
ardından bir .

tanımsız The tanımsız makro tüm tanımları siler (kullanılarak korunanlar dahil)
the pushdef makro) bağımsız değişkenleri tarafından adlandırılan makroların. davranış
belirtilmemiş ise tanımsız hemen ardından bir .

yönünü değiştirmek The yönünü değiştirmek makro, geçici arabelleklerdeki herhangi bir metnin anında çıktısına neden olur
bağımsız değişkenler veya herhangi bir bağımsız değişken belirtilmemişse tüm geçici arabellekler olarak adlandırılır.
Tamponlar, diğer geçici arabelleklere yönlendirilemez. Yönlendirmeyi kaldırma
geçici arabelleğin içeriğini atın. Davranış belirtilmemişse,
argüman sayısal olmayan karakterler içeriyor.

EXIT DURUMU

Aşağıdaki çıkış değerleri döndürülecektir:

0 Başarılı tamamlama.

>0 Bir hata oluştu

Eğer m4çıkış makro kullanıldığında, çıkış değeri giriş dosyası tarafından belirtilebilir.

SONUÇLARI OF HATALAR

Varsayılan.

The takip etme bölümler vardır bilgilendirici.

BAŞVURUSU KULLANIM

The tanım makro, makroları, özellikle yerleşikleri yeniden adlandırmak için kullanışlıdır.

Dan beri değerlendirme ISO C standardına uyar, bazı işlemler tanımsız davranışa sahiptir. bazılarında
uygulamalar, bölme veya sıfırdan kalan, bölme işlemi yapılsa bile ölümcül bir sinyale neden olur.
kısa devre dalında oluşur "&&" or "||". İçinde taşan herhangi bir işlem
imzalı aritmetik tanımsız davranış üretir. Aynı şekilde, kullanarak çalışma ile operatörler
pozitif olmayan ve kesinlikten daha küçük olmayan kaydırma miktarı, olduğu gibi tanımsızdır.
negatif bir sayıyı sağa kaydırma. Tarihsel olarak, tüm uygulamalar C-'ye uymadı.
dil önceliği kuralları: '~' ve '!' daha düşüktü '=='; '==' ve '!=' daha düşük değildi
göre '<'; Ve '|' daha düşük değildi '^'; liberal kullanımı "()" istenileni zorlayabilir
Bu uyumlu olmayan uygulamalarda bile öncelik. Ayrıca bazı geleneksel
tedavi edilen uygulamalar '^' çoğu uygulama olmasına rağmen, bir üs operatörü olarak
şimdi kullan "**" Bu amaç için bir uzantı olarak.

Bir makro, üzerinden çarpma tanımlandığında pushdef makro olup olmadığı belirtilmemiş
the tanımlamak makro yalnızca en son tanımı değiştirecektir (sanki popdef ve
pushdef) veya tüm tanım yığınını tek bir tanımla değiştirin (sanki
by tanımsız ve pushdef). için belirli bir davranış isteyen bir uygulama tanımlamak
makro bu durumda buna göre yeniden tanımlayabilir.

Uygulamalar kullanmalı mkstemp eskimiş yerine makro geçici sıcaklık için makro
geçici dosyalar oluşturma.

ÖRNEKLER

Dosya m4src satırları içerir:

The değer of 'VER' is "VER".
ifdef(`VER', ''VER'' is tanımlı için be VER., VER is değil tanımlı.)
ifelse(VER, 1, ''VER'' is 'VER'.)
ifelse(VER, 2, ''VER'' is 'VER'., ''VER'' is değil 2).
son

sonra komut

m4 m4src

veya komut:

m4 -U VER m4src

çıktıyı üretir:

The değer of VER is "VER".
VER is değil tanımladı.

VER 2 değildir.
son

Komuta:

m4 -D VER m4src

çıktıyı üretir:

The değer of VER is "".
VER is tanımlı için be .

VER 2 değildir.
son

Komuta:

m4 -D VER=1 m4src

çıktıyı üretir:

The değer of VER is "1".
VER is tanımlı için be 1.
VER is 1.
VER is değil 2.
son

Komuta:

m4 -D VER=2 m4src

çıktıyı üretir:

The değer of VER is "2".
VER is tanımlı için be 2.

VER 2'dir.
son

GEREKÇESİ

Tarihi Sistem V tabanlı davranış işlendi "${" iki değişmez olarak bir makro tanımında
karakterler. Ancak, uygulamaların sunabilmesi için bu sıra belirtilmeden bırakılmıştır.
gibi uzantılar "${11}" onbirinci konumsal parametre anlamına gelir. Makrolar hala olabilir
bir hazır bilgi ile sonuçlanacak iç içe alıntının uygun kullanımları ile tanımlanır "${" çıktıda
yeniden taramadan sonra iç içe tırnakları kaldırır.

içinde translite yerleşik, tarihi Sistem V tabanlı davranış işlendi '-' literal olarak; GNU
davranış bunu bir aralık olarak ele alır. Standardın bu sürümü her iki davranışa da izin verir.

GELECEK TARİFİ

Yok.

onworks.net hizmetlerini kullanarak m4posix'i çevrimiçi kullanın