getoptsposix - Online di Cloud

PROGRAM:

NAMA

getopts — mengurai opsi utilitas

RINGKASAN

getopt string pilihan nama [arg...]

DESKRIPSI

Grafik getopt utilitas akan mengambil opsi dan argumen opsi dari daftar parameter.
Ini akan mendukung Pedoman Sintaks Utilitas 3 hingga 10, inklusif, yang dijelaskan dalam Basis
Definisi volume POSIX.1-2008, Bagian 12.2, Kegunaan Sintaksis Panduan.

Setiap kali dipanggil, getopt utilitas akan menempatkan nilai opsi berikutnya di
variabel shell yang ditentukan oleh nama operan dan indeks argumen berikutnya menjadi
diproses dalam variabel shell MEMILIH. Setiap kali shell dipanggil, MEMILIH seharusnya
diinisialisasi ke 1.

Ketika opsi membutuhkan argumen opsi, getopt utilitas harus menempatkannya di
variabel cangkang MEMILIH. Jika tidak ada opsi yang ditemukan, atau jika opsi yang ditemukan tidak ditemukan
memiliki opsi-argumen, MEMILIH akan tidak disetel.

Jika karakter opsi tidak terdapat dalam string pilihan operan ditemukan di mana opsi
karakter diharapkan, variabel shell ditentukan oleh nama akan diatur ke
tandai> ('?') karakter. Dalam hal ini, jika karakter pertama dalam string pilihan adalah
(':'), variabel kulit MEMILIH harus disetel ke karakter opsi yang ditemukan, tetapi tidak ada output
harus ditulis dengan kesalahan standar; jika tidak, variabel shell MEMILIH tidak akan disetel
dan pesan diagnostik harus ditulis ke kesalahan standar. Kondisi ini harus
dianggap sebagai kesalahan yang terdeteksi dalam cara argumen disajikan ke pemanggilan
aplikasi, tetapi tidak akan menjadi kesalahan dalam getopt pengolahan.

Jika argumen opsi tidak ada:

* Jika karakter pertama dari string pilihan adalah , variabel shell yang ditentukan oleh nama
akan diatur ke karakter dan variabel shell MEMILIH akan diatur ke
karakter opsi yang ditemukan.

* Jika tidak, variabel shell ditentukan oleh nama akan diatur ke
karakter, variabel shell MEMILIH harus tidak disetel, dan pesan diagnostik harus
ditulis ke kesalahan standar. Kondisi ini akan dianggap sebagai kesalahan yang terdeteksi
dalam cara argumen disajikan ke aplikasi pemanggilan, tetapi tidak akan menjadi
kesalahan dalam getopt pengolahan; pesan diagnostik harus ditulis seperti yang dinyatakan, tetapi
status keluar harus nol.

Ketika akhir opsi ditemukan, getopt utilitas akan keluar dengan nilai balik
lebih besar dari nol; variabel cangkang MEMILIH harus diatur ke indeks yang pertama
operan, atau nilai "$ #"+1 jika tidak ada operan; NS nama variabel harus disetel ke
NS karakter. Salah satu dari berikut ini akan mengidentifikasi akhir opsi: the
pertama "−−" argumen yang bukan merupakan argumen pilihan, menemukan argumen yang bukan merupakan
opsi-argumen dan tidak dimulai dengan a '−', atau mengalami kesalahan.

Variabel shell MEMILIH dan MEMILIH harus lokal untuk penelepon getopt dan harus
tidak diekspor secara default.

Variabel shell ditentukan oleh nama operan, MEMILIH, dan MEMILIH akan mempengaruhi
lingkungan eksekusi shell saat ini; Lihat Bagian 2.12, Kulit Execution Lingkungan Hidup.

Jika aplikasi ditetapkan MEMILIH ke nilai 1, satu set parameter baru dapat digunakan: baik
parameter posisi saat ini atau baru arg nilai-nilai. Upaya lain untuk memanggil getopt
beberapa kali dalam lingkungan eksekusi shell tunggal dengan parameter (posisional
parameter atau arg operand) yang tidak sama di semua pemanggilan, atau dengan MEMILIH
nilai yang dimodifikasi menjadi nilai selain 1, menghasilkan hasil yang tidak ditentukan.

PILIHAN

Tidak ada.

OPERA

Operand berikut harus didukung:

string pilihan String yang berisi karakter opsi yang dikenali oleh utilitas yang dipanggil
getopt. Jika sebuah karakter diikuti oleh , opsi harus diharapkan
untuk memiliki argumen, yang harus diberikan sebagai argumen terpisah.
Aplikasi harus menentukan karakter opsi dan argumen opsinya sebagai
argumen terpisah, tapi getopt akan menafsirkan karakter berikut dan
karakter opsi yang membutuhkan argumen sebagai argumen apakah ini dilakukan atau tidak.
Argumen opsi null eksplisit tidak perlu dikenali jika tidak diberikan sebagai
argumen terpisah ketika getopt dipanggil. (Lihat juga dapatkan opt() fungsi
didefinisikan dalam volume Antarmuka Sistem POSIX.1-2008.) Karakter
dan tidak boleh digunakan sebagai karakter pilihan oleh
aplikasi. Penggunaan karakter opsi lain yang bukan alfanumerik
menghasilkan hasil yang tidak ditentukan. Jika argumen opsi tidak diberikan sebagai
argumen terpisah dari karakter opsi, nilai dalam MEMILIH seharusnya
dilucuti dari karakter opsi dan '−'. Karakter pertama di string pilihan
menentukan bagaimana getopt berperilaku jika karakter opsi tidak diketahui atau opsi-
argumen hilang.

nama Nama variabel shell yang harus ditetapkan oleh getopt utilitas untuk
karakter pilihan yang ditemukan.

Grafik getopt utilitas secara default akan mengurai parameter posisi yang diteruskan ke pemanggilan
prosedur cangkang. Jika args diberikan, mereka akan diuraikan alih-alih posisional
parameter.

STDIN

Tidak digunakan.

INPUT FILE

Tidak ada.

LINGKUNGAN VARIABEL

Variabel lingkungan berikut akan mempengaruhi pelaksanaan getopt:

BAHASA Berikan nilai default untuk variabel internasionalisasi yang tidak disetel atau
batal. (Lihat volume Definisi Dasar dari POSIX.1-2008, Bagian 8.2,
Internasionalisasi Variabel untuk didahulukan internasionalisasi
variabel yang digunakan untuk menentukan nilai kategori lokal.)

LC_SEMUA Jika disetel ke nilai string yang tidak kosong, timpa nilai dari yang lainnya
variabel internasionalisasi.

LC_CTYPE Tentukan lokal untuk interpretasi urutan byte data teks
sebagai karakter (misalnya, byte tunggal sebagai lawan dari karakter multi-byte dalam
argumen dan file input).

LC_MESSAGES
Tentukan lokal yang harus digunakan untuk mempengaruhi format dan isi dari
pesan diagnostik yang ditulis ke kesalahan standar.

NLSPATH Tentukan lokasi katalog pesan untuk pemrosesan LC_MESSAGES.

MEMILIH Variabel ini akan digunakan oleh getopt utilitas sebagai indeks berikutnya
argumen yang akan diproses.

tidak sinkron EVENT

Default

STDOUT

Tidak digunakan.

STDERR

Setiap kali kesalahan terdeteksi dan karakter pertama di string pilihan operan bukan
(':'), pesan diagnostik harus ditulis ke kesalahan standar dengan yang berikut:
informasi dalam format yang tidak ditentukan:

* Nama program yang memanggil harus diidentifikasi dalam pesan. Program pemanggilan
name harus menjadi nilai parameter khusus shell 0 (lihat Bagian 2.5.2, Khusus
parameter) pada saat itu getopt utilitas dipanggil. Nama yang setara dengan:

nama dasar "$ 0"

dapat digunakan.

* Jika opsi ditemukan yang tidak ditentukan dalam string pilihan, kesalahan ini diidentifikasi
dan karakter opsi yang tidak valid harus diidentifikasi dalam pesan.

* Jika opsi yang membutuhkan argumen opsi ditemukan, tetapi argumen opsi tidak ditemukan
ditemukan, kesalahan ini harus diidentifikasi dan karakter opsi yang tidak valid adalah
diidentifikasi dalam pesan.

KELUARAN FILE

Tidak ada.

DITERIMA DESKRIPSI

Tidak ada.

EXIT STATUS

Nilai keluar berikut harus dikembalikan:

0 Pilihan, ditentukan atau tidak ditentukan oleh string pilihan, ditemukan.

>0 Akhir opsi ditemukan atau terjadi kesalahan.

KONSEKUENSI OF GALAT

Default

Grafik berikut bagian adalah informatif.

APLIKASI PENGGUNAAN

Sejak getopt mempengaruhi lingkungan eksekusi shell saat ini, umumnya disediakan sebagai
shell biasa built-in. Jika dipanggil dalam subkulit atau eksekusi utilitas terpisah
lingkungan, seperti salah satu dari berikut ini:

(getopt abc nilai "$@")
nohup getopt ...
menemukan . ekseku getopt ... \;

itu tidak mempengaruhi variabel shell di lingkungan pemanggil.

Perhatikan bahwa fungsi shell berbagi MEMILIH dengan shell panggilan meskipun posisinya
parameter diubah. Jika shell pemanggil dan salah satu fungsinya menggunakan getopt untuk
parse argumen, hasilnya tidak ditentukan.

CONTOH

Contoh skrip berikut mem-parsing dan menampilkan argumennya:

bendera=
bendera=
sementara getopt jauh: nama
do
kasus $nama in
a) bendera=1;;
b) bendera=1
bval="$OPTARG";;
?) Printf "Penggunaan: %S: [−a] [−b nilai] argumen\n" $0
keluar 2;;
esac
dilakukan
if [ ! z "$bendera" ]; kemudian
Printf "Pilihan a ditentukan\n"
fi
if [ ! z "$bflag" ]; kemudian
Printf 'Pilihan b "%S" ditentukan\n' "$bval"
fi
bergeser $(($ MEMILIH - 1))
Printf "Tersisa argumen adalah: %s\n$*"

ALASAN

Grafik getopt utilitas dipilih dalam preferensi untuk Sistem V dapatkan opt utilitas karena
getopt menangani opsi-argumen yang mengandung karakter.

Grafik MEMILIH variabel tidak disebutkan di bagian VARIABEL LINGKUNGAN karena memang demikian
tidak mempengaruhi pelaksanaan getopt; ini adalah salah satu dari sedikit variabel ``output-only'' yang digunakan
oleh utilitas standar.

NS tidak diperbolehkan sebagai karakter pilihan karena itu bukan perilaku historis,
dan itu melanggar Pedoman Sintaks Utilitas. NS sekarang ditentukan untuk berperilaku sebagai
dalam versi KornShell dari getopt kegunaan; ketika digunakan sebagai karakter pertama dalam
string pilihan operand, ini menonaktifkan diagnostik tentang argumen opsi yang hilang dan
karakter opsi tak terduga. Ini menggantikan penggunaan OPTERR variabel itu
ditentukan dalam proposal awal.

Format pesan diagnostik yang dihasilkan oleh getopt utilitas dan dapatkan opt()
fungsi tidak sepenuhnya ditentukan karena implementasi dengan superior (``ramah'')
format keberatan dengan format yang digunakan oleh beberapa implementasi historis. Standar
pengembang menganggap penting bahwa informasi dalam pesan yang digunakan harus seragam
antara getopt dan dapatkan opt(). Penggandaan pesan yang tepat mungkin tidak dapat dilakukan,
terutama jika utilitas dibangun di atas sistem lain yang memiliki perbedaan dapatkan opt()
fungsi, tetapi pesan harus memiliki informasi spesifik yang disertakan agar program dapat
nama, karakter opsi yang tidak valid, dan jenis kesalahan dapat dibedakan oleh pengguna.

Hanya program aplikasi langka yang memotong getopt pesan kesalahan standar dan ingin
menguraikannya. Oleh karena itu, implementasi bebas memilih pesan yang paling dapat digunakan
merancang. Format berikut digunakan oleh banyak implementasi historis:

"%S: liar Option - %c\n", <program nama>, <Option karakter>

"%s: opsi memerlukan argumen %c\n",program nama>, \
<Option karakter>

Kerang bersejarah dengan versi bawaan dapatkan opt() atau getopt telah menggunakan berbeda
format, seringkali bahkan tidak menunjukkan karakter opsi yang ditemukan dalam kesalahan.

MASA DEPAN ARAH

Tidak ada.

Gunakan getoptsposix online menggunakan layanan onworks.net