antlr4 - Online en la nube

PROGRAMA:

NOMBRE

ANTLR: otra herramienta para el reconocimiento de idiomas, versión 4

SINOPSIS

antlr4 [opciones] archivo.g4 [ archivo2.g4 archivo3.g4 ...]

DESCRIPCIÓN

ANTLR (otra herramienta para el reconocimiento de idiomas) es un generador de analizador para lectura,
procesar, ejecutar o traducir texto estructurado o archivos binarios. Es muy utilizado para
construir lenguajes, herramientas y marcos. A partir de una gramática, ANTLR genera un analizador que puede
construir y caminar árboles de análisis sintáctico.

OPCIONES

-o exterior
Especifique el directorio de salida donde se genera toda la salida.

ANTLR genera archivos de salida en el directorio actual de forma predeterminada. Esta opción
especifica el directorio de salida donde ANTLR debe generar analizadores, oyentes,
visitantes y archivos de tokens.

-lib dir
Especifique la ubicación de gramáticas, archivos de tokens.

Al buscar archivos de tokens y gramáticas importadas, ANTLR normalmente busca en el
directorio actual. Esta opción especifica en qué directorio buscar. Está
solo se usa para resolver referencias gramaticales para la declaración de importación y la
opción tokenVocab. La ruta a la gramática primaria siempre debe especificarse completamente.

-atn Genere diagramas de red de transición con reglas aumentadas.

Esta opción genera archivos de gráficos DOT que representan el ATN interno (aumentado
red de transición) estructuras de datos que ANTLR utiliza para representar gramáticas. los
los archivos aparecen como Grammar.rule .dot. Si la gramática es una gramática combinada, la
Las reglas de lexer se denominan Grammar Lexer.rule .dot.

-codificación nombre de codificación
Especifique la codificación del archivo de gramática; por ejemplo, euc-jp.

Por defecto, ANTLR carga archivos gramaticales usando la codificación UTF-8, que es muy
codificación de archivos de caracteres comunes que degenera en ASCII para caracteres que encajan en
un byte. Si ese archivo de gramática no es la codificación predeterminada para su configuración regional,
Necesita esta opción para que ANTLR pueda interpretar correctamente los archivos gramaticales. Esto no lo hace
afectar la entrada a los analizadores generados, solo la codificación de las gramáticas


-formato-de-mensaje formato
Especifique el estilo de salida para los mensajes en antlr, gnu, vs2005.

ANTLR genera mensajes de advertencia y error utilizando plantillas del directorio
herramienta / recursos / org / antlr / v4 / herramienta / plantillas / mensajes / formatos. Por defecto, ANTLR
utiliza el archivo antlr.stg (grupo StringTemplate). Puede cambiar esto a 'gnu' o
'vs2005' para que ANTLR genere mensajes apropiados para Emacs o Visual Studio. Para
haz tu propio llamado X, crea recurso
org / antlr / v4 / tool / templates / messages / format / X y colóquelo en CLASSPATH.

-mensajes-largos
Muestre los detalles de la excepción cuando estén disponibles para errores y advertencias.

-oyente
Generar oyente de árbol de análisis (predeterminado).

-no-oyente
No genere un oyente de árbol de análisis.

-visitante
Generar visitante de árbol de análisis.

ANTLR puede generar tanto oyentes como visitantes del árbol de análisis; esta opción y
-oyente no son mutuamente excluyentes.

-no-visitante
No genere un visitante del árbol de análisis (predeterminado).

-paquete Nombre del paquete
Especifique un paquete / espacio de nombres para el código generado.

Utilice esta opción para especificar un paquete o espacio de nombres para archivos generados por ANTLR.
Alternativamente, puede agregar una acción @header {...} pero eso vincula la gramática a una
lenguaje específico. Si usa esta opción y @header, asegúrese de que el encabezado
La acción no contiene una especificación de paquete; de ​​lo contrario, el código generado
tener dos de ellos.

-depender
Genera dependencias de archivos.

En lugar de generar un analizador y / o un lexer, genere una lista de dependencias de archivos,
una por línea. El resultado muestra de qué depende cada gramática y qué genera.
Esto es útil para construir herramientas que necesitan conocer las dependencias gramaticales de ANTLR.

Si utiliza -lib libdir con -depender y la opción gramatical tokenVocab = A, luego la
las dependencias también incluyen la ruta de la biblioteca.

-Xforce-atn usa el simulador ATN para todas las predicciones
-Xlog descarga mucha información de registro en antlr-timestamp.log

-D =
Establecer o anular una opción de nivel gramatical.

Esta opción es útil para generar analizadores en diferentes idiomas sin
alterando la gramática en sí (con --Dlanguage = CSharp por ejemplo).

-Error
Trate las advertencias como errores.

Como parte de una gran compilación, los mensajes de advertencia ANTLR podrían pasar desapercibidos. Enciende esto
opción para que las advertencias se traten como errores, lo que hace que la herramienta ANTLR informe fallas
de nuevo al shell de línea de comandos que invoca.

-XdbgST
Inicie el visualizador StringTemplate en el código generado.

Para aquellos que crean un objetivo de generación de código, esta opción abre una ventana que muestra
el código generado y las plantillas utilizadas para generar ese código. Invoca el
Ventana del inspector StringTemplate.

-XdbgSTEspere
Espere a que STViz se cierre antes de continuar.

-Xforce-atn
Utilice el simulador ATN para todas las predicciones.

ANTLR normalmente crea decisiones tradicionales de "tipo de token de activación" siempre que sea posible
(una muestra de anticipación es suficiente para distinguir entre todas las alternativas en un
decisión). Para forzar incluso estas decisiones simples en el mecanismo adaptativo LL (*),
utilice esta opción.

-Xlog Vierta mucha información de registro en antlr-timestamp.log.

Esta opción crea un archivo de registro que contiene muchos mensajes de información de ANTLR
mientras procesa tu gramática. Si desea ver cómo ANTLR traduce su
reglas recursivas a la izquierda, active esta opción y busque en el archivo de registro resultante.

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