contrib/llvm/tools/clang/include/clang-c/CXCompilationDatabase.h

   1 /*===-- clang-c/CXCompilationDatabase.h - Compilation database  ---*- C -*-===*\
   2 |*                                                                            *|
   3 |*                     The LLVM Compiler Infrastructure                       *|
   4 |*                                                                            *|
   5 |* This file is distributed under the University of Illinois Open Source      *|
   6 |* License. See LICENSE.TXT for details.                                      *|
   7 |*                                                                            *|
   8 |*===----------------------------------------------------------------------===*|
   9 |*                                                                            *|
  10 |* This header provides a public inferface to use CompilationDatabase without *|
  11 |* the full Clang C++ API.                                                    *|
  12 |*                                                                            *|
  13 \*===----------------------------------------------------------------------===*/
  14
  15 #ifndef CLANG_CXCOMPILATIONDATABASE_H
  16 #define CLANG_CXCOMPILATIONDATABASE_H
  17
  18 #include "clang-c/Platform.h"
  19 #include "clang-c/CXString.h"
  20
  21 #ifdef __cplusplus
  22 extern "C" {
  23 #endif
  24
  25 /** \defgroup COMPILATIONDB CompilationDatabase functions
  26  * \ingroup CINDEX
  27  *
  28  * @{
  29  */
  30
  31 /**
  32  * A compilation database holds all information used to compile files in a
  33  * project. For each file in the database, it can be queried for the working
  34  * directory or the command line used for the compiler invocation.
  35  *
  36  * Must be freed by \c clang_CompilationDatabase_dispose
  37  */
  38 typedef void * CXCompilationDatabase;
  39
  40 /**
  41  * \brief Contains the results of a search in the compilation database
  42  *
  43  * When searching for the compile command for a file, the compilation db can
  44  * return several commands, as the file may have been compiled with
  45  * different options in different places of the project. This choice of compile
  46  * commands is wrapped in this opaque data structure. It must be freed by
  47  * \c clang_CompileCommands_dispose.
  48  */
  49 typedef void * CXCompileCommands;
  50
  51 /**
  52  * \brief Represents the command line invocation to compile a specific file.
  53  */
  54 typedef void * CXCompileCommand;
  55
  56 /**
  57  * \brief Error codes for Compilation Database
  58  */
  59 typedef enum  {
  60   /*
  61    * \brief No error occured
  62    */
  63   CXCompilationDatabase_NoError = 0,
  64
  65   /*
  66    * \brief Database can not be loaded
  67    */
  68   CXCompilationDatabase_CanNotLoadDatabase = 1
  69
  70 } CXCompilationDatabase_Error;
  71
  72 /**
  73  * \brief Creates a compilation database from the database found in directory
  74  * buildDir. For example, CMake can output a compile_commands.json which can
  75  * be used to build the database.
  76  *
  77  * It must be freed by \c clang_CompilationDatabase_dispose.
  78  */
  79 CINDEX_LINKAGE CXCompilationDatabase
  80 clang_CompilationDatabase_fromDirectory(const char *BuildDir,
  81                                         CXCompilationDatabase_Error *ErrorCode);
  82
  83 /**
  84  * \brief Free the given compilation database
  85  */
  86 CINDEX_LINKAGE void
  87 clang_CompilationDatabase_dispose(CXCompilationDatabase);
  88
  89 /**
  90  * \brief Find the compile commands used for a file. The compile commands
  91  * must be freed by \c clang_CompileCommands_dispose.
  92  */
  93 CINDEX_LINKAGE CXCompileCommands
  94 clang_CompilationDatabase_getCompileCommands(CXCompilationDatabase,
  95                                              const char *CompleteFileName);
  96
  97 /**
  98  * \brief Get all the compile commands in the given compilation database.
  99  */
 100 CINDEX_LINKAGE CXCompileCommands
 101 clang_CompilationDatabase_getAllCompileCommands(CXCompilationDatabase);
 102
 103 /**
 104  * \brief Free the given CompileCommands
 105  */
 106 CINDEX_LINKAGE void clang_CompileCommands_dispose(CXCompileCommands);
 107
 108 /**
 109  * \brief Get the number of CompileCommand we have for a file
 110  */
 111 CINDEX_LINKAGE unsigned
 112 clang_CompileCommands_getSize(CXCompileCommands);
 113
 114 /**
 115  * \brief Get the I'th CompileCommand for a file
 116  *
 117  * Note : 0 <= i < clang_CompileCommands_getSize(CXCompileCommands)
 118  */
 119 CINDEX_LINKAGE CXCompileCommand
 120 clang_CompileCommands_getCommand(CXCompileCommands, unsigned I);
 121
 122 /**
 123  * \brief Get the working directory where the CompileCommand was executed from
 124  */
 125 CINDEX_LINKAGE CXString
 126 clang_CompileCommand_getDirectory(CXCompileCommand);
 127
 128 /**
 129  * \brief Get the number of arguments in the compiler invocation.
 130  *
 131  */
 132 CINDEX_LINKAGE unsigned
 133 clang_CompileCommand_getNumArgs(CXCompileCommand);
 134
 135 /**
 136  * \brief Get the I'th argument value in the compiler invocations
 137  *
 138  * Invariant :
 139  *  - argument 0 is the compiler executable
 140  */
 141 CINDEX_LINKAGE CXString
 142 clang_CompileCommand_getArg(CXCompileCommand, unsigned I);
 143
 144 /**
 145  * @}
 146  */
 147
 148 #ifdef __cplusplus
 149 }
 150 #endif
 151 #endif
 152