Skip to content

Latest commit

 

History

History
200 lines (121 loc) · 4.82 KB

types.rst

File metadata and controls

200 lines (121 loc) · 4.82 KB
Raw

Types

llvmlite.ir

All values <ir-values> used in an LLVM module are explicitly typed. All types derive from a common base class Type. You can instantiate most of them directly. Once instantiated, a type should be considered immutable.

The base class for all types. Never instantiate it directly. Types have the following methods in common:

  • as_pointer(addrspace=0)

    Return a PointerType pointing to this type. The optional addrspace integer allows you to choose a non-default address space---the meaning is platform dependent.

  • get_abi_size(target_data)

    Get the ABI size of this type, in bytes, according to the target_data---an llvmlite.binding.TargetData instance.

  • get_abi_alignment(target_data)

    Get the ABI alignment of this type, in bytes, according to the target_data---an llvmlite.binding.TargetData instance.

    NOTE: get_abi_size and get_abi_alignment call into the LLVM C++ API to get the requested information.

  • __call__(value)

    A convenience method to create a Constant of this type with the given value:

    >>> int32 = ir.IntType(32)
>>> c = int32(42)
>>> c
<ir.Constant type='i32' value=42>
>>> print(c)
i32 42

Atomic types

The type of pointers to another type.

Pointer types expose the following attributes:

  • addrspace

    The pointer's address space number. This optional integer allows you to choose a non-default address space---the meaning is platform dependent.

  • pointee

    The type pointed to.

The type of integers. The Python integer bits specifies the bitwidth of the integers having this type.

width

The width in bits.

The type of half-precision, floating-point, real numbers.

The type of single-precision, floating-point, real numbers.

The type of double-precision, floating-point, real numbers.

The class for void types. Used only as the return type of a function without a return value.

Aggregate types

The base class for aggregate types. Never instantiate it directly. Aggregate types have the elements attribute in common.

elements

A tuple-like immutable sequence of element types for this aggregate type.

The class for array types.

  • element is the type of every element.
  • count is a Python integer representing the number of elements.

The class for vector types.

  • element is the type of every element.
  • count is a Python integer representing the number of elements.

The class for literal struct types.

  • elements is a sequence of element types for each member of the structure.
  • packed controls whether to use packed layout.

The class for identified struct types. Identified structs are compared by name. It can be used to make opaque types.

Users should not create new instance directly. Use the Context.get_identified_type method instead.

An identified struct is created without a body (thus opaque). To define the struct body, use the .set_body method.

set_body(*elems)

Define the structure body with a sequence of element types.

Other types

The type of a function.

  • return_type is the return type of the function.
  • args is a sequence describing the types of argument to the function.

  • If var_arg is True, the function takes a variable number of additional arguments of unknown types after the explicit args.

    EXAMPLE:

    int32 = ir.IntType(32)
fnty = ir.FunctionType(int32, (ir.DoubleType(), ir.PointerType(int32)))

    An equivalent C declaration would be:

    typedef int32_t (*fnty)(double, int32_t *);

The type for labels <label>. You do not need to instantiate this type.

The type for metadata. You do not need to instantiate this type.

NOTE: This class was previously called "MetaData," but it was renamed for clarity.