~ubuntu-branches/ubuntu/intrepid/perl-doc-html/intrepid

« back to all changes in this revision

Viewing changes to Net/hostent.html

  • Committer: Bazaar Package Importer
  • Author(s): Roberto C. Sanchez
  • Date: 2008-05-17 20:14:19 UTC
  • mfrom: (1.1.1 upstream)
  • Revision ID: james.westby@ubuntu.com-20080517201419-qgbuogq2ckkdisyi
Tags: 5.10.0-2
Supersede botched upload of 5.10.0-1.

Show diffs side-by-side

added added

removed removed

Lines of Context:
54
54
      <h2>Links:</h2>
55
55
      <ul>
56
56
        <li><a href="http://search.cpan.org">CPAN</a></li>
 
57
        <li><a href="http://www.perl.org">Perl.org</a></li>
57
58
        <li><a href="http://www.perl.com">Perl.com</a></li>
58
 
        <li><a href="http://www.perl.org">Perl.org</a></li>
 
59
        <li><a href="http://perlbuzz.com">Perl Buzz</a></li>
 
60
        <li><a href="http://www.perlfoundation.org/perl5/index.cgi">Perl 5 Wiki</a></li>
 
61
        <li><a href="http://jobs.perl.org">Perl Jobs</a></li>
59
62
        <li><a href="http://www.pm.org">Perl Mongers</a></li>
60
63
        <li><a href="http://www.perlmonks.org">Perl Monks</a></li>
61
64
        <li><a href="http://planet.perl.org">Planet Perl</a></li>
65
68
      <ul>
66
69
        <li>Site maintained by<br><a href="http://perl.jonallen.info">Jon Allen</a>
67
70
            (<a href="http://perl.jonallen.info">JJ</a>)</li>
68
 
        <li class="spaced">Last updated on<br>23 April 2006</li>
 
71
        <li class="spaced">Last updated on<br>23 December 2007</li>
69
72
        <li class="spaced">See the <a href="http://perl.jonallen.info/projects/perldoc">project page</a> for
70
73
        more details</li>
71
74
      </ul>
76
79
    <div id="centerContent">
77
80
      <div id="contentHeader">
78
81
        <div id="contentHeaderLeft"><a href="#" onClick="showLeft()">Show navigation</a></div>
79
 
        <div id="contentHeaderCentre">-- Perl 5.8.8 documentation --</div>
 
82
        <div id="contentHeaderCentre">-- Perl 5.10.0 documentation --</div>
80
83
        <div id="contentHeaderRight"><a href="#" onClick="showRight()">Show toolbar</a></div>
81
84
      </div>
82
85
      <div id="breadCrumbs"><a href="../index.html">Home</a> &gt; <a href="../index-modules-A.html">Core modules</a> &gt; <a href="../index-modules-N.html">N</a> &gt; Net::hostent</div>
84
87
      <div id="contentBody"><div class="title_container"><div class="page_title">Net::hostent</div></div><ul><li><a href="#NAME">NAME</a><li><a href="#SYNOPSIS">SYNOPSIS</a><li><a href="#DESCRIPTION">DESCRIPTION</a><li><a href="#EXAMPLES">EXAMPLES</a><li><a href="#NOTE">NOTE</a><li><a href="#AUTHOR">AUTHOR</a></ul><a name="NAME"></a><h1>NAME</h1>
85
88
<p>Net::hostent - by-name interface to Perl's built-in gethost*() functions</p>
86
89
<a name="SYNOPSIS"></a><h1>SYNOPSIS</h1>
87
 
<pre class="verbatim"> <a class="l_k" href="../functions/use.html">use</a> <a class="l_w" href="../Net/hostent.html">Net::hostent</a><span class="sc">;</span></pre>
 
90
<pre class="verbatim"> <a class="l_k" href="../functions/use.html">use</a> <span class="w">Net::hostent</span><span class="sc">;</span></pre>
88
91
<a name="DESCRIPTION"></a><h1>DESCRIPTION</h1>
89
92
<p>This module's default exports override the core gethostbyname() and
90
93
gethostbyaddr() functions, replacing them with versions that return
97
100
<p>You may also import all the structure fields directly into your namespace
98
101
as regular variables using the :FIELDS import tag.  (Note that this still
99
102
overrides your core functions.)  Access these fields as variables named
100
 
with a preceding <code class="inline">h_</code>
 
103
with a preceding <code class="inline"><span class="w">h_</span></code>
101
104
.  Thus, <code class="inline"><span class="i">$host_obj</span><span class="i">-&gt;name</span><span class="s">(</span><span class="s">)</span></code>
102
105
 corresponds to
103
106
$h_name if you import the fields.  Array references are available as
111
114
pass the <code class="inline"><a class="l_k" href="../functions/use.html">use</a></code> an empty import list, and then access
112
115
function functions with their full qualified names.
113
116
On the other hand, the built-ins are still available
114
 
via the <code class="inline">CORE::</code>
 
117
via the <code class="inline"><span class="w">CORE::</span></code>
115
118
 pseudo-package.</p>
116
119
<a name="EXAMPLES"></a><h1>EXAMPLES</h1>
117
 
<pre class="verbatim"> <a class="l_k" href="../functions/use.html">use</a> <a class="l_w" href="../Net/hostent.html">Net::hostent</a><span class="sc">;</span>
118
 
 <a class="l_k" href="../functions/use.html">use</a> <a class="l_w" href="../Socket.html">Socket</a><span class="sc">;</span></pre>
 
120
<pre class="verbatim"> <a class="l_k" href="../functions/use.html">use</a> <span class="w">Net::hostent</span><span class="sc">;</span>
 
121
 <a class="l_k" href="../functions/use.html">use</a> <span class="w">Socket</span><span class="sc">;</span></pre>
119
122
<pre class="verbatim"> <span class="i">@ARGV</span> = <span class="s">(</span><span class="q">&#39;netscape.com&#39;</span><span class="s">)</span> unless <span class="i">@ARGV</span><span class="sc">;</span></pre>
120
123
<pre class="verbatim"> for $host ( @ARGV ) {</pre><pre class="verbatim">    unless <span class="s">(</span><span class="i">$h</span> = <span class="i">gethost</span><span class="s">(</span><span class="i">$host</span><span class="s">)</span><span class="s">)</span> <span class="s">{</span>
121
124
        <a class="l_k" href="../functions/warn.html">warn</a> <span class="q">&quot;$0: no such host: $host\n&quot;</span><span class="sc">;</span>
126
129
            <a class="l_k" href="../functions/lc.html">lc</a><span class="s">(</span><span class="i">$h</span><span class="i">-&gt;name</span><span class="s">)</span> eq <a class="l_k" href="../functions/lc.html">lc</a><span class="s">(</span><span class="i">$host</span><span class="s">)</span> ? <span class="q">&quot;&quot;</span> <span class="co">:</span> <span class="q">&quot;*really* &quot;</span><span class="cm">,</span>
127
130
            <span class="i">$h</span><span class="i">-&gt;name</span><span class="sc">;</span></pre>
128
131
<pre class="verbatim">    <a class="l_k" href="../functions/print.html">print</a> <span class="q">&quot;\taliases are &quot;</span><span class="cm">,</span> <a class="l_k" href="../functions/join.html">join</a><span class="s">(</span><span class="q">&quot;, &quot;</span><span class="cm">,</span> <span class="i">@</span>{<span class="i">$h</span><span class="i">-&gt;aliases</span>}<span class="s">)</span><span class="cm">,</span> <span class="q">&quot;\n&quot;</span>
129
 
                if <span class="i">@</span>{<span class="i">$h</span><span class="i">-&gt;aliases</span>}<span class="sc">;</span>     </pre>
 
132
                if <span class="i">@</span>{<span class="i">$h</span><span class="i">-&gt;aliases</span>}<span class="sc">;</span></pre>
130
133
<pre class="verbatim">    if <span class="s">(</span> <span class="i">@</span>{<span class="i">$h</span><span class="i">-&gt;addr_list</span>} &gt; <span class="n">1</span> <span class="s">)</span> <span class="s">{</span> 
131
134
        <a class="l_k" href="../functions/my.html">my</a> <span class="i">$i</span><span class="sc">;</span>
132
135
        for <span class="i">$addr</span> <span class="s">(</span> <span class="i">@</span>{<span class="i">$h</span><span class="i">-&gt;addr_list</span>} <span class="s">)</span> <span class="s">{</span>
134
137
        <span class="s">}</span> 
135
138
    <span class="s">}</span> else <span class="s">{</span>
136
139
        <a class="l_k" href="../functions/printf.html">printf</a> <span class="q">&quot;\taddress is [%s]\n&quot;</span><span class="cm">,</span> <span class="i">inet_ntoa</span><span class="s">(</span><span class="i">$h</span><span class="i">-&gt;addr</span><span class="s">)</span><span class="sc">;</span>
137
 
    <span class="s">}</span> </pre>
 
140
    <span class="s">}</span></pre>
138
141
<pre class="verbatim">    if ($h = gethostbyaddr($h-&gt;addr)) {
139
142
        if (lc($h-&gt;name) ne lc($host)) {
140
143
            printf "\tThat addr reverses to host %s!\n", $h-&gt;name;
164
167
          <!--<select name="r"><option value="1" selected>Go to top result<option value="0">Show results list</select>-->
165
168
        </form>
166
169
      </p>
 
170
      <script language="JavaScript" type="text/javascript" src="/perl-version.js"></script>
167
171
      <h2>Labels:</h2>
168
172
      <p>
169
173
        <a href="#" onClick="addLabel('Net::hostent','Net/hostent.html')">Add this page</a>