getoptsposix - Online sa Cloud

PROGRAMA:

NAME

getopts - i-parse ang mga opsyon sa utility

SINOPSIS

mga getopts optstring pangalan [arg...]

DESCRIPTION

Ang mga getopts dapat kunin ng utility ang mga opsyon at opsyon-argument mula sa isang listahan ng mga parameter.
Dapat nitong suportahan ang Utility Syntax Guidelines 3 hanggang 10, kasama, na inilarawan sa Base
Dami ng mga kahulugan ng POSIX.1–2008, seksyon 12.2, Gamit palaugnayan Mga Alituntunin.

Sa bawat oras na ito ay tinatawag, ang mga getopts dapat ilagay ng utility ang halaga ng susunod na opsyon sa
ang shell variable na tinukoy ng pangalan operand at ang index ng susunod na argumento na
naproseso sa variable ng shell OPTIND. Sa tuwing ang shell ay tinatawag, OPTIND ay magiging
nasimulan sa 1.

Kapag ang opsyon ay nangangailangan ng opsyon-argumento, ang mga getopts ilalagay ito ng utility sa
variable ng shell OPTARG. Kung walang nahanap na opsyon, o kung ang opsyon na nahanap ay hindi
magkaroon ng isang opsyon-argumento, OPTARG ay hindi nakatakda.

Kung ang isang opsyon na character ay hindi nakapaloob sa optstring Ang operand ay matatagpuan kung saan ang isang opsyon
ang character ay inaasahan, ang shell variable na tinukoy ng pangalan ay itatakda sa
markahan> ('?') karakter. Sa kasong ito, kung ang unang character sa optstring ay isang
(':'), ang variable ng shell OPTARG ay dapat itakda sa opsyon na character na natagpuan, ngunit walang output
dapat isulat sa karaniwang error; kung hindi, ang shell variable OPTARG ay hindi nakatakda
at isang mensaheng diagnostic ang dapat isulat sa karaniwang error. Ang kundisyong ito ay dapat
itinuturing na isang error na nakita sa paraan ng pagharap ng mga argumento sa invoking
aplikasyon, ngunit hindi dapat maging isang error sa mga getopts pagpoproseso.

Kung ang isang opsyon-argument ay nawawala:

* Kung ang unang karakter ng optstring ay isang , ang variable ng shell na tinukoy ng pangalan
ay itatakda sa character at ang variable ng shell OPTARG itatakda sa
nakita ang opsyon na character.

* Kung hindi, ang variable ng shell na tinukoy ng pangalan ay itatakda sa
character, ang variable ng shell OPTARG ay hindi nakatakda, at isang mensahe ng diagnostic ay dapat
nakasulat sa karaniwang error. Ang kundisyong ito ay dapat ituring na isang error na nakita
sa paraan kung paano ipinakita ang mga argumento sa invoking application, ngunit hindi dapat isang
error sa mga getopts pagproseso; isang mensahe ng diagnostic ay dapat isulat tulad ng nakasaad, ngunit ang
ang katayuan sa paglabas ay magiging zero.

Kapag ang dulo ng mga pagpipilian ay nakatagpo, ang mga getopts lalabas ang utility na may return value
higit sa zero; ang variable ng shell OPTIND ay dapat itakda sa index ng una
operand, o ang halaga "$#"+1 kung walang mga operand; ang pangalan variable ay dapat itakda sa
ang karakter. Ang alinman sa mga sumusunod ay dapat tukuyin ang dulo ng mga opsyon: ang
una "−−" argumento na hindi isang opsyon-argumento, paghahanap ng argumento na hindi isang
option-argument at hindi nagsisimula sa a '−', o nakakaranas ng isang error.

Ang mga variable ng shell OPTIND at OPTARG ay dapat na lokal sa tumatawag ng mga getopts at dapat
hindi ma-export bilang default.

Ang variable ng shell na tinukoy ng pangalan operand, OPTIND, at OPTARG ay makakaapekto sa
kasalukuyang kapaligiran ng pagpapatupad ng shell; tingnan mo seksyon 2.12, Talukap ng alimango Pagpapatupad kapaligiran.

Kung itinakda ang application OPTIND sa value 1, maaaring gumamit ng bagong set ng mga parameter: alinman
ang kasalukuyang positional parameter o bago arg mga halaga. Anumang iba pang pagtatangkang mag-invoke mga getopts
maraming beses sa isang kapaligiran ng pagpapatupad ng shell na may mga parameter (positional
mga parameter o arg operand) na hindi pareho sa lahat ng invocation, o may isang OPTIND
binago ang halaga upang maging isang halaga maliban sa 1, na gumagawa ng mga hindi natukoy na resulta.

Opsyon

Wala.

MGA OPERAND

Ang mga sumusunod na operand ay dapat suportahan:

optstring Isang string na naglalaman ng mga character na opsyon na kinikilala ng utility invoking
mga getopts. Kung ang isang tauhan ay sinusundan ng a , ang opsyon ay dapat asahan
magkaroon ng argumento, na dapat ibigay bilang hiwalay na argumento.
Dapat tukuyin ng mga application ang isang opsyon na character at ang opsyon-argument nito bilang
magkahiwalay na argumento, ngunit mga getopts dapat bigyang-kahulugan ang mga karakter na sumusunod sa isang
opsyon na character na nangangailangan ng mga argumento bilang argumento kung ito ay tapos na o hindi.
Ang isang tahasang null option-argument ay hindi kailangang kilalanin kung hindi ito ibinibigay bilang
isang hiwalay na argumento kapag mga getopts ay hinihingi. (Tingnan din ang getopt() pagpapaandar
tinukoy sa dami ng System Interfaces ng POSIX.1‐2008.) Ang mga character
at ay hindi dapat gamitin bilang opsyon na mga character ng isang
aplikasyon. Ang paggamit ng iba pang opsyon na mga character na hindi alphanumeric
nagdudulot ng hindi tiyak na mga resulta. Kung ang opsyon-argument ay hindi ibinibigay bilang a
hiwalay na argumento mula sa character na opsyon, ang halaga sa OPTARG ay magiging
Inalis ang opsyon na karakter at ang '−'. Ang unang karakter sa optstring
natutukoy kung paano mga getopts kumikilos kung ang isang opsyon na karakter ay hindi kilala o isang opsyon-
nawawala ang argumento.

pangalan Ang pangalan ng isang shell variable na dapat itakda ng mga getopts utility sa
opsyon na karakter na natagpuan.

Ang mga getopts Ang utility bilang default ay dapat mag-parse ng mga positional na parameter na ipinasa sa invoking
pamamaraan ng shell. Kung args ay ibinigay, sila ay dapat i-parse sa halip na ang positional
parameter.

STDIN

Hindi ginagamit.

INPUT MGA FILE

Wala.

Kapaligiran MGA VARIABLE

Ang mga sumusunod na variable ng kapaligiran ay dapat makaapekto sa pagpapatupad ng mga getopts:

WIKA Magbigay ng default na halaga para sa mga variable ng internationalization na hindi nakatakda o
wala. (Tingnan ang dami ng Base Definition ng POSIX.1–2008, seksyon 8.2,
internationalization Variable para sa pangunguna sa internasyonalisasyon
mga variable na ginagamit upang matukoy ang mga halaga ng mga lokal na kategorya.)

LC_ALL Kung nakatakda sa isang walang laman na halaga ng string, i-override ang mga halaga ng lahat ng iba pa
mga variable ng internasyonalisasyon.

LC_CTYPE Tukuyin ang lokal para sa interpretasyon ng mga pagkakasunud-sunod ng mga byte ng data ng teksto
bilang mga character (halimbawa, single-byte kumpara sa multi-byte na character sa
argumento at input file).

LC_MESSAGES
Tukuyin ang lokal na dapat gamitin upang makaapekto sa format at mga nilalaman ng
mga mensaheng diagnostic na nakasulat sa karaniwang error.

NLSPATH Tukuyin ang lokasyon ng mga katalogo ng mensahe para sa pagproseso ng LC_MESSAGES.

OPTIND Ang variable na ito ay dapat gamitin ng mga getopts utility bilang index ng susunod
argumentong ipoproseso.

ASYNCHRONOUS KAGANAPAN

Default.

STDOUT

Hindi ginagamit.

STDERR

Sa tuwing may nakitang error at ang unang character sa optstring ang operand ay hindi a
(':'), isang mensaheng diagnostic ay dapat isulat sa karaniwang error na may mga sumusunod
impormasyon sa hindi natukoy na format:

* Ang pangalan ng invoking program ay dapat matukoy sa mensahe. Ang invoking program
Ang pangalan ay ang halaga ng espesyal na parameter ng shell 0 (tingnan seksyon 2.5.2, espesyal
parameter) sa panahong ang mga getopts utility ay hinihingi. Isang pangalan na katumbas ng:

basename "$0"

maaaring magamit.

* Kung may nakitang opsyon na hindi tinukoy sa optstring, natukoy ang error na ito
at ang hindi wastong karakter ng opsyon ay dapat matukoy sa mensahe.

* Kung ang isang opsyon na nangangailangan ng isang opsyon-argument ay natagpuan, ngunit isang opsyon-argument ay hindi
natagpuan, ang error na ito ay dapat matukoy at ang hindi wastong karakter ng opsyon ay dapat
nakilala sa mensahe.

oUTPUT MGA FILE

Wala.

LALAKI DESCRIPTION

Wala.

EXIT STATUS

Ang mga sumusunod na exit value ay ibabalik:

0 Isang opsyon, tinukoy o hindi tinukoy ng optstring, ay natagpuan.

>0 Nakatagpo ang dulo ng mga opsyon o nagkaroon ng error.

Mga kahihinatnan OF MGA KAMALI

Default.

Ang sumusunod seksyon ay nagbibigay-kaalaman.

APLIKASYON PAGGAMIT

Dahil sa mga getopts nakakaapekto sa kasalukuyang kapaligiran ng pagpapatupad ng shell, ito ay karaniwang ibinibigay bilang
isang shell na regular na built-in. Kung ito ay tinatawag sa isang subshell o hiwalay na pagpapatupad ng utility
kapaligiran, tulad ng isa sa mga sumusunod:

(gettopts abakada halaga "$@")
nohup mga getopts ...
mahanap . −exec mga getopts ... \;

hindi ito nakakaapekto sa mga variable ng shell sa kapaligiran ng tumatawag.

Tandaan na ang mga function ng shell ay nagbabahagi OPTIND gamit ang calling shell kahit na positional
nababago ang mga parameter. Kung ang calling shell at alinman sa mga function nito ay gumagamit mga getopts sa
pag-parse ng mga argumento, ang mga resulta ay hindi natukoy.

HALIMBAWA

Ang sumusunod na halimbawang script ay nag-parse at nagpapakita ng mga argumento nito:

i-flag=
bflag=
habang mga getopts from: pangalan
do
kaso $pangalan in
a) aflag=1;;
b) bflag=1
bval="$OPTARG";;
?) printf "Paggamit: %s: [−a] [−b halaga] args\n" $0
lumabas 2;;
na C
tapos
if [ ! −z "$flag" ]; pagkatapos
printf "Pagpipilian −a tinukoy\n"
fi
if [ ! −z "$bflag" ]; pagkatapos
printf 'Pagpipilian −b "%s" tinukoy\n' "$bval"
fi
ilipat $(($OPTIND - 1))
printf "Natitira argumento ay: %s\n$*"

RATIONALE

Ang mga getopts Ang utility ay pinili bilang kagustuhan sa System V getopt utility dahil
mga getopts pinangangasiwaan ang mga opsyon-argumento na naglalaman ng mga karakter.

Ang OPTARG variable ay hindi binanggit sa ENVIRONMENT VARIABLE section dahil ginagawa nito
hindi makakaapekto sa pagpapatupad ng mga getopts; isa ito sa ilang mga variable na ``output-only'' na ginamit
sa pamamagitan ng karaniwang mga kagamitan.

Ang ay hindi pinapayagan bilang isang opsyon na karakter dahil hindi iyon makasaysayang pag-uugali,
at nilalabag nito ang Utility Syntax Guidelines. Ang ay tinukoy na ngayon upang kumilos bilang
sa bersyon ng KornShell ng mga getopts kagamitan; kapag ginamit bilang unang karakter sa
optstring operand, hindi nito pinapagana ang mga diagnostic tungkol sa mga nawawalang opsyon-argument at
hindi inaasahang mga character na pagpipilian. Pinapalitan nito ang paggamit ng OPTERR variable na noon
tinukoy sa isang maagang panukala.

Ang mga format ng mga diagnostic na mensahe na ginawa ng mga getopts utility at ang getopt()
Ang function ay hindi ganap na tinukoy dahil ang mga pagpapatupad na may superior (``friendlier'')
tumutol ang mga format sa mga format na ginamit ng ilang makasaysayang pagpapatupad. Ang pamantayan
Itinuring ng mga developer na mahalaga na ang impormasyon sa mga mensaheng ginamit ay magkatulad
sa pagitan ng mga getopts at getopt(). Maaaring hindi posible ang eksaktong pagdoble ng mga mensahe,
partikular na kung ang isang utility ay binuo sa ibang sistema na may iba getopt()
function, ngunit ang mga mensahe ay dapat na may partikular na impormasyon na kasama upang ang programa
pangalan, hindi wastong karakter ng opsyon, at uri ng error ay maaaring makilala ng isang user.

Isang bihirang application program lamang ang humarang a mga getopts karaniwang mensahe ng error at nais na
i-parse ito. Samakatuwid, ang mga pagpapatupad ay malayang pumili ng pinakanagagamit na mga mensahe na kaya nila
mag-isip. Ang mga sumusunod na format ay ginagamit ng maraming makasaysayang pagpapatupad:

"%s: ilegal opsyon −− %c\n", <programa pangalan>, <opsyon katangian>

"%s: ang opsyon ay nangangailangan ng argumento −− %c\n",programa pangalan>, \
<opsyon katangian>

Mga makasaysayang shell na may mga built-in na bersyon ng getopt() o mga getopts gumamit ng iba
mga format, madalas na hindi man lang nagsasaad ng opsyon na character na natagpuan sa error.

PAGTATAYA DIREKSYON

Wala.

Gamitin ang getoptsposix online gamit ang mga serbisyo ng onworks.net