Converting Proxies to Strings

This page describes how an application can stringify a proxy and create a property dictionary that captures all the proxy's properties.

Stringifying a Proxy

You can stringify a proxy by calling ice_toString on this proxy, or by reading its description property (from protocol CustomStringConvertible). For example:

MATLAB

let greeter = try makeProxy(
    communicator: communicator,
    proxyString: "greeter:tcp -h localhost -p 4061",
    type: GreeterPrx.self)
    
let s = greeter.description;

ice_toString (or description, which is equivalent) stringifies non-printable ASCII characters and non-ASCII characters in the proxy's identity, facet and object adapter ID as specified through the Ice.ToStringMode property.

Proxy To Property

You can also perform a deeper proxy stringification by calling proxyToProperty on your communicator. For example:

SWIFT

let greeter = try makeProxy(
    communicator: communicator,
    proxyString: "greeter:tcp -h localhost -p 4061",
    type: GreeterPrx.self)
let proxyDict = communicator.proxyToProperty(proxy: greeter, property: "Greeter")

The resulting map or dictionary holds all the proxy properties for the supplied proxy. The second parameter of propertyToProxy is the base name for the properties in the returned map.

Stringifying a Proxy

Proxy To Property

See Also