GETOPTS(1)                                           GETOPTS(1)
НАЗВАНИЕ
getopts - разбор опций команды
СИНТАКСИС
       |getopts  цепочка_опций имя [аргумент ...]
ОПИСАНИЕ
Команда getopts используется shell-процедурами для раз-
        бора позиционных параметров и проверки опций на  допус-
        тимость. Команда getopts  поддерживает  все  применимые
        правила стандартного синтаксиса команд  [см.  intro(1),
        правила 3-10].
        Цепочка_опций должна  содержать  флаги,  которые  будут
        распознаваться shell-процедурой, использующей  getopts.
        Если за флагом следует  двоеточие,  то  предполагается,
        что опция имеет аргумент или группу аргументов, которые
        должны отделяться от флага пробелами или табуляциями.
        После каждого вызова getopts помещает следующую опцию в
        переменную имя, а номер аргумента, который должен  быть
        обработан следующим, -  в  переменную  OPTIND.  Всегда,
        когда запускается shell или shell-процедура, OPTIND по-
        лучает значение 1.
        
Если опции требуется аргумент, то getopts помещает  его
        в переменную OPTARG.
         
        Если встретилась некорректная опция,  то  в  переменную
        имя помещается ?.
        
Если опции кончились, getopts возвращает ненулевой  код
        завершения. Можно использовать  специальную  опцию  --,
        чтобы отметить конец опций.                            
                                                               
        По  умолчанию команда getopts разбирает позиционные па-
        раметры вызвавшей ее shell-процедуры, но  если  указать
        дополнительные  аргументы,  то  getopts будет разбирать
        их.                                                    
                                                               
ПРИМЕР                                                         
        Следующий фрагмент shell-процедуры cmd показывает,  как
        можно обработать аргументы команды, допускающей опции a
        и b, а также опцию o, которая должна иметь аргумент:   
                                                               
            |while getopts abo: c                              
            |do                                                
            |  case $c in 
            |  a | b)  FLAG=$c;;
            |  o)      OARG=$OPTARG;;                          
            |  ?)      echo $USAGE
            |          exit 2;;
            |  esac                                            
            |done        
            |shift `expr  $OPTIND - 1`
                                                               
        При такой обработке следующие строки оказываются  экви-
        валентными:                
            |cmd -a -b -o "xxx z yy" file                      
            |cmd -a -b -o "xxx z yy" -- file                   
            |cmd -ab -o xxx,z,yy  file                         
            |cmd -ab -o "xxx z yy" file
            |cmd -o xxx,z,yy -b -a  file
      
ПРИМЕЧАНИЯ                                                     
        Утверждение о эквивалентности предыдущих строк не впол-
        не верно:                                           
        1.   В последней строке опции b и a идут в ином  поряд-
             ке, чем в предыдущих, и так как в  данном  примере
             эти опции помещаются в одну  переменную  FLAG,  то
             при обработке последней строки окончательное  зна-
             чение этой переменной окажется  не  таким,  как  в
             предыдущих строках.  
                               
        2.   В тех строках, в которых аргумент опции o задан  в
             виде "xxx z yy", OARG примет значение xxx z yy,  а
             в тех строках, где  аргумент  опции  o  задан  как
             xxx,z,yy, OARG будет равен xxx,z,yy.
                                                               
ФАЙЛЫ              
        /usr/bin/getopt         Старая версия программы разбора
                                опций.   
        /usr/lib/getoptcvt      Программа перевода shell-проце-
                                дур, использовавших getopt,  на
                                getopts.
                                        
СМ. ТАКЖЕ
        gutil(1G), intro(1), sh(1).
        getopt(3C) в Справочнике программиста.                 
                 
ДИАГНОСТИКА
        Команда getopts выводит сообщение об ошибке в стандарт
        ный протокол, когда встречается опция, не включенная  в
        цепочку_опций.                                         
                                                               
ПРЕДОСТЕРЕЖЕНИЯ                                                
        Хотя текущая  реализация  getopts  допускает  некоторые
        отступления от правил, задающих синтаксис  команд  [см.
        intro(1)], этим не следует пользоваться, так как подоб-
        ные возможности могут  не  поддерживаться  в  следующих
        версиях системы. Пусть, как и в ПРИМЕРЕ, a и b -  опции
        без аргументов, а опции o требуется аргумент:
            |cmd  -aboxxx file
                                                               
        Здесь нарушено правило 5: опция с аргументом не  должна
        быть в одной группе с остальными опциями.              
                                                               
            |cmd  -ab -oxxx file        
        Нарушено правило 6: после опции, которой требуется  ар-
        гумент, должен быть пробел или табуляция.
                                              
        Изменение значения переменной OPTIND или разбор различ-
        ных наборов аргументов могут привести к непредсказуемо-
        му результату.@