glibmm: Gio::SrvTarget Class Reference
DNS SRV record target. More...
#include <giomm/srvtarget.h>
Public Member Functions |
|
SrvTarget () | |
SrvTarget (GSrvTarget* gobject, bool make_a_copy=true) | |
SrvTarget (const SrvTarget & other) | |
SrvTarget & | operator= (const SrvTarget & other) |
SrvTarget ( SrvTarget && other) noexcept | |
SrvTarget & | operator= ( SrvTarget && other) noexcept |
~SrvTarget () noexcept | |
void | swap ( SrvTarget & other) noexcept |
GSrvTarget* | gobj () |
Provides access to the underlying C instance.
More...
|
|
const GSrvTarget* | gobj () const |
Provides access to the underlying C instance.
More...
|
|
GSrvTarget* | gobj_copy () const |
Provides access to the underlying C instance. The caller is responsible for freeing it. Use when directly setting fields in structs.
More...
|
|
SrvTarget (const Glib::ustring & hostname, guint16 port, guint16 priority, guint16 weight) | |
Glib::ustring | get_hostname () const |
Gets
target's
hostname (in ASCII form; if you are going to present this to the user, you should use Glib::hostname_is_ascii_encoded() to check if it contains encoded Unicode segments, and use Glib::hostname_to_unicode() to convert it if it does.)
More...
|
|
guint16 | get_port () const |
Gets
target's
port.
More...
|
|
guint16 | get_priority () const |
Gets
target's
priority.
More...
|
|
guint16 | get_weight () const |
Gets
target's
weight.
More...
|
|
Static Public Member Functions |
|
static GType | get_type () |
Get the GType for this class, for use with the underlying GObject type system.
More...
|
|
Protected Attributes |
|
GSrvTarget* | gobject_ |
Related Functions |
|
(Note that these are not member functions.) |
|
void | swap ( SrvTarget & lhs, SrvTarget & rhs) noexcept |
Gio::SrvTarget | wrap (GSrvTarget* object, bool take_copy=false) |
A
Glib::wrap()
method for this object.
More...
|
|
Detailed Description
DNS SRV record target.
SRV (service) records are used by some network protocols to provide service-specific aliasing and load-balancing. For example, XMPP (Jabber) uses SRV records to locate the XMPP server for a domain; rather than connecting directly to "example.com" or assuming a specific server hostname like "xmpp.example.com", an XMPP client would look up the "xmpp-client" SRV record for "example.com", and then connect to whatever host was pointed to by that record.
You can use Resolver::lookup_service() or Resolver::lookup_service_async() to find the SrvTargets for a given service. However, if you are simply planning to connect to the remote service, you can use NetworkService 's SocketConnectable interface and not need to worry about SrvTarget at all.
Constructor & Destructor Documentation
Gio::SrvTarget::SrvTarget | ( | ) |
|
explicit |
Gio::SrvTarget::SrvTarget | ( | const SrvTarget & | other | ) |
|
noexcept |
|
noexcept |
Gio::SrvTarget::SrvTarget | ( | const Glib::ustring & | hostname , |
guint16 | port , | ||
guint16 | priority , | ||
guint16 | weight | ||
) |
Member Function Documentation
Glib::ustring Gio::SrvTarget::get_hostname | ( | ) | const |
Gets target's hostname (in ASCII form; if you are going to present this to the user, you should use Glib::hostname_is_ascii_encoded() to check if it contains encoded Unicode segments, and use Glib::hostname_to_unicode() to convert it if it does.)
- Returns
- target's hostname.
guint16 Gio::SrvTarget::get_port | ( | ) | const |
guint16 Gio::SrvTarget::get_priority | ( | ) | const |
Gets target's priority.
You should not need to look at this; Resolver already sorts the targets according to the algorithm in RFC 2782.
- Returns
- target's priority.
|
static |
Get the GType for this class, for use with the underlying GObject type system.
guint16 Gio::SrvTarget::get_weight | ( | ) | const |
Gets target's weight.
You should not need to look at this; Resolver already sorts the targets according to the algorithm in RFC 2782.
- Returns
- target's weight.
|
inline |
Provides access to the underlying C instance.
|
inline |
Provides access to the underlying C instance.
GSrvTarget* Gio::SrvTarget::gobj_copy | ( | ) | const |
Provides access to the underlying C instance. The caller is responsible for freeing it. Use when directly setting fields in structs.
|
noexcept |
Friends And Related Function Documentation
- Parameters
-
lhs The left-hand side rhs The right-hand side
|
related |
A Glib::wrap() method for this object.
- Parameters
-
object The C instance. take_copy False if the result should take ownership of the C instance. True if it should take a new copy or ref.
- Returns
- A C++ instance that wraps this C instance.
Member Data Documentation
|
protected |