clang API Documentation

Classes | Enumerations | Functions
Type information for CXCursors
libclang: C Interface to Clang
Collaboration diagram for Type information for CXCursors:

Classes

struct  CXType
 The type of an element in the abstract syntax tree. More...

Enumerations

enum  CXTypeKind {
  CXType_Invalid = 0, CXType_Unexposed = 1, CXType_Void = 2, CXType_Bool = 3,
  CXType_Char_U = 4, CXType_UChar = 5, CXType_Char16 = 6, CXType_Char32 = 7,
  CXType_UShort = 8, CXType_UInt = 9, CXType_ULong = 10, CXType_ULongLong = 11,
  CXType_UInt128 = 12, CXType_Char_S = 13, CXType_SChar = 14, CXType_WChar = 15,
  CXType_Short = 16, CXType_Int = 17, CXType_Long = 18, CXType_LongLong = 19,
  CXType_Int128 = 20, CXType_Float = 21, CXType_Double = 22, CXType_LongDouble = 23,
  CXType_NullPtr = 24, CXType_Overload = 25, CXType_Dependent = 26, CXType_ObjCId = 27,
  CXType_ObjCClass = 28, CXType_ObjCSel = 29, CXType_FirstBuiltin = CXType_Void, CXType_LastBuiltin = CXType_ObjCSel,
  CXType_Complex = 100, CXType_Pointer = 101, CXType_BlockPointer = 102, CXType_LValueReference = 103,
  CXType_RValueReference = 104, CXType_Record = 105, CXType_Enum = 106, CXType_Typedef = 107,
  CXType_ObjCInterface = 108, CXType_ObjCObjectPointer = 109, CXType_FunctionNoProto = 110, CXType_FunctionProto = 111,
  CXType_ConstantArray = 112, CXType_Vector = 113, CXType_IncompleteArray = 114, CXType_VariableArray = 115,
  CXType_DependentSizedArray = 116, CXType_MemberPointer = 117
}
 Describes the kind of type. More...
enum  CXCallingConv {
  CXCallingConv_Default = 0, CXCallingConv_C = 1, CXCallingConv_X86StdCall = 2, CXCallingConv_X86FastCall = 3,
  CXCallingConv_X86ThisCall = 4, CXCallingConv_X86Pascal = 5, CXCallingConv_AAPCS = 6, CXCallingConv_AAPCS_VFP = 7,
  CXCallingConv_PnaclCall = 8, CXCallingConv_IntelOclBicc = 9, CXCallingConv_X86_64Win64 = 10, CXCallingConv_X86_64SysV = 11,
  CXCallingConv_X86VectorCall = 12, CXCallingConv_Invalid = 100, CXCallingConv_Unexposed = 200
}
 Describes the calling convention of a function type. More...
enum  CXTemplateArgumentKind {
  CXTemplateArgumentKind_Null, CXTemplateArgumentKind_Type, CXTemplateArgumentKind_Declaration, CXTemplateArgumentKind_NullPtr,
  CXTemplateArgumentKind_Integral, CXTemplateArgumentKind_Template, CXTemplateArgumentKind_TemplateExpansion, CXTemplateArgumentKind_Expression,
  CXTemplateArgumentKind_Pack, CXTemplateArgumentKind_Invalid
}
 Describes the kind of a template argument. More...
enum  CXTypeLayoutError {
  CXTypeLayoutError_Invalid = -1, CXTypeLayoutError_Incomplete = -2, CXTypeLayoutError_Dependent = -3, CXTypeLayoutError_NotConstantSize = -4,
  CXTypeLayoutError_InvalidFieldName = -5
}
 List the possible error codes for clang_Type_getSizeOf, clang_Type_getAlignOf, clang_Type_getOffsetOf and clang_Cursor_getOffsetOf. More...
enum  CXRefQualifierKind { CXRefQualifier_None = 0, CXRefQualifier_LValue, CXRefQualifier_RValue }
enum  CX_CXXAccessSpecifier { CX_CXXInvalidAccessSpecifier, CX_CXXPublic, CX_CXXProtected, CX_CXXPrivate }
 Represents the C++ access control level to a base class for a cursor with kind CX_CXXBaseSpecifier. More...
enum  CX_StorageClass {
  CX_SC_Invalid, CX_SC_None, CX_SC_Extern, CX_SC_Static,
  CX_SC_PrivateExtern, CX_SC_OpenCLWorkGroupLocal, CX_SC_Auto, CX_SC_Register
}
 Represents the storage classes as declared in the source. CX_SC_Invalid was added for the clase that the passed cursor in not a declaration. More...

Functions

CINDEX_LINKAGE CXType clang_getCursorType (CXCursor C)
 Retrieve the type of a CXCursor (if any).
CINDEX_LINKAGE CXString clang_getTypeSpelling (CXType CT)
 Pretty-print the underlying type using the rules of the language of the translation unit from which it came.
CINDEX_LINKAGE CXType clang_getTypedefDeclUnderlyingType (CXCursor C)
 Retrieve the underlying type of a typedef declaration.
CINDEX_LINKAGE CXType clang_getEnumDeclIntegerType (CXCursor C)
 Retrieve the integer type of an enum declaration.
CINDEX_LINKAGE long long clang_getEnumConstantDeclValue (CXCursor C)
 Retrieve the integer value of an enum constant declaration as a signed long long.
CINDEX_LINKAGE unsigned long long clang_getEnumConstantDeclUnsignedValue (CXCursor C)
 Retrieve the integer value of an enum constant declaration as an unsigned long long.
CINDEX_LINKAGE int clang_getFieldDeclBitWidth (CXCursor C)
 Retrieve the bit width of a bit field declaration as an integer.
CINDEX_LINKAGE int clang_Cursor_getNumArguments (CXCursor C)
 Retrieve the number of non-variadic arguments associated with a given cursor.
CINDEX_LINKAGE CXCursor clang_Cursor_getArgument (CXCursor C, unsigned i)
 Retrieve the argument cursor of a function or method.
CINDEX_LINKAGE int clang_Cursor_getNumTemplateArguments (CXCursor C)
 Returns the number of template args of a function decl representing a template specialization.
CINDEX_LINKAGE enum
CXTemplateArgumentKind 
clang_Cursor_getTemplateArgumentKind (CXCursor C, unsigned I)
 Retrieve the kind of the I'th template argument of the CXCursor C.
CINDEX_LINKAGE CXType clang_Cursor_getTemplateArgumentType (CXCursor C, unsigned I)
 Retrieve a CXType representing the type of a TemplateArgument of a function decl representing a template specialization.
CINDEX_LINKAGE long long clang_Cursor_getTemplateArgumentValue (CXCursor C, unsigned I)
 Retrieve the value of an Integral TemplateArgument (of a function decl representing a template specialization) as a signed long long.
CINDEX_LINKAGE unsigned long long clang_Cursor_getTemplateArgumentUnsignedValue (CXCursor C, unsigned I)
 Retrieve the value of an Integral TemplateArgument (of a function decl representing a template specialization) as an unsigned long long.
CINDEX_LINKAGE unsigned clang_equalTypes (CXType A, CXType B)
 Determine whether two CXTypes represent the same type.
CINDEX_LINKAGE CXType clang_getCanonicalType (CXType T)
 Return the canonical type for a CXType.
CINDEX_LINKAGE unsigned clang_isConstQualifiedType (CXType T)
 Determine whether a CXType has the "const" qualifier set, without looking through typedefs that may have added "const" at a different level.
CINDEX_LINKAGE unsigned clang_isVolatileQualifiedType (CXType T)
 Determine whether a CXType has the "volatile" qualifier set, without looking through typedefs that may have added "volatile" at a different level.
CINDEX_LINKAGE unsigned clang_isRestrictQualifiedType (CXType T)
 Determine whether a CXType has the "restrict" qualifier set, without looking through typedefs that may have added "restrict" at a different level.
CINDEX_LINKAGE CXType clang_getPointeeType (CXType T)
 For pointer types, returns the type of the pointee.
CINDEX_LINKAGE CXCursor clang_getTypeDeclaration (CXType T)
 Return the cursor for the declaration of the given type.
CINDEX_LINKAGE CXString clang_getDeclObjCTypeEncoding (CXCursor C)
CINDEX_LINKAGE CXString clang_getTypeKindSpelling (enum CXTypeKind K)
 Retrieve the spelling of a given CXTypeKind.
CINDEX_LINKAGE enum CXCallingConv clang_getFunctionTypeCallingConv (CXType T)
 Retrieve the calling convention associated with a function type.
CINDEX_LINKAGE CXType clang_getResultType (CXType T)
 Retrieve the return type associated with a function type.
CINDEX_LINKAGE int clang_getNumArgTypes (CXType T)
 Retrieve the number of non-variadic parameters associated with a function type.
CINDEX_LINKAGE CXType clang_getArgType (CXType T, unsigned i)
 Retrieve the type of a parameter of a function type.
CINDEX_LINKAGE unsigned clang_isFunctionTypeVariadic (CXType T)
 Return 1 if the CXType is a variadic function type, and 0 otherwise.
CINDEX_LINKAGE CXType clang_getCursorResultType (CXCursor C)
 Retrieve the return type associated with a given cursor.
CINDEX_LINKAGE unsigned clang_isPODType (CXType T)
 Return 1 if the CXType is a POD (plain old data) type, and 0 otherwise.
CINDEX_LINKAGE CXType clang_getElementType (CXType T)
 Return the element type of an array, complex, or vector type.
CINDEX_LINKAGE long long clang_getNumElements (CXType T)
 Return the number of elements of an array or vector type.
CINDEX_LINKAGE CXType clang_getArrayElementType (CXType T)
 Return the element type of an array type.
CINDEX_LINKAGE long long clang_getArraySize (CXType T)
 Return the array size of a constant array.
CINDEX_LINKAGE long long clang_Type_getAlignOf (CXType T)
 Return the alignment of a type in bytes as per C++[expr.alignof] standard.
CINDEX_LINKAGE CXType clang_Type_getClassType (CXType T)
 Return the class type of an member pointer type.
CINDEX_LINKAGE long long clang_Type_getSizeOf (CXType T)
 Return the size of a type in bytes as per C++[expr.sizeof] standard.
CINDEX_LINKAGE long long clang_Type_getOffsetOf (CXType T, const char *S)
 Return the offset of a field named S in a record of type T in bits as it would be returned by __offsetof__ as per C++11[18.2p4].
CINDEX_LINKAGE int clang_Type_getNumTemplateArguments (CXType T)
 Returns the number of template arguments for given class template specialization, or -1 if type T is not a class template specialization.
CINDEX_LINKAGE CXType clang_Type_getTemplateArgumentAsType (CXType T, unsigned i)
 Returns the type template argument of a template class specialization at given index.
CINDEX_LINKAGE enum
CXRefQualifierKind 
clang_Type_getCXXRefQualifier (CXType T)
 Retrieve the ref-qualifier kind of a function or method.
CINDEX_LINKAGE unsigned clang_Cursor_isBitField (CXCursor C)
 Returns non-zero if the cursor specifies a Record member that is a bitfield.
CINDEX_LINKAGE unsigned clang_isVirtualBase (CXCursor)
 Returns 1 if the base class specified by the cursor with kind CX_CXXBaseSpecifier is virtual.
CINDEX_LINKAGE enum
CX_CXXAccessSpecifier 
clang_getCXXAccessSpecifier (CXCursor)
 Returns the access control level for the referenced object.
CINDEX_LINKAGE enum CX_StorageClass clang_Cursor_getStorageClass (CXCursor)
 Returns the storage class for a function or variable declaration.
CINDEX_LINKAGE unsigned clang_getNumOverloadedDecls (CXCursor cursor)
 Determine the number of overloaded declarations referenced by a CXCursor_OverloadedDeclRef cursor.
CINDEX_LINKAGE CXCursor clang_getOverloadedDecl (CXCursor cursor, unsigned index)
 Retrieve a cursor for one of the overloaded declarations referenced by a CXCursor_OverloadedDeclRef cursor.

Enumeration Type Documentation

Represents the C++ access control level to a base class for a cursor with kind CX_CXXBaseSpecifier.

Enumerator:
CX_CXXInvalidAccessSpecifier 
CX_CXXPublic 
CX_CXXProtected 
CX_CXXPrivate 

Definition at line 3330 of file Index.h.

Represents the storage classes as declared in the source. CX_SC_Invalid was added for the clase that the passed cursor in not a declaration.

Enumerator:
CX_SC_Invalid 
CX_SC_None 
CX_SC_Extern 
CX_SC_Static 
CX_SC_PrivateExtern 
CX_SC_OpenCLWorkGroupLocal 
CX_SC_Auto 
CX_SC_Register 

Definition at line 3350 of file Index.h.

Describes the calling convention of a function type.

Enumerator:
CXCallingConv_Default 
CXCallingConv_C 
CXCallingConv_X86StdCall 
CXCallingConv_X86FastCall 
CXCallingConv_X86ThisCall 
CXCallingConv_X86Pascal 
CXCallingConv_AAPCS 
CXCallingConv_AAPCS_VFP 
CXCallingConv_PnaclCall 
CXCallingConv_IntelOclBicc 
CXCallingConv_X86_64Win64 
CXCallingConv_X86_64SysV 
CXCallingConv_X86VectorCall 
CXCallingConv_Invalid 
CXCallingConv_Unexposed 

Definition at line 2843 of file Index.h.

Enumerator:
CXRefQualifier_None 

No ref-qualifier was provided.

CXRefQualifier_LValue 

An lvalue ref-qualifier was provided (&).

CXRefQualifier_RValue 

An rvalue ref-qualifier was provided (&&).

Definition at line 3279 of file Index.h.

Describes the kind of a template argument.

See the definition of llvm::clang::TemplateArgument::ArgKind for full element descriptions.

Enumerator:
CXTemplateArgumentKind_Null 
CXTemplateArgumentKind_Type 
CXTemplateArgumentKind_Declaration 
CXTemplateArgumentKind_NullPtr 
CXTemplateArgumentKind_Integral 
CXTemplateArgumentKind_Template 
CXTemplateArgumentKind_TemplateExpansion 
CXTemplateArgumentKind_Expression 
CXTemplateArgumentKind_Pack 
CXTemplateArgumentKind_Invalid 

Definition at line 2952 of file Index.h.

enum CXTypeKind

Describes the kind of type.

Enumerator:
CXType_Invalid 

Represents an invalid type (e.g., where no type is available).

CXType_Unexposed 

A type whose specific kind is not exposed via this interface.

CXType_Void 
CXType_Bool 
CXType_Char_U 
CXType_UChar 
CXType_Char16 
CXType_Char32 
CXType_UShort 
CXType_UInt 
CXType_ULong 
CXType_ULongLong 
CXType_UInt128 
CXType_Char_S 
CXType_SChar 
CXType_WChar 
CXType_Short 
CXType_Int 
CXType_Long 
CXType_LongLong 
CXType_Int128 
CXType_Float 
CXType_Double 
CXType_LongDouble 
CXType_NullPtr 
CXType_Overload 
CXType_Dependent 
CXType_ObjCId 
CXType_ObjCClass 
CXType_ObjCSel 
CXType_FirstBuiltin 
CXType_LastBuiltin 
CXType_Complex 
CXType_Pointer 
CXType_BlockPointer 
CXType_LValueReference 
CXType_RValueReference 
CXType_Record 
CXType_Enum 
CXType_Typedef 
CXType_ObjCInterface 
CXType_ObjCObjectPointer 
CXType_FunctionNoProto 
CXType_FunctionProto 
CXType_ConstantArray 
CXType_Vector 
CXType_IncompleteArray 
CXType_VariableArray 
CXType_DependentSizedArray 
CXType_MemberPointer 

Definition at line 2776 of file Index.h.

List the possible error codes for clang_Type_getSizeOf, clang_Type_getAlignOf, clang_Type_getOffsetOf and clang_Cursor_getOffsetOf.

A value of this enumeration type can be returned if the target type is not a valid argument to sizeof, alignof or offsetof.

Enumerator:
CXTypeLayoutError_Invalid 

Type is of kind CXType_Invalid.

CXTypeLayoutError_Incomplete 

The type is an incomplete Type.

CXTypeLayoutError_Dependent 

The type is a dependent Type.

CXTypeLayoutError_NotConstantSize 

The type is not a constant size type.

CXTypeLayoutError_InvalidFieldName 

The Field name is not valid for this record.

Definition at line 3209 of file Index.h.


Function Documentation

Retrieve the argument cursor of a function or method.

The argument cursor can be determined for calls as well as for declarations of functions or methods. For other cursors and for invalid indices, an invalid cursor is returned.

Retrieve the number of non-variadic arguments associated with a given cursor.

The number of arguments can be determined for calls as well as for declarations of functions or methods. For other cursors -1 is returned.

Returns the number of template args of a function decl representing a template specialization.

If the argument cursor cannot be converted into a template function declaration, -1 is returned.

For example, for the following declaration and specialization: template <typename T, int kInt, bool kBool> void foo() { ... }

template <> void foo<float, -7, true>();

The value 3 would be returned from this call.

Returns the storage class for a function or variable declaration.

If the passed in Cursor is not a function or variable declaration, CX_SC_Invalid is returned else the storage class.

Retrieve the kind of the I'th template argument of the CXCursor C.

If the argument CXCursor does not represent a FunctionDecl, an invalid template argument kind is returned.

For example, for the following declaration and specialization: template <typename T, int kInt, bool kBool> void foo() { ... }

template <> void foo<float, -7, true>();

For I = 0, 1, and 2, Type, Integral, and Integral will be returned, respectively.

Retrieve a CXType representing the type of a TemplateArgument of a function decl representing a template specialization.

If the argument CXCursor does not represent a FunctionDecl whose I'th template argument has a kind of CXTemplateArgKind_Integral, an invalid type is returned.

For example, for the following declaration and specialization: template <typename T, int kInt, bool kBool> void foo() { ... }

template <> void foo<float, -7, true>();

If called with I = 0, "float", will be returned. Invalid types will be returned for I == 1 or 2.

Retrieve the value of an Integral TemplateArgument (of a function decl representing a template specialization) as an unsigned long long.

It is undefined to call this function on a CXCursor that does not represent a FunctionDecl or whose I'th template argument is not an integral value.

For example, for the following declaration and specialization: template <typename T, int kInt, bool kBool> void foo() { ... }

template <> void foo<float, 2147483649, true>();

If called with I = 1 or 2, 2147483649 or true will be returned, respectively. For I == 0, this function's behavior is undefined.

Retrieve the value of an Integral TemplateArgument (of a function decl representing a template specialization) as a signed long long.

It is undefined to call this function on a CXCursor that does not represent a FunctionDecl or whose I'th template argument is not an integral value.

For example, for the following declaration and specialization: template <typename T, int kInt, bool kBool> void foo() { ... }

template <> void foo<float, -7, true>();

If called with I = 1 or 2, -7 or true will be returned, respectively. For I == 0, this function's behavior is undefined.

Returns non-zero if the cursor specifies a Record member that is a bitfield.

Determine whether two CXTypes represent the same type.

Returns:
non-zero if the CXTypes represent the same type and zero otherwise.

Retrieve the type of a parameter of a function type.

If a non-function type is passed in or the function does not have enough parameters, an invalid type is returned.

Return the element type of an array type.

If a non-array type is passed in, an invalid type is returned.

Return the array size of a constant array.

If a non-array type is passed in, -1 is returned.

Return the canonical type for a CXType.

Clang's type system explicitly models typedefs and all the ways a specific type can be represented. The canonical type is the underlying type with all the "sugar" removed. For example, if 'T' is a typedef for 'int', the canonical type for 'T' would be 'int'.

Retrieve the return type associated with a given cursor.

This only returns a valid type if the cursor refers to a function or method.

Retrieve the type of a CXCursor (if any).

Returns the access control level for the referenced object.

If the cursor refers to a C++ declaration, its access control level within its parent scope is returned. Otherwise, if the cursor refers to a base specifier or access specifier, the specifier itself is returned.

Returns the Objective-C type encoding for the specified declaration.

Return the element type of an array, complex, or vector type.

If a type is passed in that is not an array, complex, or vector type, an invalid type is returned.

Retrieve the integer value of an enum constant declaration as an unsigned long long.

If the cursor does not reference an enum constant declaration, ULLONG_MAX is returned. Since this is also potentially a valid constant value, the kind of the cursor must be verified before calling this function.

Retrieve the integer value of an enum constant declaration as a signed long long.

If the cursor does not reference an enum constant declaration, LLONG_MIN is returned. Since this is also potentially a valid constant value, the kind of the cursor must be verified before calling this function.

Retrieve the integer type of an enum declaration.

If the cursor does not reference an enum declaration, an invalid type is returned.

Retrieve the bit width of a bit field declaration as an integer.

If a cursor that is not a bit field declaration is passed in, -1 is returned.

Retrieve the calling convention associated with a function type.

If a non-function type is passed in, CXCallingConv_Invalid is returned.

Retrieve the number of non-variadic parameters associated with a function type.

If a non-function type is passed in, -1 is returned.

Return the number of elements of an array or vector type.

If a type is passed in that is not an array or vector type, -1 is returned.

Determine the number of overloaded declarations referenced by a CXCursor_OverloadedDeclRef cursor.

Parameters:
cursorThe cursor whose overloaded declarations are being queried.
Returns:
The number of overloaded declarations referenced by cursor. If it is not a CXCursor_OverloadedDeclRef cursor, returns 0.

Retrieve a cursor for one of the overloaded declarations referenced by a CXCursor_OverloadedDeclRef cursor.

Parameters:
cursorThe cursor whose overloaded declarations are being queried.
indexThe zero-based index into the set of overloaded declarations in the cursor.
Returns:
A cursor representing the declaration referenced by the given cursor at the specified index. If the cursor does not have an associated set of overloaded declarations, or if the index is out of bounds, returns clang_getNullCursor();

For pointer types, returns the type of the pointee.

Retrieve the return type associated with a function type.

If a non-function type is passed in, an invalid type is returned.

Return the cursor for the declaration of the given type.

Retrieve the underlying type of a typedef declaration.

If the cursor does not reference a typedef declaration, an invalid type is returned.

Retrieve the spelling of a given CXTypeKind.

Pretty-print the underlying type using the rules of the language of the translation unit from which it came.

If the type is invalid, an empty string is returned.

Determine whether a CXType has the "const" qualifier set, without looking through typedefs that may have added "const" at a different level.

Return 1 if the CXType is a variadic function type, and 0 otherwise.

Return 1 if the CXType is a POD (plain old data) type, and 0 otherwise.

Determine whether a CXType has the "restrict" qualifier set, without looking through typedefs that may have added "restrict" at a different level.

Returns 1 if the base class specified by the cursor with kind CX_CXXBaseSpecifier is virtual.

Determine whether a CXType has the "volatile" qualifier set, without looking through typedefs that may have added "volatile" at a different level.

Return the alignment of a type in bytes as per C++[expr.alignof] standard.

If the type declaration is invalid, CXTypeLayoutError_Invalid is returned. If the type declaration is an incomplete type, CXTypeLayoutError_Incomplete is returned. If the type declaration is a dependent type, CXTypeLayoutError_Dependent is returned. If the type declaration is not a constant size type, CXTypeLayoutError_NotConstantSize is returned.

Return the class type of an member pointer type.

If a non-member-pointer type is passed in, an invalid type is returned.

Retrieve the ref-qualifier kind of a function or method.

The ref-qualifier is returned for C++ functions or methods. For other types or non-C++ declarations, CXRefQualifier_None is returned.

Returns the number of template arguments for given class template specialization, or -1 if type T is not a class template specialization.

Variadic argument packs count as only one argument, and can not be inspected further.

CINDEX_LINKAGE long long clang_Type_getOffsetOf ( CXType  T,
const char *  S 
)

Return the offset of a field named S in a record of type T in bits as it would be returned by __offsetof__ as per C++11[18.2p4].

If the cursor is not a record field declaration, CXTypeLayoutError_Invalid is returned. If the field's type declaration is an incomplete type, CXTypeLayoutError_Incomplete is returned. If the field's type declaration is a dependent type, CXTypeLayoutError_Dependent is returned. If the field's name S is not found, CXTypeLayoutError_InvalidFieldName is returned.

Return the size of a type in bytes as per C++[expr.sizeof] standard.

If the type declaration is invalid, CXTypeLayoutError_Invalid is returned. If the type declaration is an incomplete type, CXTypeLayoutError_Incomplete is returned. If the type declaration is a dependent type, CXTypeLayoutError_Dependent is returned.

Returns the type template argument of a template class specialization at given index.

This function only returns template type arguments and does not handle template template arguments or variadic packs.