| //===--- OperationKinds.def - Operations Database ---------------*- C++ -*-===// |
| // |
| // The LLVM Compiler Infrastructure |
| // |
| // This file is distributed under the University of Illinois Open Source |
| // License. See LICENSE.TXT for details. |
| // |
| //===----------------------------------------------------------------------===// |
| // |
| // This file enumerates the different kinds of operations that can be |
| // performed by various expressions. |
| // |
| //===----------------------------------------------------------------------===// |
| // |
| /// @file OperationKinds.def |
| /// |
| /// In this file, each of the C/C++ operations is enumerated CAST_OPERATION, |
| /// BINARY_OPERATION or UNARY_OPERATION macro, each of which can be specified by |
| /// the code including this file. |
| /// |
| /// Macros had one or two arguments: |
| /// |
| /// Name: The name of the operation. Name (prefixed with CK_, UO_ or BO_) will |
| /// be the name of the corresponding enumerator (see OperationsKinds.h). |
| /// |
| /// Spelling: A string that provides a canonical spelling for the operation. |
| |
| #ifndef CAST_OPERATION |
| # define CAST_OPERATION(Name) |
| #endif |
| |
| #ifndef BINARY_OPERATION |
| # define BINARY_OPERATION(Name, Spelling) |
| #endif |
| |
| #ifndef UNARY_OPERATION |
| # define UNARY_OPERATION(Name, Spelling) |
| #endif |
| |
| //===- Cast Operations ---------------------------------------------------===// |
| |
| /// CK_Dependent - A conversion which cannot yet be analyzed because |
| /// either the expression or target type is dependent. These are |
| /// created only for explicit casts; dependent ASTs aren't required |
| /// to even approximately type-check. |
| /// (T*) malloc(sizeof(T)) |
| /// reinterpret_cast<intptr_t>(A<T>::alloc()); |
| CAST_OPERATION(Dependent) |
| |
| /// CK_BitCast - A conversion which causes a bit pattern of one type |
| /// to be reinterpreted as a bit pattern of another type. Generally |
| /// the operands must have equivalent size and unrelated types. |
| /// |
| /// The pointer conversion char* -> int* is a bitcast. A conversion |
| /// from any pointer type to a C pointer type is a bitcast unless |
| /// it's actually BaseToDerived or DerivedToBase. A conversion to a |
| /// block pointer or ObjC pointer type is a bitcast only if the |
| /// operand has the same type kind; otherwise, it's one of the |
| /// specialized casts below. |
| /// |
| /// Vector coercions are bitcasts. |
| CAST_OPERATION(BitCast) |
| |
| /// CK_LValueBitCast - A conversion which reinterprets the address of |
| /// an l-value as an l-value of a different kind. Used for |
| /// reinterpret_casts of l-value expressions to reference types. |
| /// bool b; reinterpret_cast<char&>(b) = 'a'; |
| CAST_OPERATION(LValueBitCast) |
| |
| /// CK_LValueToRValue - A conversion which causes the extraction of |
| /// an r-value from the operand gl-value. The result of an r-value |
| /// conversion is always unqualified. |
| CAST_OPERATION(LValueToRValue) |
| |
| /// CK_NoOp - A conversion which does not affect the type other than |
| /// (possibly) adding qualifiers. |
| /// int -> int |
| /// char** -> const char * const * |
| CAST_OPERATION(NoOp) |
| |
| /// CK_BaseToDerived - A conversion from a C++ class pointer/reference |
| /// to a derived class pointer/reference. |
| /// B *b = static_cast<B*>(a); |
| CAST_OPERATION(BaseToDerived) |
| |
| /// CK_DerivedToBase - A conversion from a C++ class pointer |
| /// to a base class pointer. |
| /// A *a = new B(); |
| CAST_OPERATION(DerivedToBase) |
| |
| /// CK_UncheckedDerivedToBase - A conversion from a C++ class |
| /// pointer/reference to a base class that can assume that the |
| /// derived pointer is not null. |
| /// const A &a = B(); |
| /// b->method_from_a(); |
| CAST_OPERATION(UncheckedDerivedToBase) |
| |
| /// CK_Dynamic - A C++ dynamic_cast. |
| CAST_OPERATION(Dynamic) |
| |
| /// CK_ToUnion - The GCC cast-to-union extension. |
| /// int -> union { int x; float y; } |
| /// float -> union { int x; float y; } |
| CAST_OPERATION(ToUnion) |
| |
| /// CK_ArrayToPointerDecay - Array to pointer decay. |
| /// int[10] -> int* |
| /// char[5][6] -> char(*)[6] |
| CAST_OPERATION(ArrayToPointerDecay) |
| |
| /// CK_FunctionToPointerDecay - Function to pointer decay. |
| /// void(int) -> void(*)(int) |
| CAST_OPERATION(FunctionToPointerDecay) |
| |
| /// CK_NullToPointer - Null pointer constant to pointer, ObjC |
| /// pointer, or block pointer. |
| /// (void*) 0 |
| /// void (^block)() = 0; |
| CAST_OPERATION(NullToPointer) |
| |
| /// CK_NullToMemberPointer - Null pointer constant to member pointer. |
| /// int A::*mptr = 0; |
| /// int (A::*fptr)(int) = nullptr; |
| CAST_OPERATION(NullToMemberPointer) |
| |
| /// CK_BaseToDerivedMemberPointer - Member pointer in base class to |
| /// member pointer in derived class. |
| /// int B::*mptr = &A::member; |
| CAST_OPERATION(BaseToDerivedMemberPointer) |
| |
| /// CK_DerivedToBaseMemberPointer - Member pointer in derived class to |
| /// member pointer in base class. |
| /// int A::*mptr = static_cast<int A::*>(&B::member); |
| CAST_OPERATION(DerivedToBaseMemberPointer) |
| |
| /// CK_MemberPointerToBoolean - Member pointer to boolean. A check |
| /// against the null member pointer. |
| CAST_OPERATION(MemberPointerToBoolean) |
| |
| /// CK_ReinterpretMemberPointer - Reinterpret a member pointer as a |
| /// different kind of member pointer. C++ forbids this from |
| /// crossing between function and object types, but otherwise does |
| /// not restrict it. However, the only operation that is permitted |
| /// on a "punned" member pointer is casting it back to the original |
| /// type, which is required to be a lossless operation (although |
| /// many ABIs do not guarantee this on all possible intermediate types). |
| CAST_OPERATION(ReinterpretMemberPointer) |
| |
| /// CK_UserDefinedConversion - Conversion using a user defined type |
| /// conversion function. |
| /// struct A { operator int(); }; int i = int(A()); |
| CAST_OPERATION(UserDefinedConversion) |
| |
| /// CK_ConstructorConversion - Conversion by constructor. |
| /// struct A { A(int); }; A a = A(10); |
| CAST_OPERATION(ConstructorConversion) |
| |
| /// CK_IntegralToPointer - Integral to pointer. A special kind of |
| /// reinterpreting conversion. Applies to normal, ObjC, and block |
| /// pointers. |
| /// (char*) 0x1001aab0 |
| /// reinterpret_cast<int*>(0) |
| CAST_OPERATION(IntegralToPointer) |
| |
| /// CK_PointerToIntegral - Pointer to integral. A special kind of |
| /// reinterpreting conversion. Applies to normal, ObjC, and block |
| /// pointers. |
| /// (intptr_t) "help!" |
| CAST_OPERATION(PointerToIntegral) |
| |
| /// CK_PointerToBoolean - Pointer to boolean conversion. A check |
| /// against null. Applies to normal, ObjC, and block pointers. |
| CAST_OPERATION(PointerToBoolean) |
| |
| /// CK_ToVoid - Cast to void, discarding the computed value. |
| /// (void) malloc(2048) |
| CAST_OPERATION(ToVoid) |
| |
| /// CK_VectorSplat - A conversion from an arithmetic type to a |
| /// vector of that element type. Fills all elements ("splats") with |
| /// the source value. |
| /// __attribute__((ext_vector_type(4))) int v = 5; |
| CAST_OPERATION(VectorSplat) |
| |
| /// CK_IntegralCast - A cast between integral types (other than to |
| /// boolean). Variously a bitcast, a truncation, a sign-extension, |
| /// or a zero-extension. |
| /// long l = 5; |
| /// (unsigned) i |
| CAST_OPERATION(IntegralCast) |
| |
| /// CK_IntegralToBoolean - Integral to boolean. A check against zero. |
| /// (bool) i |
| CAST_OPERATION(IntegralToBoolean) |
| |
| /// CK_IntegralToFloating - Integral to floating point. |
| /// float f = i; |
| CAST_OPERATION(IntegralToFloating) |
| |
| /// CK_FloatingToIntegral - Floating point to integral. Rounds |
| /// towards zero, discarding any fractional component. |
| /// (int) f |
| CAST_OPERATION(FloatingToIntegral) |
| |
| /// CK_FloatingToBoolean - Floating point to boolean. |
| /// (bool) f |
| CAST_OPERATION(FloatingToBoolean) |
| |
| // CK_BooleanToSignedIntegral - Convert a boolean to -1 or 0 for true and |
| // false, respectively. |
| CAST_OPERATION(BooleanToSignedIntegral) |
| |
| /// CK_FloatingCast - Casting between floating types of different size. |
| /// (double) f |
| /// (float) ld |
| CAST_OPERATION(FloatingCast) |
| |
| /// CK_CPointerToObjCPointerCast - Casting a C pointer kind to an |
| /// Objective-C pointer. |
| CAST_OPERATION(CPointerToObjCPointerCast) |
| |
| /// CK_BlockPointerToObjCPointerCast - Casting a block pointer to an |
| /// ObjC pointer. |
| CAST_OPERATION(BlockPointerToObjCPointerCast) |
| |
| /// CK_AnyPointerToBlockPointerCast - Casting any non-block pointer |
| /// to a block pointer. Block-to-block casts are bitcasts. |
| CAST_OPERATION(AnyPointerToBlockPointerCast) |
| |
| /// \brief Converting between two Objective-C object types, which |
| /// can occur when performing reference binding to an Objective-C |
| /// object. |
| CAST_OPERATION(ObjCObjectLValueCast) |
| |
| /// \brief A conversion of a floating point real to a floating point |
| /// complex of the original type. Injects the value as the real |
| /// component with a zero imaginary component. |
| /// float -> _Complex float |
| CAST_OPERATION(FloatingRealToComplex) |
| |
| /// \brief Converts a floating point complex to floating point real |
| /// of the source's element type. Just discards the imaginary |
| /// component. |
| /// _Complex long double -> long double |
| CAST_OPERATION(FloatingComplexToReal) |
| |
| /// \brief Converts a floating point complex to bool by comparing |
| /// against 0+0i. |
| CAST_OPERATION(FloatingComplexToBoolean) |
| |
| /// \brief Converts between different floating point complex types. |
| /// _Complex float -> _Complex double |
| CAST_OPERATION(FloatingComplexCast) |
| |
| /// \brief Converts from a floating complex to an integral complex. |
| /// _Complex float -> _Complex int |
| CAST_OPERATION(FloatingComplexToIntegralComplex) |
| |
| /// \brief Converts from an integral real to an integral complex |
| /// whose element type matches the source. Injects the value as |
| /// the real component with a zero imaginary component. |
| /// long -> _Complex long |
| CAST_OPERATION(IntegralRealToComplex) |
| |
| /// \brief Converts an integral complex to an integral real of the |
| /// source's element type by discarding the imaginary component. |
| /// _Complex short -> short |
| CAST_OPERATION(IntegralComplexToReal) |
| |
| /// \brief Converts an integral complex to bool by comparing against |
| /// 0+0i. |
| CAST_OPERATION(IntegralComplexToBoolean) |
| |
| /// \brief Converts between different integral complex types. |
| /// _Complex char -> _Complex long long |
| /// _Complex unsigned int -> _Complex signed int |
| CAST_OPERATION(IntegralComplexCast) |
| |
| /// \brief Converts from an integral complex to a floating complex. |
| /// _Complex unsigned -> _Complex float |
| CAST_OPERATION(IntegralComplexToFloatingComplex) |
| |
| /// \brief [ARC] Produces a retainable object pointer so that it may |
| /// be consumed, e.g. by being passed to a consuming parameter. |
| /// Calls objc_retain. |
| CAST_OPERATION(ARCProduceObject) |
| |
| /// \brief [ARC] Consumes a retainable object pointer that has just |
| /// been produced, e.g. as the return value of a retaining call. |
| /// Enters a cleanup to call objc_release at some indefinite time. |
| CAST_OPERATION(ARCConsumeObject) |
| |
| /// \brief [ARC] Reclaim a retainable object pointer object that may |
| /// have been produced and autoreleased as part of a function return |
| /// sequence. |
| CAST_OPERATION(ARCReclaimReturnedObject) |
| |
| /// \brief [ARC] Causes a value of block type to be copied to the |
| /// heap, if it is not already there. A number of other operations |
| /// in ARC cause blocks to be copied; this is for cases where that |
| /// would not otherwise be guaranteed, such as when casting to a |
| /// non-block pointer type. |
| CAST_OPERATION(ARCExtendBlockObject) |
| |
| /// \brief Converts from _Atomic(T) to T. |
| CAST_OPERATION(AtomicToNonAtomic) |
| /// \brief Converts from T to _Atomic(T). |
| CAST_OPERATION(NonAtomicToAtomic) |
| |
| /// \brief Causes a block literal to by copied to the heap and then |
| /// autoreleased. |
| /// |
| /// This particular cast kind is used for the conversion from a C++11 |
| /// lambda expression to a block pointer. |
| CAST_OPERATION(CopyAndAutoreleaseBlockObject) |
| |
| // Convert a builtin function to a function pointer; only allowed in the |
| // callee of a call expression. |
| CAST_OPERATION(BuiltinFnToFnPtr) |
| |
| // Convert a zero value for OpenCL event_t initialization. |
| CAST_OPERATION(ZeroToOCLEvent) |
| |
| // Convert a pointer to a different address space. |
| CAST_OPERATION(AddressSpaceConversion) |
| |
| // Convert an integer initializer to an OpenCL sampler.
|
| CAST_OPERATION(IntToOCLSampler) |
| |
| //===- Binary Operations -------------------------------------------------===// |
| // Operators listed in order of precedence. |
| // Note that additions to this should also update the StmtVisitor class. |
| |
| // [C++ 5.5] Pointer-to-member operators. |
| BINARY_OPERATION(PtrMemD, ".*") |
| BINARY_OPERATION(PtrMemI, "->*") |
| // [C99 6.5.5] Multiplicative operators. |
| BINARY_OPERATION(Mul, "*") |
| BINARY_OPERATION(Div, "/") |
| BINARY_OPERATION(Rem, "%") |
| // [C99 6.5.6] Additive operators. |
| BINARY_OPERATION(Add, "+") |
| BINARY_OPERATION(Sub, "-") |
| // [C99 6.5.7] Bitwise shift operators. |
| BINARY_OPERATION(Shl, "<<") |
| BINARY_OPERATION(Shr, ">>") |
| // [C99 6.5.8] Relational operators. |
| BINARY_OPERATION(LT, "<") |
| BINARY_OPERATION(GT, ">") |
| BINARY_OPERATION(LE, "<=") |
| BINARY_OPERATION(GE, ">=") |
| // [C99 6.5.9] Equality operators. |
| BINARY_OPERATION(EQ, "==") |
| BINARY_OPERATION(NE, "!=") |
| // [C99 6.5.10] Bitwise AND operator. |
| BINARY_OPERATION(And, "&") |
| // [C99 6.5.11] Bitwise XOR operator. |
| BINARY_OPERATION(Xor, "^") |
| // [C99 6.5.12] Bitwise OR operator. |
| BINARY_OPERATION(Or, "|") |
| // [C99 6.5.13] Logical AND operator. |
| BINARY_OPERATION(LAnd, "&&") |
| // [C99 6.5.14] Logical OR operator. |
| BINARY_OPERATION(LOr, "||") |
| // [C99 6.5.16] Assignment operators. |
| BINARY_OPERATION(Assign, "=") |
| BINARY_OPERATION(MulAssign, "*=") |
| BINARY_OPERATION(DivAssign, "/=") |
| BINARY_OPERATION(RemAssign, "%=") |
| BINARY_OPERATION(AddAssign, "+=") |
| BINARY_OPERATION(SubAssign, "-=") |
| BINARY_OPERATION(ShlAssign, "<<=") |
| BINARY_OPERATION(ShrAssign, ">>=") |
| BINARY_OPERATION(AndAssign, "&=") |
| BINARY_OPERATION(XorAssign, "^=") |
| BINARY_OPERATION(OrAssign, "|=") |
| // [C99 6.5.17] Comma operator. |
| BINARY_OPERATION(Comma, ",") |
| |
| |
| //===- Unary Operations ---------------------------------------------------===// |
| // Note that additions to this should also update the StmtVisitor class. |
| |
| // [C99 6.5.2.4] Postfix increment and decrement |
| UNARY_OPERATION(PostInc, "++") |
| UNARY_OPERATION(PostDec, "--") |
| // [C99 6.5.3.1] Prefix increment and decrement |
| UNARY_OPERATION(PreInc, "++") |
| UNARY_OPERATION(PreDec, "--") |
| // [C99 6.5.3.2] Address and indirection |
| UNARY_OPERATION(AddrOf, "&") |
| UNARY_OPERATION(Deref, "*") |
| // [C99 6.5.3.3] Unary arithmetic |
| UNARY_OPERATION(Plus, "+") |
| UNARY_OPERATION(Minus, "-") |
| UNARY_OPERATION(Not, "~") |
| UNARY_OPERATION(LNot, "!") |
| // "__real expr"/"__imag expr" Extension. |
| UNARY_OPERATION(Real, "__real") |
| UNARY_OPERATION(Imag, "__imag") |
| // __extension__ marker. |
| UNARY_OPERATION(Extension, "__extension__") |
| // [C++ Coroutines] co_await operator |
| UNARY_OPERATION(Coawait, "co_await") |
| |
| #undef CAST_OPERATION |
| #undef BINARY_OPERATION |
| #undef UNARY_OPERATION |