gccxml: en línea en la nube

PROGRAMA:

NOMBRE

gccxml - Cree una representación XML de declaraciones de C ++.

SINOPSIS

gccxml [opciones] -fxml =

DESCRIPCIÓN

GCC-XML analiza un archivo fuente de C ++ tal como lo ve el compilador cuando se crea. Un fácil-
para analizar la representación XML de las declaraciones de clase, función y espacio de nombres se vuelca
a un archivo especificado. El preprocesamiento completo de C transforma el archivo en una unidad de traducción de C ++
como lo ve el compilador. Esto significa que GCC-XML debería utilizar el mismo estándar
biblioteca y otros archivos de encabezado como compilador. GCC-XML se puede configurar para simular cualquier
de varios compiladores populares.

CAMPUS

Las siguientes opciones están disponibles para ejecutar GCC-XML:

--derechos de autor
Imprima los derechos de autor de GCC-XML y salga.

--depurar
Imprima información adicional de depuración. Esta opción hace que GCC-XML imprima el
nombre del ejecutable y argumentos de la línea de comandos utilizados para ejecutar el GCC C ++ parcheado
analizador. Esto es útil cuando se intenta simular un compilador no compatible.

-fxml =
Especifique el archivo de salida XML. Esta opción se pasa directamente al GCC parcheado
Analizador de C ++. Habilita el volcado XML y especifica el nombre del archivo de salida.

-fxml-inicio = [, ...]
Especifique una lista de declaraciones iniciales. Esta opción se transmite directamente al
analizador GCC C ++ parcheado. Solo es significativo si también se especifica -fxml =. Esta
especifica una lista separada por comas de declaraciones iniciales con nombre. GCC-XML se volcará
solo el subconjunto de las declaraciones en la unidad de traducción que es accesible
a través de una secuencia de referencias de fuentes de uno de los valores iniciales especificados
declaraciones.

- compilador gccxml
Establezca GCCXML_COMPILER en "xxx".

--gccxml-cxxflags
Establezca GCCXML_CXXFLAGS en "xxx".

--gccxml-ejecutable
Establezca GCCXML_EXECUTABLE en "xxx".

--gccxml-cpp
Establezca GCCXML_CPP en "xxx".

--gccxml-config
Establezca GCCXML_CONFIG en "xxx".

--gccxml-raíz
Establezca GCCXML_ROOT en "xxx".

--gccxml-gcc-opciones
Lea las opciones de GCC del archivo "xxx". Esta opción especifica un archivo desde el que leer
opciones para pasar al analizador GCC C ++ parcheado. Esto es útil para especificar un
larga lista de directorios de inclusión. Cada línea del archivo se convierte en una opción. Vacío
las líneas y las líneas que comienzan en '#' se ignoran.

--ayuda Imprima la ayuda completa y salga. La ayuda completa muestra la mayor parte de la documentación proporcionada por
la página de manual de UNIX. Se proporciona para su uso en plataformas que no son UNIX, pero también
conveniente si la página de manual no está instalada.

--ayuda-html
Imprime la ayuda completa en formato HTML. Los autores de GCC-XML utilizan esta opción para ayudar
producir páginas web.

--hombre Imprima una página de manual de UNIX y salga. Los autores de GCC-XML utilizan esta opción para generar
la página de manual de UNIX.

--impresión
Imprima los ajustes de configuración y salga. GCC-XML tiene muchas opciones de configuración para
ayúdelo a simular otro compilador. El uso de esta opción hará que GCC-XML
configurarse como si fuera a analizar la fuente de C ++, pero se detiene e imprime
la configuración encontrada. Esto es útil para verificar la configuración.

--preproceso
Procesar previamente la entrada y salir. GCC-XML simula el proprocesador de otro
compilador. El uso de esta opción hará que GCC-XML se configure como si fuera
va a analizar la fuente de C ++, pero se detiene después del preprocesamiento. Esto es útil para
problemas de depuración relacionados con la simulación del otro compilador.

-E Alias ​​de --preprocess.

--versión
Muestre el banner de nombre / versión del programa y salga.

Otros indicadores, como -I y -D, se pasan al ejecutable del analizador GCC C ++ parcheado.

AJUSTES

GCC-XML está diseñado para simular el analizador de un compilador mientras lee el código fuente de C ++. Algunos
Se necesitan ajustes de configuración para determinar cómo simular un compilador particular de
la elección del usuario. Se pueden utilizar los siguientes ajustes para configurar GCC-XML:

GCCXML_COMPILER
El compilador de C ++ que se va a simular. GCC-XML intentará determinar automáticamente
cómo simular el compilador especificado por esta configuración. El compilador está especificado
por su nombre ejecutable (como "g ++"). Para Visual Studio, el compilador es
especificado por "msvc6", "msvc7", "msvc71" o "msvc8" (si se proporciona "cl", GCC-XML
intenta adivinar qué VS usar).

GCCXML_CXXFLAGS
Los indicadores del compilador de C ++ que se van a simular. El comportamiento de la mayoría de los compiladores puede
ser ajustado especificando banderas en la línea de comando. Cuando GCC-XML intenta
determinar automáticamente cómo simular un compilador, estos indicadores se toman en
consideración.

GCCXML_CONFIG
El archivo de configuración para configuraciones comunes. Cuando las configuraciones no predeterminadas son a menudo
utilizados, es conveniente escribir un solo archivo que los contenga. Cuando tal archivo es
especificado, se leerá para configurar los ajustes que aún no se conocen. Cada
línea del archivo consta de una asignación de la forma CLAVE = "VALOR" (por ejemplo,
GCCXML_COMPILER = "g ++").

GCCXML_EXECUTABLE
Especifique el ejecutable del analizador GCC C ++ parcheado. El programa GCC-XML visto por el
El usuario es en realidad un front-end que determina los indicadores necesarios para configurar el
analizador GCC C ++ parcheado para simular otro compilador. Esta configuración especifica el
ejecutable real para que se ejecute una vez que se hayan determinado las banderas. Los usuarios rara vez deberían
necesita cambiar este valor de su valor predeterminado.

GCCXML_CPP
Especifique el ejecutable del preprocesador de GCC C. El programa GCC-XML como lo ve el usuario
es en realidad un front-end que determina los indicadores necesarios para configurar el parche
Analizador de GCC C ++ para simular otro compilador. Esta configuración especifica el
preprocesador para ejecutar con los indicadores que se han determinado para la depuración
propósitos. Los usuarios rara vez deberían necesitar cambiar este valor de su valor predeterminado.

GCCXML_ROOT
El directorio de la biblioteca de soporte GCC-XML. Dado que GCC-XML es solo un analizador de C ++,
no puede duplicar exactamente la funcionalidad de cada compilador que intenta simular.
Algunos compiladores proporcionan encabezados estándar con código que GCC-XML no puede directamente
resolver. Para evitar esta limitación, se proporciona una biblioteca de soporte para cada
compilador. Consiste en un conjunto de archivos de encabezado que se utilizan en lugar del
encabezados del sistema del compilador. Estos archivos contienen ligeros ajustes y luego incluyen el
correspondiente encabezado real. La raíz del árbol de directorios que contiene estos soportes
Los encabezados de biblioteca se especifican mediante esta configuración. Los usuarios rara vez deberían necesitar cambiar
este valor de su valor predeterminado.

GCCXML_FLAGS
Banderas utilizadas para simular el otro compilador. Cuando GCC-XML ejecuta GCC C ++ parcheado
analizador, estos indicadores se pasan al programa para indicarle cómo simular un
compilador particular. Esta configuración generalmente se detecta automáticamente desde el otro
configuración, pero los usuarios avanzados pueden especificarla directamente. La mayoría de los usuarios deberían
No intente cambiar este valor de la configuración automática.

GCCXML_USER_FLAGS
Indicadores de usuario adicionales para la simulación del compilador. Cuando GCC-XML ejecuta el GCC parcheado
Analizador C ++, estos indicadores se pasan además de los especificados por GCCXML_FLAGS.
Esto permite a los usuarios avanzados modificar la simulación del compilador sin dejar de utilizar el
configuración automática de GCCXML_FLAGS. Los usuarios rara vez deberían necesitar cambiar esto
valor de su valor predeterminado.

Hay varios medios por los cuales se configuran estos ajustes. Se enumeran aquí en
orden de precedencia (el más alto primero):

Línea de comando Opciones
La configuración se puede especificar mediante sus opciones correspondientes. Cuando un entorno
Se proporciona la opción de línea de comandos correspondiente, se usa a favor sobre cualquier otra
medios de configuración. Si GCCXML_CONFIG está configurado en la línea de comandos, la configuración es
leer desde el archivo con precedencia un poco más baja que otra línea de comando
.

Entorno Variables
Los ajustes se configuran por nombre en el entorno. Cada ajuste aún no se conoce
se lee de una variable de entorno con su nombre. Si GCCXML_CONFIG lo establece el
entorno, las configuraciones se leen del archivo con una precedencia ligeramente menor
que otras variables de entorno.

Configuración archivos
Se realiza una búsqueda de GCCXML_CONFIG. Si aún no se ha configurado GCCXML_CONFIG,
se intenta encontrar un archivo de configuración automáticamente. Primero, si el archivo
$ HOME / .gccxml / config existe, se utilizará. En segundo lugar, si se está ejecutando GCC-XML
desde su directorio de compilación, se utilizará un archivo de configuración de ese directorio. Finalmente,
si se encuentra un archivo de configuración en el directorio de la biblioteca de soporte de la instalación,
ser usado. Una vez encontrada, cualquier configuración desconocida se lee del archivo de configuración.

Adivinación
Las conjeturas se basan en otros escenarios. Una vez que se ha configurado GCCXML_COMPILER, es
se utiliza para encontrar automáticamente la configuración de GCCXML_FLAGS. Si no está configurado,
La variable de entorno "CXX" se comprueba como último recurso para encontrar la configuración del compilador.
y determinar GCCXML_FLAGS.

La mayoría de los usuarios no deberían tener que ajustar los valores predeterminados de esta configuración. Hay un defecto
Archivo GCCXML_CONFIG proporcionado en el directorio de la biblioteca de soporte después de la instalación. Eso
configura GCC-XML para simular el compilador que se usó para construirlo.

COMPILADORES

GCC-XML puede simular cualquiera de los siguientes compiladores:

GCC Versiones 4.2, 4.1, 4.0, 3.4, 3.3, 3.2, 2.95.x

Visual C + +
Versiones 8, 7.1, 7.0 y 6 (sp5)

Borland Intel, SGI
anteriormente admitido pero ya no probado

Se proporcionan las siguientes definiciones de preprocesador C adicionales:

-D__GCCXML __ = MMmmpp
MM, mm y pp son las versiones principales, secundarias y de parche de GCC-XML. Esta
El símbolo de preprocesador identifica GCC-XML en el código fuente a medida que se procesa previamente.
Se puede utilizar para habilitar información específica de GCC-XML.

-D__GCCXML_GNUC __ = M
Definido para la versión principal del analizador GCC interno.

-D__GCCXML_GNUC_MINOR __ = m
Definido para la versión secundaria del analizador GCC interno.

-D__GCCXML_GNUC_PATCHLEVEL __ = p
Definido en el nivel de parche del analizador GCC interno.

Los usuarios avanzados pueden simular otros compiladores configurando manualmente GCCXML_FLAGS
configuración. Comuníquese con la lista de correo para obtener ayuda.

METENFO

GCC-XML ha agregado un nuevo atributo al conjunto legal de atributos C / C ++. El atributo es
utilizado para adjuntar metainformación al código fuente de C / C ++, que luego aparecerá en el XML
producción. La sintaxis para declarar un atributo es la siguiente:

__attribute ((gccxml ( , , ...)))
Aquí es una cadena entre comillas. Debe haber al menos un argumento para la
atributo 'gccxml', pero no hay límite superior para el número total de argumentos.
Se verifica que cada argumento sea una cadena; si se encuentra un argumento que no sea una cadena,
se ignora el atributo.

La salida XML para el elemento de código que está etiquetado con el atributo contendrá
el seguimiento:

atributos = " ... gccxml ( , , ...) ...
El atributo XML 'atributos' contiene todos los atributos aplicados al elemento de código.
Cada argumento del atributo se imprime sin entre comillas, por lo que si un
El argumento contiene el carácter ',', el argumento parecerá ser múltiple
argumentos

El atributo 'gccxml' se puede aplicar a cualquier declaración, incluidas estructuras, clases,
campos, parámetros, métodos, funciones, variables y typedefs. La única excepción es
que el manejo de GCC del elemento de lenguaje '__attribute' está actualmente roto por
enumeraciones y constructores con un cuerpo en línea. Se puede utilizar el atributo 'gccxml'
cualquier número de veces en una declaración determinada.

Como ejemplo de cómo se puede utilizar este atributo para adjuntar metainformación a C ++
declaraciones, considere la siguiente macro:

#definir _fuera_ __attribute ((gccxml ("fuera")))
Aquí '_out_' se ha definido como el atributo gccxml donde el primer argumento
es la cadena "out". Se recomienda que el primer argumento se utilice como un
nombre de cadena para el tipo de metainformación que comienza a aplicarse.

Ahora se puede escribir una declaración de método de la siguiente manera:

vacío getInteger (_out_ En t& I);
Esto hará que la salida XML contenga metainformación para el '_out_'
atributo, con el formato "gccxml (out)".

El uso del atributo 'gccxml' permite que la metainformación se incluya directamente en C ++
código fuente, sin la necesidad de un analizador personalizado para extraer la metainformación. los
El atributo 'gccxml' se proporciona solo por conveniencia; no hay garantía de que el futuro
Las versiones de GCC aceptarán el elemento de lenguaje '__attribute' sin errores.

DERECHOS DE AUTOR

GCC-XML: salida XML para GCC

Copyright 2002-2012 Kitware, Inc., Consorcio Insight

La redistribución y el uso en formato fuente y binario, con o sin modificación, son
permitido siempre que se cumplan las siguientes condiciones:

* Las redistribuciones del código fuente deben conservar el aviso de copyright anterior, esta lista de
condiciones y el siguiente descargo de responsabilidad.

* Las redistribuciones en formato binario deben reproducir el aviso de copyright anterior, esta lista
de condiciones y la siguiente exención de responsabilidad en la documentación y / u otras
Materiales proporcionados con la distribución.

* Ni los nombres de Kitware, Inc., Insight Software Consortium ni los nombres
de sus colaboradores pueden utilizarse para respaldar o promover productos derivados de este
software sin un permiso previo específico por escrito.

ESTE SOFTWARE ES PROPORCIONADO POR LOS TITULARES DE LOS DERECHOS DE AUTOR Y COLABORADORES "TAL CUAL" Y CUALQUIER
GARANTÍAS EXPRESAS O IMPLÍCITAS, INCLUIDAS, PERO NO LIMITADAS A, LAS GARANTÍAS IMPLÍCITAS DE
SE RECHAZA LA COMERCIABILIDAD Y LA IDONEIDAD PARA UN PROPÓSITO EN PARTICULAR. EN NINGÚN CASO
EL TITULAR DE LOS DERECHOS DE AUTOR O COLABORADORES SERÁN RESPONSABLES DE CUALQUIER CUALQUIER DIRECTO, INDIRECTO, INCIDENTAL, ESPECIAL,
DAÑOS EJEMPLARES O CONSECUENTES (INCLUYENDO, PERO NO LIMITADO A, ADQUISICIÓN DE
BIENES O SERVICIOS SUSTITUTOS; PÉRDIDA DE USO, DATOS O BENEFICIOS; O INTERRUPCIÓN COMERCIAL)
SIN EMBARGO CAUSADO Y EN CUALQUIER TEORÍA DE RESPONSABILIDAD, YA SEA EN CONTRATO, RESPONSABILIDAD ESTRICTA O
AGRAVIO (INCLUYENDO NEGLIGENCIA O DE OTRO MODO) QUE SURJA DE ALGUNA MANERA DEL USO DE ESTE
SOFTWARE, INCLUSO SI SE ADVIERTE DE LA POSIBILIDAD DE DICHO DAÑO.

-------------------------------------------------- ----------

gccxml_cc1plus: un analizador de GCC parcheado para volcados XML de unidades de traducción

Copyright 2002-2012 Kitware, Inc., Consorcio Insight

Este programa es software gratuito; puedes redistribuirlo y / o modificarlo bajo los términos de
la Licencia Pública General GNU publicada por la Free Software Foundation; cualquiera
versión 2 de la Licencia, o (a su elección) cualquier versión posterior.

Este programa se distribuye con la esperanza de que sea útil, pero SIN NINGUNA GARANTÍA;
incluso sin la garantía implícita de COMERCIABILIDAD o APTITUD PARA UN PROPÓSITO PARTICULAR.
Consulte la Licencia pública general GNU para obtener más detalles.

Debería haber recibido una copia de la Licencia Pública General GNU junto con este programa;
si no, escriba al
Fundación de Software Libre, Inc.
51 Franklin Street, quinto piso
Boston, MA 02110-1301 EE. UU.

ENVÍO Anuncia

Para obtener ayuda y discusión sobre el uso de gccxml, se proporciona una lista de correo en
[email protected]. Primero lea la documentación completa en http://www.gccxml.org
antes de publicar preguntas en la lista.

Use gccxml en línea usando los servicios de onworks.net