2.4. Supported Python features

Apart from the Language part below, which applies to both object mode and nopython mode, this page only lists the features supported in nopython mode.

2.4.1. Language

2.4.1.1. Constructs

Numba strives to support as much of the Python language as possible, but some language features are not available inside Numba-compiled functions:

• Function definition
• Class definition
• Exception handling (try .. except, try .. finally)
• Context management (the with statement)

The raise statement is only supported in the simplest form of raising a type without explicitly creating an instance, i.e. raise TypeError is possible but not raise TypeError("some message").

Similarly, the assert statement is only supported without an explicit error message.

2.4.1.2. Function calls

Numba supports function calls using positional and named arguments. *args and **kwargs are not supported.

2.4.2. Built-in types

2.4.2.1. int, bool

Arithmetic operations as well as truth values are supported.

The following attributes and methods are supported:

• .conjugate()
• .real
• .imag

2.4.2.2. float, complex

Arithmetic operations as well as truth values are supported.

The following attributes and methods are supported:

• .conjugate()
• .real
• .imag

2.4.2.3. tuple

Tuple construction and unpacking is supported.

2.4.2.4. None

The None value is supported for identity testing (when using an optional type).

2.4.3. Built-in functions

The following built-in functions are supported:

• abs()
• bool
• complex
• enumerate()
• float
• int: only the one-argument form
• len()
• min(): only the multiple-argument form
• max(): only the multiple-argument form
• print(): only numbers and strings; no file or sep argument
• range
• round(): only the two-argument form
• zip()

2.4.4. Standard library modules

2.4.4.1. cmath

The following functions from the cmath module are supported:

• cmath.acos()
• cmath.acosh()
• cmath.asin()
• cmath.asinh()
• cmath.atan()
• cmath.atanh()
• cmath.cos()
• cmath.cosh()
• cmath.exp()
• cmath.isfinite()
• cmath.isinf()
• cmath.isnan()
• cmath.log()
• cmath.log10()
• cmath.phase()
• cmath.polar()
• cmath.rect()
• cmath.sin()
• cmath.sinh()
• cmath.sqrt()
• cmath.tan()
• cmath.tanh()

2.4.4.2. ctypes

Numba is able to call ctypes-declared functions with the following argument and return types:

• ctypes.c_int8
• ctypes.c_int16
• ctypes.c_int32
• ctypes.c_int64
• ctypes.c_uint8
• ctypes.c_uint16
• ctypes.c_uint32
• ctypes.c_uint64
• ctypes.c_float
• ctypes.c_double
• ctypes.c_void_p

2.4.4.3. math

The following functions from the math module are supported:

• math.acos()
• math.acosh()
• math.asin()
• math.asinh()
• math.atan()
• math.atan2()
• math.atanh()
• math.ceil()
• math.copysign()
• math.cos()
• math.cosh()
• math.degrees()
• math.exp()
• math.expm1()
• math.fabs()
• math.floor()
• math.hypot()
• math.isfinite()
• math.isinf()
• math.isnan()
• math.log()
• math.log10()
• math.log1p()
• math.pow()
• math.radians()
• math.sin()
• math.sinh()
• math.sqrt()
• math.tan()
• math.tanh()
• math.trunc()

2.4.4.4. operator

The following functions from the operator module are supported:

• operator.add()
• operator.and_()
• operator.div() (Python 2 only)
• operator.eq()
• operator.floordiv()
• operator.ge()
• operator.gt()
• operator.iadd()
• operator.iand()
• operator.idiv() (Python 2 only)
• operator.ifloordiv()
• operator.ilshift()
• operator.imod()
• operator.imul()
• operator.invert()
• operator.ior()
• operator.ipow()
• operator.irshift()
• operator.isub()
• operator.itruediv()
• operator.ixor()
• operator.le()
• operator.lshift()
• operator.lt()
• operator.mod()
• operator.mul()
• operator.ne()
• operator.neg()
• operator.not_()
• operator.or_()
• operator.pos()
• operator.pow()
• operator.rshift()
• operator.sub()
• operator.truediv()
• operator.xor()

2.4.5. Third-party modules

2.4.5.1. cffi

Similarly to ctypes, Numba is able to call into cffi-declared external functions, using the following C types:

• char
• short
• int
• long
• long long
• unsigned char
• unsigned short
• unsigned int
• unsigned long
• unsigned long long
• int8_t
• uint8_t
• int16_t
• uint16_t
• int32_t
• uint32_t
• int64_t
• uint64_t
• float
• double
• char *
• void *
• uint8_t *
• ssize_t
• size_t
• void