~ubuntu-branches/ubuntu/trusty/glibmm2.4/trusty

« back to all changes in this revision

Viewing changes to gio/giomm/socketaddressenumerator.h

  • Committer: Package Import Robot
  • Author(s): Robert Ancell
  • Date: 2012-09-28 12:28:45 UTC
  • mfrom: (1.2.77)
  • Revision ID: package-import@ubuntu.com-20120928122845-6h032jivploan2aa
Tags: 2.33.13-0ubuntu2
* debian/rules:
  - Bump shlib version

Show diffs side-by-side

added added

removed removed

Lines of Context:
122
122
   */
123
123
  Glib::RefPtr<SocketAddress> next(const Glib::RefPtr<Cancellable>& cancellable);
124
124
 
125
 
  /** Retrieves the next SocketAddress from the enumerator. 
126
 
   * Note that this may block for some amount of time. (Eg, a NetworkAddress may need to do a DNS lookup before it can return an address.)
127
 
   * Use next_async() if you need to avoid blocking.
128
 
   *
129
 
   * If this enumerator is expected to yield addresses, but for some reason is unable to (eg, because of a DNS error), 
130
 
   * then the first call to next() will throw an exception. However, if the first call to next() succeeds, then any further internal errors 
131
 
   * will be ignored.
132
 
   *
133
 
   * When there are no further addresses, an exception will be thrown.
134
 
   *
135
 
   * @result A SocketAddress
136
 
   */
 
125
  /// A next() convenience overload.
137
126
  Glib::RefPtr<SocketAddress> next();
138
127
 
139
128
  /** Asynchronously retrieves the next SocketAddress from the enumerator and then calls @a slot,