importer.h

Instrui o SourceTreeDescriptorDatabase para informar erros de análise ao MultiFileErrorcollector fornecido.

Precisa ser chamado antes da análise. O error_collector precisa permanecer válido até que esse método seja chamado novamente ou que o SourceTreeDescriptorDatabase seja destruído.

Recebe um DescriptorPool::Errorcollector que registra erros no MultiFileErrorcollector especificado com RecordErrorsTo().

Esse coletor pode determinar os números exatos de linhas e colunas de erros com base nas informações fornecidas a ele pelo DescriptorPool.

Encontre um arquivo pelo nome dele.

Preenche *na saída e retorna verdadeiro se encontrado. Caso contrário, retorna "false", deixando o conteúdo da *saída indefinida.

Encontre o arquivo que declara o nome do símbolo totalmente qualificado.

Se encontrada, preenche a *saída e retorna "true". Caso contrário, retorna "false" e deixa *output indefinida.

Encontre o arquivo que define uma extensão que estende o tipo de mensagem informado com o número de campo especificado.

Se encontrada, preenche *output e retorna true. Caso contrário, retorna false e deixa *output indefinida. container_type deve ser um nome de tipo totalmente qualificado.

Importe o arquivo fornecido e crie um FileDescriptor que o represente.

Se o arquivo já estiver no DescriptorPool, o FileDescriptor existente será retornado. O FileDescriptor é uma propriedade do DescriptorPool e permanecerá válido até ser destruído. Se ocorrer algum erro, ele será informado ao coletor de erros, e Import() retornará NULL.

Um objeto Importador específico só informará erros de um arquivo específico. Todas as tentativas futuras de importar o mesmo arquivo retornarão NULL sem relatar erros. A ideia é importar muitos arquivos sem ver os mesmos erros várias vezes. Se você quiser ver erros dos mesmos arquivos repetidamente, use um objeto Importer separado para importar cada um, mas use o mesmo DescriptorPool para que eles possam ser vinculados.

Os números de linha e coluna são baseados em zero.

Um número de linha de -1 indica um erro no arquivo inteiro (por exemplo, "não encontrado").

Abra o arquivo fornecido e retorne um stream que o leia ou NULL se ele não for encontrado.

O autor da chamada se torna o proprietário do objeto retornado. O nome do arquivo precisa ser um caminho relativo à raiz da árvore de origem e não pode conter componentes "." ou "..".

Se Open() retornar NULL, chamar esse método imediatamente retornará uma descrição do erro.

As subclasses precisam implementar esse método e retornar um valor significativo para melhorar a geração de relatórios de erros. TODO(xiaofeng): altere para uma função virtual pura.

Tipo de retorno para DiskFileToVirtualFile().

Mapeie um caminho no disco para um local na SourceTree.

O caminho pode ser um arquivo ou um diretório. Se for um diretório, toda a árvore abaixo dele será mapeada para o local virtual especificado. Para mapear um diretório para a raiz da árvore de origem, transmita uma string vazia para virtual_path.

Se vários caminhos mapeados forem aplicados ao abrir um arquivo, eles serão pesquisados na ordem. Por exemplo, se você fizer o seguinte:

MapPath("bar", "foo/bar");
MapPath("", "baz");

Em seguida, faça o seguinte:

Open("bar/qux");

Primeiro, o DiskSourceTree tentará abrir foo/bar/qux e depois baz/bar/qux, retornando o primeiro que for aberto.

Disco_path pode ser um caminho absoluto ou relativo ao diretório atual, assim como um caminho que você passaria para open().

Quando há um caminho para um arquivo no disco, é preciso encontrar um mapeamento de caminho virtual para esse arquivo.

O primeiro mapeamento criado com MapPath() cujo disco_path contém o nome do arquivo é usado. No entanto, esse caminho virtual pode não ser utilizável para abrir o arquivo fornecido. Os possíveis valores de retorno são:

• SUCCESS: o mapeamento foi encontrado. *virtual_file é preenchido para que chamar Open(*virtual_file) abra o arquivo nomeado comodisk_file.
• SHADOWED: foi encontrado um mapeamento, mas o uso de Open() para abrir este caminho virtual retornará um arquivo diferente. Isso ocorre porque outro mapeamento com precedência maior também corresponde a esse caminho virtual e o mapeia para um arquivo diferente no disco. *virtual_file está preenchido como seria no caso SUCCESS. *shadowing_disk_file é preenchido com o caminho do disco do arquivo que seria aberto se você chamasse Open(*virtual_file).
• CANNOT_OPEN: o mapeamento foi encontrado e não está oculto, mas o arquivo especificado não pode ser aberto. Quando esse valor é retornado, errno indica por que o arquivo não pode ser aberto. *virtual_file será definido como o caminho virtual como no caso SUCCESS, mesmo que não seja útil.
• NO_MAPPING: indica que não foi encontrado nenhum mapeamento que contenha esse arquivo.

Com um caminho virtual, encontre o caminho para o arquivo no disco.

Retorne true e atualize disco_file com o caminho no disco, se o arquivo existir. Retorne "false" e deixe o disco de disco intocado se o arquivo não existir.

Abra o arquivo fornecido e retorne um stream que o leia ou NULL se ele não for encontrado.

O autor da chamada se torna o proprietário do objeto retornado. O nome do arquivo precisa ser um caminho relativo à raiz da árvore de origem e não pode conter componentes "." ou "..".

Se Open() retornar NULL, chamar esse método imediatamente retornará uma descrição do erro.

As subclasses precisam implementar esse método e retornar um valor significativo para melhorar a geração de relatórios de erros. TODO(xiaofeng): altere para uma função virtual pura.