getoptsposix - Dalam Talian di Awan

JADUAL:

NAMA

getopts - menghuraikan pilihan utiliti

SINOPSIS

getopts optstring nama [berhujah...]

DESCRIPTION

. getopts utiliti hendaklah mendapatkan semula pilihan dan hujah pilihan daripada senarai parameter.
Ia hendaklah menyokong Garis Panduan Sintaks Utiliti 3 hingga 10, termasuk, yang diterangkan dalam Pangkalan
Jumlah takrifan POSIX.1‐2008, seksyen 12.2, utiliti Syntax Garis panduan.

Setiap kali ia dipanggil, yang getopts utiliti hendaklah meletakkan nilai pilihan seterusnya dalam
pembolehubah shell yang ditentukan oleh nama operan dan indeks hujah seterusnya menjadi
diproses dalam pembolehubah shell OPTIND. Setiap kali shell dipanggil, OPTIND sepatut nya
dimulakan kepada 1.

Apabila pilihan memerlukan hujah pilihan, the getopts utiliti hendaklah meletakkannya di dalam
pembolehubah shell OPTARG. Jika tiada pilihan ditemui, atau jika pilihan yang ditemui tidak ditemui
mempunyai hujah pilihan, OPTARG hendaklah tidak ditetapkan.

Jika aksara pilihan tidak terkandung dalam optstring operan ditemui di mana pilihan
watak dijangka, pembolehubah shell ditentukan oleh nama hendaklah ditetapkan kepada <soalan-
tanda> ('?') watak. Dalam kes ini, jika watak pertama dalam optstring ialah
(':'), pembolehubah shell OPTARG hendaklah ditetapkan kepada aksara pilihan yang ditemui, tetapi tiada output
hendaklah ditulis kepada ralat piawai; jika tidak, pembolehubah shell OPTARG hendaklah tidak ditetapkan
dan mesej diagnostik hendaklah ditulis kepada ralat standard. Syarat ini hendaklah
dianggap sebagai ralat yang dikesan dalam cara hujah dikemukakan kepada pemanggilan
permohonan, tetapi tidak boleh menjadi ralat dalam getopts pemprosesan.

Jika tiada hujah pilihan:

* Jika watak pertama daripada optstring ialah , pembolehubah shell yang ditentukan oleh nama
hendaklah ditetapkan kepada aksara dan pembolehubah shell OPTARG hendaklah ditetapkan kepada
aksara pilihan ditemui.

* Jika tidak, pembolehubah shell ditentukan oleh nama hendaklah ditetapkan kepada
watak, pembolehubah shell OPTARG hendaklah tidak ditetapkan, dan mesej diagnostik hendaklah
ditulis kepada ralat piawai. Keadaan ini hendaklah dianggap sebagai ralat yang dikesan
dalam cara hujah dibentangkan kepada permohonan yang menggunakan, tetapi tidak boleh menjadi
ralat dalam getopts pemprosesan; mesej diagnostik hendaklah ditulis seperti yang dinyatakan, tetapi
status keluar hendaklah sifar.

Apabila akhir pilihan ditemui, yang getopts utiliti hendaklah keluar dengan nilai pulangan
lebih besar daripada sifar; pembolehubah shell OPTIND hendaklah ditetapkan kepada indeks yang pertama
operan, atau nilai "$#"+1 jika tiada operan; yang nama pembolehubah hendaklah ditetapkan kepada
aksara . Mana-mana yang berikut hendaklah mengenal pasti penghujung pilihan: the
pertama "−−" hujah yang bukan hujah pilihan, mencari hujah yang bukan
hujah pilihan dan tidak bermula dengan a '−', atau menghadapi ralat.

Pembolehubah shell OPTIND and OPTARG hendaklah setempat kepada pemanggil getopts dan hendaklah
tidak boleh dieksport secara lalai.

Pembolehubah shell yang ditentukan oleh nama operan, OPTIND, dan OPTARG akan menjejaskan
persekitaran pelaksanaan shell semasa; lihat seksyen 2.12, Shell Pelaksanaan alam Sekitar.

Jika permohonan ditetapkan OPTIND kepada nilai 1, satu set parameter baharu boleh digunakan: sama ada
parameter kedudukan semasa atau baharu berhujah nilai. Sebarang percubaan lain untuk memohon getopts
beberapa kali dalam persekitaran pelaksanaan shell tunggal dengan parameter (positional
parameter atau berhujah operan) yang tidak sama dalam semua seruan, atau dengan OPTIND
nilai yang diubah suai menjadi nilai selain daripada 1, menghasilkan keputusan yang tidak ditentukan.

PILIHAN

Tiada.

OPERAND

Operan berikut hendaklah disokong:

optstring Rentetan yang mengandungi aksara pilihan yang diiktiraf oleh penggunaan utiliti
getopts. Jika aksara diikuti dengan , pilihan itu akan dijangkakan
mempunyai hujah, yang sepatutnya dibekalkan sebagai hujah yang berasingan.
Aplikasi harus menyatakan watak pilihan dan hujah pilihannya sebagai
hujah berasingan, tetapi getopts hendaklah mentafsir watak-watak berikut a
aksara pilihan yang memerlukan hujah sebagai hujah sama ada ini dilakukan atau tidak.
Argumen pilihan nol yang jelas tidak perlu diiktiraf jika ia tidak dibekalkan sebagai
hujah yang berasingan apabila getopts diseru. (Lihat juga getopt() fungsi
ditakrifkan dalam isipadu Antara Muka Sistem POSIX.1‐2008.) Aksara
dan tidak boleh digunakan sebagai aksara pilihan oleh a
permohonan. Penggunaan aksara pilihan lain yang bukan abjad angka
menghasilkan keputusan yang tidak ditentukan. Jika hujah pilihan tidak dibekalkan sebagai a
hujah berasingan daripada aksara pilihan, nilai dalam OPTARG sepatut nya
dilucutkan watak pilihan dan '−'. Watak pertama dalam optstring
menentukan bagaimana getopts berkelakuan jika watak pilihan tidak diketahui atau pilihan-
hujah hilang.

nama Nama pembolehubah shell yang hendaklah ditetapkan oleh getopts utiliti kepada
watak pilihan yang ditemui.

. getopts utiliti secara lalai hendaklah menghuraikan parameter kedudukan yang dihantar kepada pemanggilan
prosedur cangkerang. Jika berhujahs diberikan, ia akan dihuraikan dan bukannya kedudukan
parameter.

STDIN

Tidak digunakan.

INPUT FILES

Tiada.

PERSEKITARAN PELBAGAI

Pembolehubah persekitaran berikut akan mempengaruhi pelaksanaan getopts:

BAHASA Sediakan nilai lalai untuk pembolehubah pengantarabangsaan yang tidak ditetapkan atau
null. (Lihat volum Takrif Asas POSIX.1‐2008, seksyen 8.2,
Pengantarabangsaan Pembolehubah untuk keutamaan pengantarabangsaan
pembolehubah yang digunakan untuk menentukan nilai kategori tempat.)

LC_ALL Jika ditetapkan kepada nilai rentetan bukan kosong, ganti nilai semua yang lain
pembolehubah pengantarabangsaan.

LC_CTYPE Tentukan tempat untuk tafsiran jujukan bait data teks
sebagai aksara (contohnya, bait tunggal berbanding dengan aksara berbilang bait dalam
argumen dan fail input).

LC_MESSAGES
Tentukan tempat yang harus digunakan untuk mempengaruhi format dan kandungan
mesej diagnostik yang ditulis kepada ralat standard.

NLSPATH Tentukan lokasi katalog mesej untuk pemprosesan LC_MESSAGES.

OPTIND Pembolehubah ini hendaklah digunakan oleh getopts utiliti sebagai indeks seterusnya
hujah untuk diproses.

ASYNCRONOUS ACARA

Lalai.

STDOUT

Tidak digunakan.

STDERR

Apabila ralat dikesan dan aksara pertama dalam optstring operan bukan a
(':'), mesej diagnostik hendaklah ditulis kepada ralat standard dengan yang berikut
maklumat dalam format yang tidak ditentukan:

* Nama program panggilan hendaklah dikenal pasti dalam mesej. Program pemanggilan
nama hendaklah menjadi nilai parameter khas shell 0 (lihat seksyen 2.5.2, khas
Parameter) pada masa itu getopts utiliti dipanggil. Nama yang setara dengan:

nama asas "$0"

mungkin digunakan.

* Jika pilihan didapati yang tidak dinyatakan dalam optstring, ralat ini dikenal pasti
dan aksara pilihan yang tidak sah hendaklah dikenal pasti dalam mesej.

* Jika pilihan yang memerlukan hujah pilihan ditemui, tetapi hujah pilihan tidak
ditemui, ralat ini hendaklah dikenal pasti dan aksara pilihan yang tidak sah hendaklah
dikenal pasti dalam mesej.

OUTPUT FILES

Tiada.

EXTENDED DESCRIPTION

Tiada.

EXIT STATUS

Nilai keluar berikut hendaklah dikembalikan:

0 Pilihan, ditentukan atau tidak ditentukan oleh optstring, telah dijumpai.

>0 Tamat pilihan ditemui atau ralat berlaku.

AKIBAT OF KESALAHAN

Lalai.

. berikutan bahagian adalah bermaklumat.

PERMOHONAN PENGGUNAAN

Sejak getopts mempengaruhi persekitaran pelaksanaan shell semasa, ia biasanya disediakan sebagai
shell biasa terbina dalam. Jika ia dipanggil dalam subkulit atau pelaksanaan utiliti yang berasingan
persekitaran, seperti salah satu daripada yang berikut:

(getopts abc nilai "$@")
nohup getopts ...
mencari . −eks getopts ... \;

ia tidak menjejaskan pembolehubah shell dalam persekitaran pemanggil.

Ambil perhatian bahawa fungsi shell berkongsi OPTIND dengan shell panggilan walaupun kedudukannya
parameter diubah. Jika shell panggilan dan mana-mana fungsinya menggunakan getopts kepada
huraikan hujah, hasilnya tidak ditentukan.

CONTOH

Skrip contoh berikut menghuraikan dan memaparkan hujahnya:

bendera=
bflag=
manakala getopts jauh: nama
do
kes $ nama in
a) aflag=1;;
b) bflag=1
bval="$OPTARG";;
?) Printf "Penggunaan: %s: [−a] [−b nilai] args\n" $0
keluar 2;;
bahawa C
dilakukan
if [ ! −z "$bendera" ]; kemudian
Printf "Pilihan −a ditentukan\n"
fi
if [ ! −z "$bflag" ]; kemudian
Printf 'Pilihan −b "%s" ditentukan\n' "$bval"
fi
peralihan $(($OPTIND - 1))
Printf "Baki hujah ialah: %s\n$*"

RATIONALE

. getopts utiliti telah dipilih sebagai keutamaan kepada Sistem V getopt utiliti kerana
getopts mengendalikan hujah pilihan yang mengandungi aksara .

. OPTARG pembolehubah tidak disebut dalam bahagian PEMBOLEH UBAH ALAM SEKITAR kerana ia berlaku
tidak menjejaskan pelaksanaan getopts; ia adalah salah satu daripada beberapa pembolehubah ``keluaran sahaja'' yang digunakan
oleh utiliti standard.

tidak dibenarkan sebagai watak pilihan kerana itu bukan tingkah laku sejarah,
dan ia melanggar Garis Panduan Sintaks Utiliti. kini ditentukan untuk berkelakuan sebagai
dalam versi KornShell getopts utiliti; apabila digunakan sebagai watak pertama dalam
optstring operan, ia melumpuhkan diagnostik mengenai hujah pilihan yang hilang dan
aksara pilihan yang tidak dijangka. Ini menggantikan penggunaan OPTERR pembolehubah itu
dinyatakan dalam cadangan awal.

Format mesej diagnostik yang dihasilkan oleh getopts utiliti dan getopt()
fungsi tidak ditentukan sepenuhnya kerana pelaksanaan dengan superior (``friendly'')
format membantah format yang digunakan oleh beberapa pelaksanaan sejarah. Piawaian
pembangun menganggap penting bahawa maklumat dalam mesej yang digunakan adalah seragam
antara getopts and getopt(). Penduaan tepat mesej mungkin tidak dapat dilakukan,
terutamanya jika utiliti dibina pada sistem lain yang mempunyai sistem yang berbeza getopt()
berfungsi, tetapi mesej mesti mempunyai maklumat khusus yang disertakan supaya program
nama, aksara pilihan tidak sah dan jenis ralat boleh dibezakan oleh pengguna.

Hanya program aplikasi yang jarang berlaku memintas a getopts mesej ralat standard dan mahu
menghuraikannya. Oleh itu, pelaksanaan bebas untuk memilih mesej yang paling boleh digunakan
merangka. Format berikut digunakan oleh banyak pelaksanaan sejarah:

"%s: haram pilihan −− %c\n", <program nama>, <pilihan watak>

"%s: pilihan memerlukan hujah −− %c\n", <program nama>, \
<pilihan watak>

Cengkerang sejarah dengan versi terbina dalam getopt() atau getopts telah menggunakan berbeza
format, selalunya tidak menunjukkan aksara pilihan yang ditemui dalam kesilapan.

MASA HADAPAN ARAHAN

Tiada.

Gunakan getoptsposix dalam talian menggunakan perkhidmatan onworks.net