Module Py.StringSource

Interface for Python values of type String, Bytes and Unicode.

Sourceval check : Object.t -> bool

check o returns o if o is a Python string (either Bytes or Unicode with Python 3).

Sourceval check_bytes : Object.t -> bool

check_bytes o returns o if o is a Python bytes string.

Sourceval check_unicode : Object.t -> bool

check_unicode o returns o if o is a Python unicode string.

Sourceval format : Object.t -> Object.t -> Object.t

format fmt args returns the formatted Python string from the string format fmt and the arguments args. This is analogous to fmt % args. With Python 2, if fmt is a String, wrapper for PyString_Format. With Python 3 or with Python 2 if fmt is Unicode, wrapper for PyUnicode_Format.

Sourceval as_UTF8_string : Object.t -> Object.t

Wrapper for PyUnicode_AsUTF8String

Sourceval decode_UTF8 : ?errors:string -> ?size:int -> string -> Object.t

Wrapper for PyUnicode_DecodeUTF8. If size is omitted, the length of the string is used by default.

Sourceval decode_UTF16 : ?errors:string -> ?size:int -> ?byteorder:byteorder -> string -> Object.t * byteorder

Wrapper for PyUnicode_DecodeUTF16. If size is omitted, the length of the string is used by default.

Sourceval decode_UTF32 : ?errors:string -> ?size:int -> ?byteorder:byteorder -> string -> Object.t * byteorder

Wrapper for PyUnicode_DecodeUTF32. If size is omitted, the length of the string is used by default.

Sourceval length : Object.t -> int

length s returns the length of the Python string s. A failure (Failure _) is raised if s is neither a Bytes value nor a Unicode value. With Python 2, if s is a String, wrapper for PyString_Size, and if s is Unicode, wrapper for PyUnicode_GetSize, With Python 3, if s is Bytes, wrapper for PyBytes_Size, and if s is Unicode, wrapper for PyUnicode_GetLength.

Sourceval of_string : string -> Object.t

of_string s returns the Python string with the value s. s should be a valid UTF-8 string.

Same as of_string but with an argument of type bytes.

Sourceval to_string : Object.t -> string

to_string o returns the string contained in the Python value o. A failure (Failure _) is raised if o is neither a String/Bytes value nor a Unicode value.

Same as to_string but with an a result of type bytes.

Sourceval of_unicode : ?size:int -> int array -> Object.t

of_unicode codepoints returns the Python Unicode string with the codepoints codepoints.

Sourceval to_unicode : Object.t -> int array

to_unicode s returns the codepoints of the Python Unicode string s.