getoptsposix - Bulutta Çevrimiçi

Program:

ADI

getopts - yardımcı program seçeneklerini ayrıştır

SİNOPSİS

Getopts tercih dizisi isim [arg...]

TANIM

The Getopts yardımcı program, bir parametre listesinden seçenekleri ve seçenek argümanlarını alacaktır.
Temelde açıklanan Yardımcı Program Sözdizimi Yönergeleri 3 ila 10'u destekleyecektir.
POSIX.1‐2008 tanımları hacmi, Bölüm 12.2, Yarar Sözdizimi Kuralları.

Her çağrıldığında, Getopts yardımcı program bir sonraki seçeneğin değerini
tarafından belirtilen kabuk değişkeni isim işlenen ve bir sonraki argümanın indeksi
kabuk değişkeninde işlenir OPTİND. Kabuk her çağrıldığında, OPTİND olmalı
1 olarak başlatıldı.

Seçenek bir seçenek argümanı gerektirdiğinde, Getopts yardımcı program onu ​​yerleştirecektir
kabuk değişkeni OPTARG. Seçenek bulunamazsa veya bulunan seçenek bulunmazsa
bir seçenek argümanı var, OPTARG ayarsız olacaktır.

Seçenek karakterinde yer almayan bir tercih dizisi işlenen bir seçeneğin bulunduğu yerde bulunur
karakter bekleniyor, tarafından belirtilen kabuk değişkeni isim olarak ayarlanacaktır
işaret> ('?') karakter. Bu durumda, eğer ilk karakter tercih dizisi bir
(':'), kabuk değişkeni OPTARG bulunan seçenek karakterine ayarlanacak, ancak çıktı yok
standart hataya yazılacaktır; aksi takdirde, kabuk değişkeni OPTARG ayarsız olacak
ve standart hataya bir teşhis mesajı yazılacaktır. Bu koşul,
argümanların çağırmaya sunulma biçiminde algılanan bir hata olarak kabul edilir
uygulama, ancak bir hata olmayacaktır Getopts işleme.

Bir seçenek argümanı eksikse:

* Eğer ilk karakter tercih dizisi bir , tarafından belirtilen kabuk değişkeni isim
olarak ayarlanacaktır karakter ve kabuk değişkeni OPTARG olarak ayarlanacak
seçenek karakteri bulundu.

* Aksi takdirde, tarafından belirtilen kabuk değişkeni isim olarak ayarlanacaktır
karakter, kabuk değişkeni OPTARG ayarı kaldırılacak ve bir teşhis mesajı
standart hataya yazılır. Bu durum tespit edilen bir hata olarak kabul edilecektir.
argümanların başvuruya sunulma biçiminde, ancak bir
hata Getopts işleme; bir teşhis mesajı belirtildiği gibi yazılacaktır, ancak
çıkış durumu sıfır olacaktır.

Seçeneklerin sonu ile karşılaşıldığında, Getopts yardımcı program bir dönüş değeri ile çıkacaktır
sıfırdan büyük; kabuk değişkeni OPTİND ilk dizinine ayarlanacaktır
işlenen veya değer "$ #"+1 işlenen yoksa; NS isim değişken olarak ayarlanmalıdır
NS karakter. Aşağıdakilerden herhangi biri seçeneklerin sonunu belirleyecektir:
ilk "--" bir seçenek argümanı olmayan argüman, olmayan bir argüman bulma
seçenek argümanı ve bir ile başlamaz '-'veya bir hatayla karşılaşılması.

Kabuk değişkenleri OPTİND ve OPTARG arayan için yerel olacaktır Getopts ve
varsayılan olarak dışa aktarılamaz.

tarafından belirtilen kabuk değişkeni isim işlenen, OPTİND, ve OPTARG etkileyecek
mevcut kabuk yürütme ortamı; görmek Bölüm 2.12, Kabuk infaz çevre.

Uygulama ayarlarsa OPTİND 1 değerine, yeni bir parametre seti kullanılabilir: ya
mevcut konumsal parametreler veya yeni arg değerler. çağırmak için başka herhangi bir girişim Getopts
parametrelerle (konumsal) tek bir kabuk yürütme ortamında birden çok kez
parametreler veya arg işlenenler) tüm çağrılarda aynı olmayan veya bir OPTİND
1'den farklı bir değer olarak değiştirilen değer, belirtilmemiş sonuçlar üretir.

SEÇENEKLER

Yok.

İŞLENENLER

Aşağıdaki işlenenler desteklenecektir:

tercih dizisi Çağıran yardımcı program tarafından tanınan seçenek karakterlerini içeren bir dize
Getopts. Bir karakterin ardından bir , seçenek beklenir
ayrı bir argüman olarak sunulması gereken bir argümana sahip olmak.
Uygulamalar bir seçenek karakteri ve onun seçenek argümanını şu şekilde belirtmelidir:
ayrı argümanlar, ancak Getopts aşağıdaki karakterleri yorumlayacaktır
Bunun yapılıp yapılmadığını bağımsız değişken olarak argüman gerektiren seçenek karakteri.
Açık bir boş seçenek argümanı, şu şekilde sağlanmazsa tanınmaya gerek yoktur.
ayrı bir argüman ne zaman Getopts çağrılır. (Ayrıca bkz. almak() işlevi
POSIX.1‐2008'in Sistem Arayüzleri bölümünde tanımlanmıştır.) Karakterler
ve tarafından seçenek karakterleri olarak kullanılmayacaktır.
başvuru. Alfanümerik olmayan diğer seçenek karakterlerinin kullanımı
belirtilmemiş sonuçlar üretir. Seçenek argümanı olarak sağlanmazsa
seçenek karakterinden ayrı argüman, içindeki değer OPTARG olmalı
seçenek karakterinden arındırılmış ve '-'. içindeki ilk karakter tercih dizisi
nasıl olduğunu belirler Getopts bir seçenek karakteri bilinmiyorsa veya bir seçenek yoksa davranır-
argüman eksik.

isim Tarafından ayarlanacak bir kabuk değişkeninin adı Getopts yarar
bulunan seçenek karakteri.

The Getopts varsayılan olarak yardımcı program, çağırmaya iletilen konumsal parametreleri ayrıştırır
kabuk prosedürü. Eğer args verilirse, konumsal yerine ayrıştırılırlar.
parametreleri.

STDIN

Kullanılmamış.

GİRİŞ DOSYALAR

Yok.

ÇEVRE DEĞİŞKENLER

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

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.

OPTİND Bu değişken tarafından kullanılacaktır Getopts sonrakinin indeksi olarak yardımcı program
Argüman işlenecek.

ASENKRON ETKİNLİKLER

Varsayılan.

STDOUT

Kullanılmamış.

STDER

Bir hata algılandığında ve dosyadaki ilk karakter tercih dizisi işlenen bir değil
(':'), standart hataya aşağıdaki ile bir teşhis mesajı yazılmalıdır.
belirtilmemiş bir biçimde bilgi:

* Çağıran program adı mesajda belirtilecektir. Çağıran program
name, kabuk özel parametresi 0'ın değeri olacaktır (bkz. Bölüm 2.5.2, Özel
parametreler) o sırada Getopts yardımcı program çağrılır. Şuna eşdeğer bir ad:

baz adı "0 $"

Kullanılabilir.

* Belirtilmeyen bir seçenek bulunursa tercih dizisi, bu hata tanımlandı
ve geçersiz seçenek karakteri mesajda belirtilecektir.

* Bir seçenek argümanı gerektiren bir seçenek bulunur, ancak bir seçenek argümanı yoksa
bulunduğunda, bu hata tanımlanacak ve geçersiz seçenek karakteri
mesajda tanımlanmıştır.

ÇIKTI DOSYALAR

Yok.

GENİŞLETİLMİŞ TANIM

Yok.

EXIT DURUMU

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

0 Tarafından belirtilen veya belirtilmeyen bir seçenek tercih dizisi, bulundu.

>0 Seçeneklerin sonuyla karşılaşıldı veya bir hata oluştu.

SONUÇLARI OF HATALAR

Varsayılan.

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

BAŞVURUSU KULLANIM

Dan beri Getopts geçerli kabuk yürütme ortamını etkiler, genellikle şu şekilde sağlanır:
bir kabuk normal yerleşik. Bir alt kabukta veya ayrı bir yardımcı program yürütmesinde çağrılırsa
ortam, örneğin aşağıdakilerden biri:

(getoplar ABC değer "$@")
hayır Getopts ...
bulmak . -yürütme Getopts ... \;

arayanın ortamındaki kabuk değişkenlerini etkilemez.

Kabuk işlevlerinin paylaştığını unutmayın OPTİND konumsal olsa bile çağıran kabuk ile
parametreler değiştirilir. Çağıran kabuk ve işlevlerinden herhangi biri kullanıyorsa Getopts için
ayrıştırma argümanları, sonuçlar belirtilmemiş.

ÖRNEKLER

Aşağıdaki örnek komut dosyası, bağımsız değişkenlerini ayrıştırır ve görüntüler:

bayrak=
bbayrak=
süre Getopts dan: isim
do
dava $ isim in
a) bayrak=1;;
b) bbayrak=1
bval="$OPTARG";;
?) printf "Kullanım: % s: [−a] [−b değer] argümanlar\n" $0
çıkış 2 ;;
esac
yapılmış
if [ ! -z "$ bayrak" ]; sonra
printf "Seçenek -a belirtilen\n"
fi
if [ ! -z "$bbayrak" ]; sonra
printf 'Seçenek -b "%s" belirtilen\n' "$bval"
fi
çalışma $(($OPTIND - 1))
printf "Geriye kalan argümanlar şunlardır: %s\n$*"

GEREKÇESİ

The Getopts yardımcı program System V'e tercih edilerek seçildi almak fayda çünkü
Getopts içeren seçenek argümanlarını işler karakterler.

The OPTARG ÇEVRE DEĞİŞKENLERİ bölümünde belirtilmemiştir çünkü
yürütülmesini etkilemez Getopts; kullanılan birkaç "sadece çıktı" değişkeninden biridir.
standart yardımcı programlar tarafından.

NS bir seçenek karakteri olarak izin verilmez çünkü bu tarihsel davranış değildir,
ve Yardımcı Program Sözdizimi Yönergelerini ihlal eder. NS şimdi olarak davranmak için belirtildi
KornShell sürümünde Getopts Yarar; ilk karakter olarak kullanıldığında
tercih dizisi işlenen, eksik seçenek argümanları ile ilgili tanılamayı devre dışı bırakır ve
beklenmedik seçenek karakterleri. Bu, kullanımının yerini alır. OPTER değişken olan
erken bir teklifte belirtilmiştir.

tarafından üretilen tanılama mesajlarının biçimleri Getopts fayda ve almak()
işlev tam olarak belirtilmemiştir çünkü üstün (``dostça'') olan uygulamalar
formatlar, bazı tarihsel uygulamalar tarafından kullanılan formatlara itiraz etti. Standart
geliştiriciler, kullanılan mesajlardaki bilgilerin tek tip olmasının önemli olduğunu düşündüler
arasında Getopts ve almak(). Mesajların tam olarak kopyalanması mümkün olmayabilir,
özellikle bir yardımcı program farklı bir sisteme sahip başka bir sistem üzerine kuruluysa almak()
ancak mesajların özel bilgiler içermesi gerekir, böylece program
ad, geçersiz seçenek karakteri ve hata türü bir kullanıcı tarafından ayırt edilebilir.

Yalnızca nadir bir uygulama programı, bir Getopts standart hata mesajı ve istiyor
ayrıştırın. Bu nedenle, uygulamalar yapabilecekleri en kullanışlı mesajları seçmekte özgürdürler.
tasarla. Aşağıdaki biçimler birçok tarihsel uygulama tarafından kullanılır:

"%s: yasadışı seçenek - %c\n", <program isim>, <seçenek karakter>

"%s: seçenek bir argüman gerektiriyor -− %c\n",program isim>, \
<seçenek karakter>

Yerleşik sürümleri olan tarihi mermiler almak() veya Getopts farklı kullanmış
biçimler, çoğu zaman hatalı bulunan seçenek karakterini bile belirtmez.

GELECEK TARİFİ

Yok.

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