getopt - Online en la nube

PROGRAMA:

NOMBRE

getopt - opciones de comando de análisis (mejorado)

SINOPSIS

conseguiroptar cadena de opciones parámetros
conseguiroptar [opciones] [--] cadena de opciones parámetros
conseguiroptar [opciones] -o|--opciones cadena de opciones [opciones] [--] parámetros

DESCRIPCIÓN

conseguiroptar se usa para romperanalizar gramaticalmente) opciones en las líneas de comando para facilitar el análisis por shell
procedimientos y para verificar opciones legales. Utiliza GNU conseguiroptar(3) rutinas para hacer
esta.

Los parametros conseguiroptar se llama con se puede dividir en dos partes: opciones que modifican
el camino conseguiroptar hará el análisis (el opciones y la cadena de opciones en la categoría Industrial. SINOPSIS), o
los parámetros que se van a analizar (parámetros en la categoría Industrial. SINOPSIS). La segunda parte
comenzar en el primer parámetro que no sea una opción que no sea un argumento de opción, o después del primer
Ocurrencia de '--'. Si no '-o"O"--opciones'se encuentra en la primera parte, la
El primer parámetro de la segunda parte se utiliza como cadena de opciones corta.

Si la variable de entorno GETOPT_COMPATIBLE está configurado, o si el primer parámetro no es un
opción (no comienza con un '-', el primer formato en el SINOPSIS), conseguiroptar Generará
salida que es compatible con la de otras versiones de conseguiroptar(1). Todavía lo hará
barajar parámetros y reconocer argumentos opcionales (ver sección COMPATIBILIDAD
información).

Implementaciones tradicionales de conseguiroptar(1) son incapaces de hacer frente a los espacios en blanco y otros
Caracteres especiales (específicos de shell) en argumentos y parámetros que no son de opción. Para solucionar esto
problema, esta implementación puede generar una salida cotizada que una vez más debe ser
interpretado por la cáscara (generalmente usando el eval mando). Esto tiene el efecto de
preservando esos personajes, pero debes llamar conseguiroptar de una manera que ya no es
compatible con otras versiones (el segundo o tercer formato en el SINOPSIS). Para determinar
si esta versión mejorada de conseguiroptar(1) está instalado, una opción de prueba especial (-T) puede ser
usado.

OPCIONES

-a, --alternativa
Permita que las opciones largas comiencen con una sola '-'.

-h, --ayuda
Mostrar texto de ayuda y salir. No se genera ninguna otra salida.

-l, --longopciones Longopts
Las opciones largas (de varios caracteres) que se van a reconocer. Más de un nombre de opción puede
ser especificado de una vez, separando los nombres con comas. Esta opción puede ser
dado más de una vez, el Longopts son acumulativos. Cada nombre de opción largo en
Longopts puede ir seguido de dos puntos para indicar que tiene un argumento requerido, y
con dos dos puntos para indicar que tiene un argumento opcional.

-n, --nombre nombre del programa
El nombre que utilizará el conseguiroptar(3) rutinas cuando informa errores. Nota
que errores de conseguiroptar(1) todavía se informa que provienen de getopt.

-o, --opciones opciones cortas
Las opciones cortas (de un carácter) que se van a reconocer. Si no encuentra esta opción,
el primer parámetro de conseguiroptar que no empieza con un '-'(y no es una opción
argumento) se utiliza como la cadena de opciones corta. Cada carácter de opción corta en
opciones cortas puede ir seguido de dos puntos para indicar que tiene un argumento requerido, y
con dos dos puntos para indicar que tiene un argumento opcional. El primer personaje de
los shortopts pueden ser '+"O"-'para influir en la forma en que se analizan las opciones y la salida se
generado (ver sección EXPLORACIÓN MODOS para más detalles).

-q, --tranquilo
Deshabilitar el informe de errores por conseguiroptar(3).

-Q, - salida silenciosa
No genere una salida normal. Los errores aún los informa conseguiroptar(3), a menos que
también usar -q.

-s, --cáscara shell
Establecer convenciones de cotización a las de shell. Si el -s no se da la opción, el BASH
se utilizan convenciones. Los argumentos válidos son actualmente 'sh''golpear','csh'y
'tcsh'.

-T, --prueba
Prueba si tu conseguiroptar(1) es esta versión mejorada o una versión anterior. Esto genera
sin salida y establece el estado de error en 4. Otras implementaciones de conseguiroptar(1), y
esta versión si la variable de entorno GETOPT_COMPATIBLE está configurado, volverá '--'
y estado de error 0.

-u, --no cotizado
No cite la salida. Tenga en cuenta que los espacios en blanco y especiales (dependientes de shell)
Los personajes pueden causar estragos en este modo (como lo hacen con otros conseguiroptar(1)
implementaciones).

-V, --versión
Muestra la información de la versión y sale. No se genera ninguna otra salida.

ANÁLISIS

Esta sección especifica el formato de la segunda parte de los parámetros de conseguiroptar (la
parámetros en la categoría Industrial. SINOPSIS). La siguiente sección (SALIDA) describe la salida que es
generado. Estos parámetros eran típicamente los parámetros a los que se llamaba una función de shell
con. Se debe tener cuidado de que cada parámetro con el que se llamó a la función de shell
corresponde exactamente a un parámetro en la lista de parámetros de conseguiroptar (Véase el EJEMPLOS).
Todo el análisis lo realiza GNU conseguiroptar(3) rutinas.

Los parámetros se analizan de izquierda a derecha. Cada parámetro se clasifica como un corto
opción, una opción larga, un argumento para una opción o un parámetro que no es una opción.

Una opción corta y sencilla es '-'seguido de un carácter de opción corto. Si la opción tiene un
argumento requerido, puede escribirse directamente después del carácter de opción o como el siguiente
parámetro (es decir, separado por espacios en blanco en la línea de comando). Si la opción tiene un
argumento opcional, debe escribirse directamente después del carácter de opción si está presente.

Es posible especificar varias opciones cortas después de una '-', siempre que todos (excepto
posiblemente el último) no tienen argumentos obligatorios u opcionales.

Una opción larga normalmente comienza con '--'seguido del nombre largo de la opción. Si la opcion
tiene un argumento requerido, se puede escribir directamente después del nombre largo de la opción, separado
por '=', o como el siguiente argumento (es decir, separados por espacios en blanco en la línea de comando). Si
la opción tiene un argumento opcional, debe escribirse directamente después de la opción larga
nombre, separado por '=', si está presente (si agrega el'='pero nada detrás, es
interpretado como si no hubiera ningún argumento presente; este es un pequeño error, vea el LOCO). Largo
las opciones pueden abreviarse, siempre que la abreviatura no sea ambigua.

Cada parámetro que no comienza con un '-', y no un argumento obligatorio de una opción anterior,
es un parámetro que no es de opción. Cada parámetro después de un '--'parámetro siempre se interpreta como
un parámetro que no es de opción. Si la variable de entorno POSIXLY_CORRECT está configurado, o si el
cadena de opción corta que comienza con un '+', todos los parámetros restantes se interpretan como
parámetros que no son de opción tan pronto como se encuentra el primer parámetro que no es de opción.

SALIDA

La salida se genera para cada elemento descrito en la sección anterior. La salida se realiza en
el mismo orden en que se especifican los elementos en la entrada, excepto para la no opción
parámetros. La salida se puede hacer en compatible (no cotizado) modo, o de tal manera que
los espacios en blanco y otros caracteres especiales dentro de los argumentos y los parámetros que no son de opción son
conservado (ver COTIZAR). Cuando la salida se procesa en el script de shell, parecerá
estar compuesto de distintos elementos que se pueden procesar uno por uno (utilizando el cambio
comando en la mayoría de los lenguajes de shell). Esto es imperfecto en modo sin comillas, ya que los elementos pueden ser
dividir en lugares inesperados si contienen espacios en blanco o caracteres especiales.

Si hay problemas al analizar los parámetros, por ejemplo, porque se requiere un argumento
no se encuentra o no se reconoce una opción, se informará un error en stderr, habrá
no hay salida para el elemento infractor y se devuelve un estado de error distinto de cero.

Para una opción corta, un solo '-'y el carácter de opción se generan como un parámetro.
Si la opción tiene un argumento, el siguiente parámetro será el argumento. Si la opcion
toma un argumento opcional, pero no se encontró ninguno, se generará el siguiente parámetro pero
estar vacío en el modo de cotización, pero no se generará un segundo parámetro en unquoted
(modo compatible. Tenga en cuenta que muchos otros conseguiroptar(1) las implementaciones no admiten opcional
argumentos

Si se especificaron varias opciones cortas después de una sola '-', cada uno estará presente en el
salida como un parámetro separado.

Para una opción larga, '--'y el nombre completo de la opción se generan como un parámetro. Este es
hecho independientemente de si la opción fue abreviada o especificada con un solo '-' en el
aporte. Los argumentos se manejan como con opciones cortas.

Normalmente, no se genera ninguna salida de parámetros que no sean de opción hasta que todas las opciones y sus
Se han generado argumentos. Luego '--'se genera como un solo parámetro, y después
los parámetros que no son de opción en el orden en que se encontraron, cada uno como un parámetro separado.
Solo si el primer carácter de la cadena de opciones corta era un '-', parámetro sin opción
la salida se genera en el lugar donde se encuentran en la entrada (esto no es compatible si el
primer formato del SINOPSIS se utiliza; en ese caso todas las apariciones precedentes de '-'y
'+'se ignoran).

COTIZAR

En modo compatible, espacios en blanco o caracteres 'especiales' en argumentos o sin opción
los parámetros no se manejan correctamente. A medida que la salida se envía al script de shell, el
script no sabe cómo se supone que debe dividir la salida en parámetros separados. Para
Para evitar este problema, esta implementación ofrece cotizaciones. La idea es que la salida sea
generado con comillas alrededor de cada parámetro. Cuando esta salida se alimenta de nuevo al
caparazón (generalmente por un caparazón eval comando), se divide correctamente en parámetros separados.

La cotización no está habilitada si la variable de entorno GETOPT_COMPATIBLE está configurado, si el primer
forma de la SINOPSIS se utiliza, o si la opción '-u' es encontrado.

Diferentes shells utilizan diferentes convenciones de cotización. Puede utilizar el '-s'opción para seleccionar
el caparazón que está utilizando. Actualmente se admiten los siguientes shells: 'sh','golpear',
'csh"Y"tcsh'. En realidad, solo se distinguen dos 'sabores': comillas tipo sh
convenciones y convenciones de citas similares a csh. Lo más probable es que si usa otro caparazón
lenguaje de escritura, uno de estos sabores todavía se puede utilizar.

EXPLORACIÓN MODOS

El primer carácter de la cadena de opciones corta puede ser un '-'o un'+'para indicar un
modo de escaneo especial. Si el primer formulario de llamada en el SINOPSIS se usa ellos son
ignorado la variable de entorno POSIXLY_CORRECT Sin embargo, todavía se examina.

Si el primer carácter es '+', o si la variable de entorno POSIXLY_CORRECT Está establecido,
el análisis se detiene tan pronto como el primer parámetro que no es de opción (es decir, un parámetro que no
empezar con un '-') se encuentra que no es un argumento de opción. Los parámetros restantes son
todos interpretados como parámetros no opcionales.

Si el primer carácter es un '-', los parámetros que no son de opción se generan en el lugar donde
se encuentran; en funcionamiento normal, todos se recopilan al final de la salida después de un
'--'se ha generado el parámetro. Tenga en cuenta que esto '--'todavía se genera el parámetro, pero
siempre será el último parámetro en este modo.

COMPATIBILIDAD

Esta versión de conseguiroptar(1) está escrito para ser lo más compatible posible con otras versiones.
Por lo general, puede reemplazarlos con esta versión sin ninguna modificación y con
algunas ventajas.

Si el primer carácter del primer parámetro de getopt no es un '-', conseguiroptar entra en
modo de compatibilidad. Interpretará su primer parámetro como la cadena de opciones cortas,
y se analizarán todos los demás argumentos. Seguirá barajando parámetros (es decir, todos
los parámetros que no son de opción se emiten al final), a menos que la variable de entorno
POSIXLY_CORRECT se establece.

La variable de entorno GETOPT_COMPATIBLE efectivo conseguiroptar en modo de compatibilidad. Configuración
tanto esta variable de entorno como POSIXLY_CORRECT ofrece 100% de compatibilidad para
programas 'difíciles'. Sin embargo, por lo general, no se necesita ninguno.

En modo de compatibilidad, liderando '-"Y"+'los caracteres en la cadena de opciones corta son
ignorado

DEVOLUCION Codigos

conseguiroptar devuelve el código de error 0 para un análisis exitoso, 1 if conseguiroptar(3) devuelve errores, 2 si se
no comprende sus propios parámetros, 3 si se produce un error interno como memoria insuficiente,
y 4 si se llama con -T.

EJEMPLOS

Los scripts de ejemplo para (ba) sh y (t) csh se proporcionan con el conseguiroptar(1) distribución y
se instalan opcionalmente en / usr / share / getopt / or / usr / share / doc / en el util-linux
subdirectorio.

MEDIO AMBIENTE

POSIXLY_CORRECT
Esta variable de entorno es examinada por el conseguiroptar(3) rutinas. Si está configurado,
el análisis se detiene tan pronto como se encuentra un parámetro que no es una opción u opción
argumento. Todos los parámetros restantes también se interpretan como parámetros no opcionales,
independientemente de si comienzan con un '-'.

GETOPT_COMPATIBLE
Fuerzas conseguiroptar para usar el primer formato de llamada como se especifica en el SINOPSIS.

Utilice getopt en línea utilizando los servicios de onworks.net