Module `Py.Object`Source

General functions to handle Python values

Sourcetype t = Pytypes.pyobject

The type of a Python value.

Structural comparison of values of type Py.Object.t rely on Python comparison of underlying values. That is to say, if u and v are two values of type Py.Object.t, and by abuse of notations, if we denote also u and v their respective value in Python, we have u = v in OCaml if and only if u == v in Python, and u < v in OCaml if and only if u < v in Python, etc.

Moreover, there are five values which are handled specially:

Py.null: the value NULL used in the Python API for error case
Py.none: the value None;
Py.Bool.t: the value True;
Py.Bool.f: the value False;
Py.Tuple.empty: the value ().

These values are guaranteed to be unique, so that the physical equality can be used to compare against their definitions: for instance, a value v of type Py.Object.t is None if and only if v == Py.none.

Sourceval del_attr : t -> t -> unit

Wrapper for PyObject_DelAttr

Sourceval del_attr_string : t -> string -> unit

Wrapper for PyObject_DelAttrString

Sourceval del_item : t -> t -> unit

Wrapper for PyObject_DelItem

Sourceval del_item_string : t -> string -> unit

Wrapper for PyObject_DelItemString

Sourceval get_attr : t -> t -> t option

Wrapper for PyObject_GetAttr

Sourceval find_attr : t -> t -> t

Equivalent to get_attr but raises a Not_found exception in case of failure.

Sourceval find_attr_opt : t -> t -> t option

Alias for get_attr.

Sourceval get_attr_string : t -> string -> t option

Wrapper for PyObject_GetAttrString

Sourceval find_attr_string : t -> string -> t

Equivalent to get_attr_string but raises a Not_found exception in case of failure.

Sourceval find_attr_string_opt : t -> string -> t option

Alias for get_attr_string.

Sourceval get_item : t -> t -> t option

Wrapper for PyObject_GetItem

Sourceval find : t -> t -> t

Equivalent to get_item but raises a Not_found exception in case of failure.

Sourceval find_opt : t -> t -> t option

Alias for get_item.

Sourceval get_item_string : t -> string -> t option

get_item_string o key returns the element corresponding to the object key or None on failure.

Sourceval find_string : t -> string -> t

Equivalent to get_item_string but raises a Not_found exception in case of failure.

Sourceval find_string_opt : t -> string -> t option

Alias for get_item_string.

Sourceval get_iter : t -> t

Wrapper for PyObject_GetIter

Sourceval get_type : t -> t

Wrapper for PyObject_GetType

Sourceval has_attr : t -> t -> bool

Wrapper for PyObject_HasAttr

Sourceval has_attr_string : t -> string -> bool

Wrapper for PyObject_HasAttrString

Sourceval hash : t -> int64

Wrapper for PyObject_Hash

Sourceval is_true : t -> bool

Wrapper for PyObject_IsTrue

Sourceval not : t -> bool

Wrapper for PyObject_Not

Sourceval is_instance : t -> t -> bool

Wrapper for PyObject_IsInstance

Sourceval is_subclass : t -> t -> bool

Wrapper for PyObject_IsSubclass

Sourceval print : t -> out_channel file -> unit

Wrapper for PyObject_Print

Sourceval repr : t -> t

Wrapper for PyObject_Repr

Sourceval rich_compare : t -> t -> compare -> t

Wrapper for PyObject_RichCompare

Sourceval rich_compare_bool : t -> t -> compare -> bool

Wrapper for PyObject_RichCompareBool

Sourceval set_attr : t -> t -> t -> unit

Wrapper for PyObject_SetAttr

Sourceval set_attr_string : t -> string -> t -> unit

Wrapper for PyObject_SetAttrString

Sourceval set_item : t -> t -> t -> unit

Wrapper for PyObject_SetItem

Sourceval set_item_string : t -> string -> t -> unit

Wrapper for PyObject_SetItemString

Sourceval str : t -> t

Wrapper for PyObject_Str

Sourceval string_of_repr : t -> string

string_of_repr o returns the string repr o. We have Py.Object.to_string o = Py.String.to_string (Py.Object.repr o).

Sourceval to_string : t -> string

to_string o returns the string str o. We have Py.Object.to_string o = Py.String.to_string (Py.Object.str o).

Sourceval as_char_buffer : t -> string

Wrapper for PyObject_AsCharBuffer

Sourceval as_read_buffer : t -> string

Wrapper for PyObject_AsReadBuffer

Sourceval as_write_buffer : t -> string

Wrapper for PyObject_AsWriteBuffer

Sourceval reference_count : t -> int

reference_count o returns the number of references to the Python object o.

Sourceval format : Format.formatter -> t -> unit

Py.Object.format fmt v is equivalent to Format.pp_print_string fmt (Py.Object.to_string v). Can be used as printer for the top-level: #install_printer Py.Object.format.

Sourceval format_repr : Format.formatter -> t -> unit

Py.Object.format_repr fmt v is equivalent to Format.pp_print_string fmt (Py.Object.string_of_repr v). Can be used as printer for the top-level: #install_printer Py.Object.format_repr.

Sourceval call_function_obj_args : t -> t array -> t

Wrapper for PyObject_CallFunctionObjArgs

Sourceval call_method_obj_args : t -> t -> t array -> t

Wrapper for PyObject_CallMethodObjArgs

Sourceval call_method : t -> string -> t array -> t

Py.Object.call_method o m args is equivalent to Py.Object.call_method_obj_args o (Py.String.of_string m) args.

Sourceval call : t -> t -> t -> t

Wrapper for PyObject_Call

Sourceval size : t -> int

Wrapper for PyObject_Size

Sourceval dir : t -> t

Wrapper for PyObject_Dir

package pyml

Module Py.ObjectSource

Module `Py.Object`Source