PythonObject

Module

Implements PythonObject.

PythonObject

A Python object.

Fields:

pyObject

A pointer to the underlying Python object.

Functions:

__init__

__init__(self: Self&)

Initialize the object with a None value.

__init__(self: Self&, none: None)

Initialize a none value object from a None literal.

Args:

• none (None): None.

__init__(self: Self&, integer: Int)

Initialize the object with an integer value.

Args:

• integer (Int): The integer value.

__init__(self: Self&, float: FloatLiteral)

Initialize the object with an floating-point value.

Args:

• float (FloatLiteral): The float value.

__init__[dt: DType](self: Self&, value: SIMD[dt, 1])

Initialize the object with a generic scalar value. If the scalar value type is bool, it is converted to a boolean. Otherwise, it is converted to the appropriate integer or floating point type.

Parameters:

• dt (DType): The scalar value type.

Args:

• value (SIMD[dt, 1]): The scalar value.

__init__(self: Self&, value: Bool)

Initialize the object from a bool.

Args:

• value (Bool): The boolean value.

__init__(self: Self&, str: StringLiteral)

Initialize the object from a string literal.

Args:

• str (StringLiteral): The string value.

__init__(self: Self&, str: StringRef)

Initialize the object from a string reference.

Args:

• str (StringRef): The string value.

__init__[*Ts: AnyType](self: Self&, value: ListLiteral[Ts])

Initialize the object from a list literal.

Parameters:

• Ts (*AnyType): The list element types.

Args:

• value (ListLiteral[Ts]): The list value.

__init__[*Ts: AnyType](self: Self&, value: TupleLiteral[Ts])

Initialize the object from a tuple literal.

Parameters:

• Ts (*AnyType): The tuple element types.

Args:

• value (TupleLiteral[Ts]): The tuple value.

__init__(self: Self&, pyObject: PyObjectPtr)

__copyinit__

__copyinit__(self: Self&, existing: Self)

Copy the object.

This increments the underlying refcount of the existing object.

Args:

• existing (Self): The value to copy.

__moveinit__

__moveinit__(self: Self&, existing: Self)

__del__

__del__(self: Self)

Destroy the object.

This decrements the underlying refcount of the pointed-to object.

__bool__

__bool__(self: Self) -> Bool

Evaluate the boolean value of the object.

Returns:

Whether the object evaluates as true.

__getitem__

__getitem__(self: Self, *args: Self) -> Self

Return the value for the given key or keys.

Args:

• args (*Self): The key or keys to access on this object.

Returns:

The value corresponding to the given key for this object.

__neg__

__neg__(self: Self) -> Self

Negative.

Calls the underlying object’s __neg__ method.

Returns:

The result of prefixing this object with a - operator. For most numerical objects, this returns the negative.

__pos__

__pos__(self: Self) -> Self

Positive.

Calls the underlying object’s __pos__ method.

Returns:

The result of prefixing this object with a + operator. For most numerical objects, this does nothing.

__invert__

__invert__(self: Self) -> Self

Inversion.

Calls the underlying object’s __invert__ method.

Returns:

The logical inverse of this object: a bitwise representation where all bits are flipped, from zero to one, and from one to zero.

__lt__

__lt__(self: Self, rhs: Self) -> Self

Less than comparator. This lexicographically compares strings and lists.

Args:

• rhs (Self): Right hand value.

Returns:

True if the object is less than the right hard argument.

__le__

__le__(self: Self, rhs: Self) -> Self

Less than or equal to comparator. This lexicographically compares strings and lists.

Args:

• rhs (Self): Right hand value.

Returns:

True if the object is less than or equal to the right hard argument.

__eq__

__eq__(self: Self, rhs: Self) -> Self

Equality comparator. This compares the elements of strings and lists.

Args:

• rhs (Self): Right hand value.

Returns:

True if the objects are equal.

__ne__

__ne__(self: Self, rhs: Self) -> Self

Inequality comparator. This compares the elements of strings and lists.

Args:

• rhs (Self): Right hand value.

Returns:

True if the objects are not equal.

__gt__

__gt__(self: Self, rhs: Self) -> Self

Greater than comparator. This lexicographically compares the elements of strings and lists.

Args:

• rhs (Self): Right hand value.

Returns:

True if the left hand value is greater.

__ge__

__ge__(self: Self, rhs: Self) -> Self

Greater than or equal to comparator. This lexicographically compares the elements of strings and lists.

Args:

• rhs (Self): Right hand value.

Returns:

True if the left hand value is greater than or equal to the right hand value.

__add__

__add__(self: Self, rhs: Self) -> Self

Addition and concatenation.

Calls the underlying object’s __add__ method.

Args:

• rhs (Self): Right hand value.

Returns:

The sum or concatenated values.

__sub__

__sub__(self: Self, rhs: Self) -> Self

Subtraction.

Calls the underlying object’s __sub__ method.

Args:

• rhs (Self): Right hand value.

Returns:

The difference.

__mul__

__mul__(self: Self, rhs: Self) -> Self

Multiplication.

Calls the underlying object’s __mul__ method.

Args:

• rhs (Self): Right hand value.

Returns:

The product.

__truediv__

__truediv__(self: Self, rhs: Self) -> Self

Division.

Calls the underlying object’s __truediv__ method.

Args:

• rhs (Self): The right-hand-side value by which this object is divided.

Returns:

The result of dividing the right-hand-side value by this.

__floordiv__

__floordiv__(self: Self, rhs: Self) -> Self

Return the division of self and rhs rounded down to the nearest integer.

Calls the underlying object’s __floordiv__ method.

Args:

• rhs (Self): The right-hand-side value by which this object is divided.

Returns:

The result of dividing this by the right-hand-side value, modulo any remainder.

__mod__

__mod__(self: Self, rhs: Self) -> Self

Return the remainder of self divided by rhs.

Calls the underlying object’s __mod__ method.

Args:

• rhs (Self): The value to divide on.

Returns:

The remainder of dividing self by rhs.

__pow__

__pow__(self: Self, rhs: Self) -> Self

Raises this object to the power of the given value.

Args:

• rhs (Self): The exponent.

Returns:

The result of raising this by the given exponent.

__lshift__

__lshift__(self: Self, rhs: Self) -> Self

Bitwise left shift.

Args:

• rhs (Self): The right-hand-side value by which this object is bitwise shifted to the left.

Returns:

This value, shifted left by the given value.

__rshift__

__rshift__(self: Self, rhs: Self) -> Self

Bitwise right shift.

Args:

• rhs (Self): The right-hand-side value by which this object is bitwise shifted to the right.

Returns:

This value, shifted right by the given value.

__and__

__and__(self: Self, rhs: Self) -> Self

Bitwise AND.

Args:

• rhs (Self): The right-hand-side value with which this object is bitwise AND’ed.

Returns:

The bitwise AND result of this and the given value.

__or__

__or__(self: Self, rhs: Self) -> Self

Bitwise OR.

Args:

• rhs (Self): The right-hand-side value with which this object is bitwise OR’ed.

Returns:

The bitwise OR result of this and the given value.

__xor__

__xor__(self: Self, rhs: Self) -> Self

Exclusive OR.

Args:

• rhs (Self): The right-hand-side value with which this object is exclusive OR’ed.

Returns:

The exclusive OR result of this and the given value.

__radd__

__radd__(self: Self, lhs: Self) -> Self

Reverse addition and concatenation.

Calls the underlying object’s __radd__ method.

Args:

• lhs (Self): The left-hand-side value to which this object is added or concatenated.

Returns:

The sum.

__rsub__

__rsub__(self: Self, lhs: Self) -> Self

Reverse subtraction.

Calls the underlying object’s __rsub__ method.

Args:

• lhs (Self): The left-hand-side value from which this object is subtracted.

Returns:

The result of subtracting this from the given value.

__rmul__

__rmul__(self: Self, lhs: Self) -> Self

Reverse multiplication.

Calls the underlying object’s __rmul__ method.

Args:

• lhs (Self): The left-hand-side value that is multiplied by this object.

Returns:

The product of the multiplication.

__rtruediv__

__rtruediv__(self: Self, lhs: Self) -> Self

Reverse division.

Calls the underlying object’s __rtruediv__ method.

Args:

• lhs (Self): The left-hand-side value that is divided by this object.

Returns:

The result of dividing the given value by this.

__rfloordiv__

__rfloordiv__(self: Self, lhs: Self) -> Self

Reverse floor division.

Calls the underlying object’s __rfloordiv__ method.

Args:

• lhs (Self): The left-hand-side value that is divided by this object.

Returns:

The result of dividing the given value by this, modulo any remainder.

__rmod__

__rmod__(self: Self, lhs: Self) -> Self

Reverse modulo.

Calls the underlying object’s __rmod__ method.

Args:

• lhs (Self): The left-hand-side value that is divided by this object.

Returns:

The remainder from dividing the given value by this.

__rpow__

__rpow__(self: Self, lhs: Self) -> Self

Reverse power of.

Args:

• lhs (Self): The number that is raised to the power of this object.

Returns:

The result of raising the given value by this exponent.

__rlshift__

__rlshift__(self: Self, lhs: Self) -> Self

Reverse bitwise left shift.

Args:

• lhs (Self): The left-hand-side value that is bitwise shifted to the left by this object.

Returns:

The given value, shifted left by this.

__rrshift__

__rrshift__(self: Self, lhs: Self) -> Self

Reverse bitwise right shift.

Args:

• lhs (Self): The left-hand-side value that is bitwise shifted to the right by this object.

Returns:

The given value, shifted right by this.

__rand__

__rand__(self: Self, lhs: Self) -> Self

Reverse bitwise and.

Args:

• lhs (Self): The left-hand-side value that is bitwise AND’ed with this object.

Returns:

The bitwise AND result of the given value and this.

__ror__

__ror__(self: Self, lhs: Self) -> Self

Reverse bitwise OR.

Args:

• lhs (Self): The left-hand-side value that is bitwise OR’ed with this object.

Returns:

The bitwise OR result of the given value and this.

__rxor__

__rxor__(self: Self, lhs: Self) -> Self

Reverse exclusive OR.

Args:

• lhs (Self): The left-hand-side value that is exclusive OR’ed with this object.

Returns:

The exclusive OR result of the given value and this.

__iadd__

__iadd__(self: Self&, rhs: Self) -> None

Immediate addition and concatenation.

Args:

• rhs (Self): The right-hand-side value that is added to this object.

__isub__

__isub__(self: Self&, rhs: Self) -> None

Immediate subtraction.

Args:

• rhs (Self): The right-hand-side value that is subtracted from this object.

__imul__

__imul__(self: Self&, rhs: Self) -> None

In-place multiplication.

Calls the underlying object’s __imul__ method.

Args:

• rhs (Self): The right-hand-side value by which this object is multiplied.

__itruediv__

__itruediv__(self: Self&, rhs: Self) -> None

Immediate division.

Args:

• rhs (Self): The value by which this object is divided.

__ifloordiv__

__ifloordiv__(self: Self&, rhs: Self) -> None

Immediate floor division.

Args:

• rhs (Self): The value by which this object is divided.

__imod__

__imod__(self: Self&, rhs: Self) -> None

Immediate modulo.

Args:

• rhs (Self): The right-hand-side value that is used to divide this object.

__ipow__

__ipow__(self: Self&, rhs: Self) -> None

Immediate power of.

Args:

• rhs (Self): The exponent.

__ilshift__

__ilshift__(self: Self&, rhs: Self) -> None

Immediate bitwise left shift.

Args:

• rhs (Self): The right-hand-side value by which this object is bitwise shifted to the left.

__irshift__

__irshift__(self: Self&, rhs: Self) -> None

Immediate bitwise right shift.

Args:

• rhs (Self): The right-hand-side value by which this object is bitwise shifted to the right.

__iand__

__iand__(self: Self&, rhs: Self) -> None

Immediate bitwise AND.

Args:

• rhs (Self): The right-hand-side value with which this object is bitwise AND’ed.

__ixor__

__ixor__(self: Self&, rhs: Self) -> None

Immediate exclusive OR.

Args:

• rhs (Self): The right-hand-side value with which this object is exclusive OR’ed.

__ior__

__ior__(self: Self&, rhs: Self) -> None

Immediate bitwise OR.

Args:

• rhs (Self): The right-hand-side value with which this object is bitwise OR’ed.

__call__

__call__(self: Self, *args: Self) -> Self

Call the underlying object as if it were a function.

Returns:

The return value from the called object.

__getattr__

__getattr__(self: Self, name: StringLiteral) -> Self

Return the value of the object attribute with the given name.

Args:

• name (StringLiteral): The name of the object attribute to return.

Returns:

The value of the object attribute with the given name.

__setattr__

__setattr__(self: Self, name: StringLiteral, newValue: Self) -> None

Set the given value for the object attribute with the given name.

Args:

• name (StringLiteral): The name of the object attribute to set.
• newValue (Self): The new value to be set for that attribute.

__setattr__(self: Self, name: StringLiteral, newValue: PythonDictionary) -> None

Set the given dict for the object attribute with the given name.

Args:

• name (StringLiteral): The name of the object attribute to set.
• newValue (PythonDictionary): The new dict value to be set for that attribute.

to_f64

to_f64(self: Self) -> SIMD[f64, 1]

Returns a float representation of the object.

Returns:

A floating point value that represents this object.

to_index

to_index(self: Self) -> Int

Returns an index representation of the object.

Returns:

An index value that represents this object.

to_string

to_string(self: Self) -> String

Returns a string representation of the object.

Calls the underlying object’s __str__ method.

Returns:

A string that represents this object.