Class Poco::UPnP::UniqueServiceName

Library: UPnP
Package: Core
Header: Poco/UPnP/UniqueServiceName.h

Description

This class represents a UPnP Unique Service Name (USN), which is used to uniquely identify UPnP devices and services.

A USN consists of one or two URNs, the first one being a UUID URN, the second one a device or service name. The two URNs are separated by two colons.

Examples for valid USNs are:

uuid:C809DE34-C1F8-48A6-81B9-3450E560137D
uuid:C809DE34-C1F8-48A6-81B9-3450E560137D::upnp:rootdevice
uuid:C809DE34-C1F8-48A6-81B9-3450E560137D::urn:schemas-upnp-org:service:RenderingControl:2

This class is mostly intended for splitting USNs into their two parts, or creating USNs from their parts.

Member Functions: toString, urn, uuid

Creates an empty UniqueServiceName.

explicit UniqueServiceName(
const std::string & usn
);

Creates the UniqueServiceName from a string.

Creates an UniqueServiceName for the given UUID.

UniqueServiceName(
const Poco::UUID & uuid,
const URN & urn
);

Creates the UniqueServiceName for the given UUID and URN.

UniqueServiceName(
const std::string & uuid,
const URN & urn
);

Creates the UniqueServiceName for the given UUID and URN.

UniqueServiceName(
const URN & uuid,
const URN & urn
);

Creates the UniqueServiceName for the given UUID and URN. The uuid URN must be of type URN_UUID.

std::string toString() const;

Returns the UniqueServiceName as string.

const URN & urn() const;

Returns the urn part of the UniqueServiceName

const std::string & uuid() const;

Returns the UUID part of the UniqueServiceName.