Soup.XMLRPCParams

Fields

None

Methods

free ()

parse (signature)

Details

class Soup.XMLRPCParams

Opaque structure containing XML-RPC methodCall parameter values. Can be parsed using Soup.XMLRPCParams.parse() and freed with Soup.XMLRPCParams.free().

New in version 2.52.

free()

Free a Soup.XMLRPCParams returned by Soup.xmlrpc_parse_request().

New in version 2.52.

parse(signature)
Parameters:

signature (str or None) – A valid GLib.Variant type string, or None

Raises:

GLib.Error

Returns:

a new (non-floating) GLib.Variant, or None

Return type:

GLib.Variant

Parse method parameters returned by Soup.xmlrpc_parse_request().

Deserialization details:

  • If signature is provided, <int> and <i4> can be deserialized to byte, int16, uint16, int32, uint32, int64 or uint64. Otherwise it will be deserialized to int32. If the value is out of range for the target type it will return an error.

  • <struct> will be deserialized to “a{sv}”. signature could define another value type (e.g. “a{ss}”).

  • <array> will be deserialized to “av”. signature could define another element type (e.g. “as”) or could be a tuple (e.g. “(ss)”).

  • <base64> will be deserialized to “ay”.

  • <string> will be deserialized to “s”.

  • <dateTime.iso8601> will be deserialized to an unspecified variant type. If signature is provided it must have the generic “v” type, which means there is no guarantee that it’s actually a datetime that has been received. Soup.xmlrpc_variant_get_datetime() must be used to parse and type check this special variant.

  • signature must not have maybes, otherwise an error is returned.

  • Dictionaries must have string keys, otherwise an error is returned.

New in version 2.52.