clang  3.7.0
CXString.h
Go to the documentation of this file.
1 /*===-- clang-c/CXString.h - C Index strings --------------------*- 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 the interface to C Index strings. *|
11 |* *|
12 \*===----------------------------------------------------------------------===*/
13 
14 #ifndef LLVM_CLANG_C_CXSTRING_H
15 #define LLVM_CLANG_C_CXSTRING_H
16 
17 #include "clang-c/Platform.h"
18 
19 #ifdef __cplusplus
20 extern "C" {
21 #endif
22 
23 /**
24  * \defgroup CINDEX_STRING String manipulation routines
25  * \ingroup CINDEX
26  *
27  * @{
28  */
29 
30 /**
31  * \brief A character string.
32  *
33  * The \c CXString type is used to return strings from the interface when
34  * the ownership of that string might differ from one call to the next.
35  * Use \c clang_getCString() to retrieve the string data and, once finished
36  * with the string data, call \c clang_disposeString() to free the string.
37  */
38 typedef struct {
39  const void *data;
40  unsigned private_flags;
41 } CXString;
42 
43 /**
44  * \brief Retrieve the character data associated with the given string.
45  */
46 CINDEX_LINKAGE const char *clang_getCString(CXString string);
47 
48 /**
49  * \brief Free the given string.
50  */
52 
53 /**
54  * @}
55  */
56 
57 #ifdef __cplusplus
58 }
59 #endif
60 #endif
61 
#define CINDEX_LINKAGE
Definition: Platform.h:29
unsigned private_flags
Definition: CXString.h:40
CINDEX_LINKAGE void clang_disposeString(CXString string)
Free the given string.
CINDEX_LINKAGE const char * clang_getCString(CXString string)
Retrieve the character data associated with the given string.
A character string.
Definition: CXString.h:38
const void * data
Definition: CXString.h:39