From 8569ef25913f7ed2410e348eced31e48c04258b7 Mon Sep 17 00:00:00 2001 From: Tshepang Lekhonkhobe Date: Thu, 3 Dec 2015 21:09:21 +0200 Subject: [PATCH] doc: add example for std::net::lookup_addr --- src/libstd/net/mod.rs | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/src/libstd/net/mod.rs b/src/libstd/net/mod.rs index 383dce737f511..83a976c42c6ae 100644 --- a/src/libstd/net/mod.rs +++ b/src/libstd/net/mod.rs @@ -134,6 +134,22 @@ pub fn lookup_host(host: &str) -> io::Result { /// This function may perform a DNS query to resolve `addr` and may also inspect /// system configuration to resolve the specified address. If the address /// cannot be resolved, it is returned in string format. +/// +/// # Examples +/// +/// ```no_run +/// #![feature(lookup_addr)] +/// #![feature(ip_addr)] +/// +/// use std::net::{self, Ipv4Addr, IpAddr}; +/// +/// let ip_addr = "8.8.8.8"; +/// let addr: Ipv4Addr = ip_addr.parse().unwrap(); +/// let hostname = net::lookup_addr(&IpAddr::V4(addr)).unwrap(); +/// +/// println!("{} --> {}", ip_addr, hostname); +/// // Output: 8.8.8.8 --> google-public-dns-a.google.com +/// ``` #[unstable(feature = "lookup_addr", reason = "recent addition", issue = "27705")] pub fn lookup_addr(addr: &IpAddr) -> io::Result {