gccxml - Online na nuvem

PROGRAMA:

NOME

gccxml - Crie uma representação XML de declarações C ++.

SINOPSE

gccxml [opções] -fxml =

DESCRIÇÃO

GCC-XML analisa um arquivo de origem C ++ como é visto pelo compilador quando é construído. Um fácil-
para analisar a representação XML das declarações de classe, função e namespace é despejado
para um arquivo especificado. O pré-processamento C completo transforma o arquivo em uma unidade de tradução C ++
conforme visto pelo compilador. Isso significa que GCC-XML deve fazer uso do mesmo padrão
biblioteca e outros arquivos de cabeçalho como o compilador. O GCC-XML pode ser configurado para simular qualquer
de vários compiladores populares.

OPÇÕES

As seguintes opções estão disponíveis para executar o GCC-XML:

--direito autoral
Imprima o copyright do GCC-XML e saia.

--depurar
Imprima informações extras de depuração. Esta opção faz com que o GCC-XML imprima o
nome do executável e argumentos de linha de comando usados ​​para executar o GCC C ++ corrigido
analisador. Isso é útil ao tentar simular um compilador sem suporte.

-fxml =
Especifique o arquivo de saída XML. Esta opção é passada diretamente para o GCC corrigido
Analisador C ++. Ele ativa o dump XML e especifica o nome do arquivo de saída.

-fxml-start = [, ...]
Especifique uma lista de declarações iniciais. Esta opção é passada diretamente para o
analisador GCC C ++ corrigido. É significativo apenas se -fxml = também for especificado. Esse
especifica uma lista separada por vírgulas de declarações iniciais nomeadas. GCC-XML irá despejar
apenas o subconjunto das declarações na unidade de tradução que é alcançável
por meio de uma sequência de referências de origem de um dos
declarações.

--gccxml-compilador
Defina GCCXML_COMPILER como "xxx".

--gccxml-cxxflags
Defina GCCXML_CXXFLAGS como "xxx".

--gccxml-executável
Defina GCCXML_EXECUTABLE como "xxx".

--gccxml-cpp
Defina GCCXML_CPP como "xxx".

--gccxml-config
Defina GCCXML_CONFIG como "xxx".

--gccxml-root
Defina GCCXML_ROOT como "xxx".

--gccxml-gcc-opções
Leia as opções do GCC no arquivo "xxx". Esta opção especifica um arquivo a partir do qual ler
opções para passar para o analisador GCC C ++ corrigido. Isso é útil para especificar um
longa lista de diretórios de inclusão. Cada linha do arquivo se torna uma opção. Vazio
linhas e linhas que começam com '#' são ignoradas.

--Socorro Imprima a ajuda completa e saia. A ajuda completa exibe a maior parte da documentação fornecida por
a página do manual do UNIX. É fornecido para uso em plataformas não UNIX, mas também é
conveniente se a página do manual não estiver instalada.

--ajuda-html
Imprima a ajuda completa em formato HTML. Esta opção é usada pelos autores do GCC-XML para ajudar
produzir páginas da web.

--cara Imprima uma página de manual do UNIX e saia. Esta opção é usada pelos autores GCC-XML para gerar
a página do manual do UNIX.

--imprimir
Imprima as definições de configuração e saia. GCC-XML tem muitas opções de configuração para
ajude-o a simular outro compilador. Usar esta opção fará com que o GCC-XML
configure-se como se fosse analisar o código-fonte C ++, mas pare e imprima
a configuração encontrada. Isso é útil para verificar a configuração.

--processo
Pré-processe a entrada e saia. GCC-XML simula o proprocessador de outro
compilador. Usar esta opção fará com que o GCC-XML se configure como se fosse
vai analisar o código-fonte C ++, mas parar após o pré-processamento. Isso é útil para
depuração de problemas relacionados à simulação do outro compilador.

-E Alias ​​para --preprocess.

--versão
Mostra o nome do programa / faixa da versão e sai.

Outros sinalizadores, como -I e -D, são passados ​​para o executável do analisador GCC C ++ corrigido.

DEFINIÇÕES

O GCC-XML é projetado para simular o analisador de um compilador durante a leitura do código-fonte C ++. Algum
definições de configuração são necessárias para determinar como simular um compilador específico de
a escolha do usuário. As seguintes configurações podem ser usadas para configurar o GCC-XML:

GCCXML_COMPILER
O compilador C ++ a ser simulado. GCC-XML tentará determinar automaticamente
como simular o compilador especificado por esta configuração. O compilador é especificado
por seu nome executável (como "g ++"). Para Visual Studio, o compilador é
especificado por "msvc6", "msvc7", "msvc71" ou "msvc8" (se "cl" for fornecido, GCC-XML
tenta adivinhar qual VS usar).

GCCXML_CXXFLAGS
Os sinalizadores para o compilador C ++ a ser simulado. O comportamento da maioria dos compiladores pode
ser ajustado especificando sinalizadores na linha de comando. Quando o GCC-XML tenta
determinar automaticamente como simular um compilador, esses sinalizadores são levados em
consideração.

GCCXML_CONFIG
O arquivo de configuração para configurações comuns. Quando as configurações não padrão são frequentemente
usados, é conveniente escrever um único arquivo contendo-os. Quando tal arquivo é
especificado, ele será lido para definir quaisquer configurações que ainda não sejam conhecidas. Cada
linha do arquivo consiste em uma atribuição no formato KEY = "VALUE" (por exemplo,
GCCXML_COMPILER = "g ++").

GCCXML_EXECUTABLE
Especifique o executável do analisador GCC C ++ corrigido. O programa GCC-XML visto pelo
usuário é, na verdade, um front-end que determina os sinalizadores necessários para configurar o
analisador GCC C ++ corrigido para simular outro compilador. Esta configuração especifica o
executável real para ser executado uma vez que os sinalizadores tenham sido determinados. Os usuários raramente devem
precisa alterar este valor de seu padrão.

GCCXML_CPP
Especifique o executável do pré-processador GCC C. O programa GCC-XML visto pelo usuário
é na verdade um front-end que determina as sinalizações necessárias para configurar o patch patch
Analisador GCC C ++ para simular outro compilador. Esta configuração especifica o
pré-processador para rodar com os sinalizadores que foram determinados para depuração
finalidades. Os usuários raramente precisam alterar esse valor de seu padrão.

GCCXML_ROOT
O diretório da biblioteca de suporte GCC-XML. Uma vez que GCC-XML é apenas um analisador C ++, ele
não pode duplicar exatamente a funcionalidade de cada compilador que tenta simular.
Alguns compiladores fornecem cabeçalhos padrão com código que GCC-XML não pode diretamente
lidar. Para contornar essa limitação, uma biblioteca de suporte é fornecida para cada
compilador. Isso consiste em um conjunto de arquivos de cabeçalho que são usados ​​no lugar do
cabeçalhos de sistema do compilador. Esses arquivos contêm pequenos ajustes e, em seguida, incluem o
cabeçalho real correspondente. A raiz da árvore de diretórios que contém esses suportes
os cabeçalhos da biblioteca são especificados por esta configuração. Os usuários raramente precisam mudar
este valor de seu padrão.

GCCXML_FLAGS
Sinalizadores usados ​​para simular o outro compilador. Quando o GCC-XML executa o GCC C ++ corrigido
analisador, esses sinalizadores são passados ​​para o programa para dizer a ele como simular um
compilador particular. Esta configuração geralmente é detectada automaticamente a partir do outro
configurações, mas pode ser especificado diretamente por usuários avançados. A maioria dos usuários deveria
não tente alterar este valor da configuração automática.

GCCXML_USER_FLAGS
Sinalizadores de usuário adicionais para simulação do compilador. Quando o GCC-XML executa o GCC corrigido
Analisador C ++, esses sinalizadores são passados ​​além daqueles especificados por GCCXML_FLAGS.
Isso permite que usuários avançados ajustem a simulação do compilador enquanto ainda usam o
configuração automática de GCCXML_FLAGS. Os usuários raramente precisam alterar isso
valor de seu padrão.

Existem vários meios pelos quais essas configurações são definidas. Eles estão listados aqui em
ordem de precedência (mais alta primeiro):

Linha de comando Opções
As configurações podem ser especificadas por suas opções correspondentes. Quando um cenário é
opção de linha de comando correspondente é fornecida, ela é usada em favor de qualquer outra
meios de configuração. Se GCCXML_CONFIG for definido na linha de comando, as configurações serão
ler do arquivo com precedência apenas um pouco menor do que outra linha de comando
opções.

Meio Ambiente Variáveis
As configurações são definidas por nome no ambiente. Cada configuração ainda não conhecida
é lido a partir de uma variável de ambiente com seu nome. Se GCCXML_CONFIG for definido pelo
ambiente, as configurações são lidas do arquivo com precedência apenas ligeiramente inferior
do que outras variáveis ​​de ambiente.

Configuração Arquivos
É realizada uma pesquisa por GCCXML_CONFIG. Se GCCXML_CONFIG ainda não foi definido, um
é feita uma tentativa de encontrar um arquivo de configuração automaticamente. Primeiro, se o arquivo
$ HOME / .gccxml / config existe, será usado. Em segundo lugar, se GCC-XML está sendo executado
de seu diretório de construção, um arquivo de configuração desse diretório será usado. Finalmente,
se um arquivo de configuração for encontrado no diretório da biblioteca de suporte da instalação,
ser usado. Depois de encontradas, todas as configurações desconhecidas são lidas do arquivo de configuração.

Adivinhação
As estimativas são feitas com base em outras configurações. Uma vez que GCCXML_COMPILER foi definido, é
usado para encontrar automaticamente a configuração para GCCXML_FLAGS. Se não estiver definido, o
A variável de ambiente "CXX" é verificada como último recurso para encontrar a configuração do compilador
e determinar GCCXML_FLAGS.

A maioria dos usuários não deve ter que ajustar os padrões para essas configurações. Existe um padrão
Arquivo GCCXML_CONFIG fornecido no diretório da biblioteca de suporte após a instalação. Isto
configura GCC-XML para simular o compilador que foi usado para construí-lo.

COMPILADORES

GCC-XML pode simular qualquer um dos seguintes compiladores:

GCC Versões 4.2, 4.1, 4.0, 3.4, 3.3, 3.2, 2.95.x

visual C + +
Versões 8, 7.1, 7.0 e 6 (sp5)

Borlândia, Intel, SGI
anteriormente suportado, mas não mais testado

As seguintes definições extras de pré-processador C são fornecidas:

-D__GCCXML __ = MMmmpp
MM, mm e pp são as versões principal, secundária e de patch do GCC-XML. Esse
O símbolo do pré-processador identifica o GCC-XML para o código-fonte conforme ele é pré-processado.
Ele pode ser usado para habilitar informações específicas do GCC-XML.

-D__GCCXML_GNUC __ = M
Definido para a versão principal do analisador GCC interno.

-D__GCCXML_GNUC_MINOR __ = m
Definido para a versão secundária do analisador GCC interno.

-D__GCCXML_GNUC_PATCHLEVEL __ = p
Definido para nível de patch do analisador interno GCC.

Os usuários avançados podem simular outros compiladores configurando manualmente o GCCXML_FLAGS
configuração. Contate a lista de discussão para obter ajuda.

METAINFO

GCC-XML adicionou um novo atributo ao conjunto legal de atributos C / C ++. O atributo é
usado para anexar meta informações ao código-fonte C / C ++, que então aparecerá no XML
saída. A sintaxe para declarar um atributo é a seguinte:

__attribute ((gccxml ( , , ...)))
Aqui é uma string entre aspas. Deve haver pelo menos um argumento para o
Atributo 'gccxml', mas não há limite superior para o número total de argumentos.
Cada argumento é verificado para ser uma string - se um argumento não string for encontrado, o
atributo é ignorado.

A saída XML para o elemento de código que é marcado com o atributo conterá
o seguinte:

atributos = " ... gccxml ( , , ...) ...
O atributo XML 'atributos' contém todos os atributos aplicados ao elemento de código.
Cada argumento do atributo é impresso sem aspas, então se um
argumento contém o caractere ',', o argumento parecerá ser múltiplo
argumentos.

O atributo 'gccxml' pode ser aplicado a qualquer declaração, incluindo structs, classes,
campos, parâmetros, métodos, funções, variáveis ​​e typedefs. A única exceção é
que o tratamento do GCC do elemento de linguagem '__attribute' está atualmente quebrado para
enumerações e construtores com um corpo embutido. O atributo 'gccxml' pode ser usado
qualquer número de vezes em uma determinada declaração.

Como um exemplo de como este atributo pode ser usado para anexar meta informações ao C ++
declarações, considere a seguinte macro:

#define _Fora_ __attribute ((gccxml ("out")))
Aqui '_out_' foi definido para ser o atributo gccxml onde o primeiro argumento
é a string "out". Recomenda-se que o primeiro argumento seja usado como um único
nome da string para o tipo de meta informação que começa a ser aplicada.

Agora, uma declaração de método pode ser escrita da seguinte maneira:

anular getInteger (_out_ int & eu);
Isso fará com que a saída XML contenha metainformações para '_out_'
atributo, no formato "gccxml (out)".

Usar o atributo 'gccxml' permite que metainformações sejam incluídas diretamente em C ++
código-fonte, sem a necessidade de um analisador personalizado para extrair as metainformações. o
O atributo 'gccxml' é fornecido apenas por conveniência - não há garantia de que
as versões do GCC aceitarão o elemento de linguagem '__attribute' sem erros.

DIREITOS AUTORAIS

GCC-XML - saída XML para GCC

Copyright 2002-2012 Kitware, Inc., Consórcio Insight

A redistribuição e o uso nas formas de origem e binária, com ou sem modificação, são
permitido desde que as seguintes condições sejam atendidas:

* As redistribuições do código-fonte devem manter o aviso de direitos autorais acima, esta lista de
condições e a seguinte isenção de responsabilidade.

* As redistribuições na forma binária devem reproduzir o aviso de direitos autorais acima, esta lista
das condições e a seguinte isenção de responsabilidade na documentação e / ou outro
materiais fornecidos com a distribuição.

* Nem os nomes da Kitware, Inc., o Insight Software Consortium, nem os nomes
de seus contribuidores podem ser usados ​​para endossar ou promover produtos derivados deste
software sem permissão prévia por escrito específica.

ESTE SOFTWARE É FORNECIDO PELOS PROPRIETÁRIOS DOS DIREITOS AUTORAIS E CONTRIBUIDORES "COMO ESTÁ" E QUALQUER
GARANTIAS EXPRESSAS OU IMPLÍCITAS, INCLUINDO, MAS NÃO SE LIMITANDO A, GARANTIAS IMPLÍCITAS DE
COMERCIALIZAÇÃO E ADEQUAÇÃO A UM DETERMINADO FIM SÃO RENUNCIADAS. EM NENHUMA HIPÓTESE O
O TITULAR DOS DIREITOS AUTORAIS OU CONTRIBUIDORES SÃO RESPONSÁVEIS POR QUALQUER DIRETO, INDIRETO, INCIDENTAL, ESPECIAL,
DANOS EXEMPLARES OU CONSEQÜENCIAIS (INCLUINDO, MAS NÃO SE LIMITANDO A, AQUISIÇÃO DE
SUBSTITUIR BENS OU SERVIÇOS; PERDA DE USO, DADOS OU LUCROS; OU INTERRUPÇÃO DE NEGÓCIOS)
NO ENTANTO, CAUSADO E EM QUALQUER TEORIA DE RESPONSABILIDADE, SEJA EM CONTRATO, RESPONSABILIDADE ESTRITA, OU
DELITO (INCLUINDO NEGLIGÊNCIA OU DE OUTRA FORMA) DECORRENTE DE QUALQUER FORMA DO USO DESTE
SOFTWARE, MESMO SE AVISADO SOBRE A POSSIBILIDADE DE TAIS DANOS.

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

gccxml_cc1plus - Um analisador GCC corrigido para despejos XML de unidades de tradução

Copyright 2002-2012 Kitware, Inc., Consórcio Insight

Este programa é um software livre; você pode redistribuí-lo e / ou modificá-lo nos termos do
a GNU General Public License conforme publicada pela Free Software Foundation; qualquer
versão 2 da licença ou (a seu critério) qualquer versão posterior.

Este programa é distribuído na esperança de que seja útil, mas SEM NENHUMA GARANTIA;
sem mesmo a garantia implícita de COMERCIALIZAÇÃO ou ADEQUAÇÃO A UM DETERMINADO FIM.
Consulte a GNU General Public License para obter mais detalhes.

Você deve ter recebido uma cópia da GNU General Public License junto com este programa;
se não, escreva para o
Fundação de Software Livre, Inc.
51 Franklin Street, quinto andar
Boston, MA 02110-1301 EUA

ENVIANDO LISTA

Para ajuda e discussão sobre o uso do gccxml, uma lista de discussão é fornecida em
[email protegido]. Leia primeiro a documentação completa em http://www.gccxml.org
antes de postar perguntas na lista.

Use gccxml online usando serviços onworks.net