Menu ▾ ▴

[r222]: / docs / html / c___network_library / quick_start.html  Maximize  Restore  History

Download this file

124 lines (116 with data), 13.1 kB 

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
<html>

<head>

<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">

<title>Quick Start</title>

<link rel="stylesheet" href="../../boostbook.css" type="text/css">

<meta name="generator" content="DocBook XSL Stylesheets V1.75.1">

<link rel="home" href="../index.html" title="C++ Network Library 0.4">

<link rel="up" href="../index.html" title="C++ Network Library 0.4">

<link rel="prev" href="../index.html" title="C++ Network Library 0.4">

<link rel="next" href="intro.html" title="Introduction">

</head>

<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">

<table cellpadding="2" width="100%"><tr>

<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="http://www.boost.org/boost.png"></td>

<td align="center"><a href="http://www.boost.org/index.html">Home</a></td>

<td align="center"><a href="http://www.boost.org/libs/libraries.htm">Libraries</a></td>

<td align="center"><a href="http://www.boost.org/users/people.html">People</a></td>

<td align="center"><a href="http://www.boost.org/users/faq.html">FAQ</a></td>

<td align="center"><a href="http://www.boost.org/more/index.htm">More</a></td>

</tr></table>

<hr>

<div class="spirit-nav">

<a accesskey="p" href="../index.html"><img src="http://www.boost.org/doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="http://www.boost.org/doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="http://www.boost.org/doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="intro.html"><img src="http://www.boost.org/doc/html/images/next.png" alt="Next"></a>

</div>

<div class="section" title="Quick Start">

<div class="titlepage"><div><div><h2 class="title" style="clear: both">

<a name="c___network_library.quick_start"></a><a class="link" href="quick_start.html" title="Quick Start"> Quick Start</a>

</h2></div></div></div>

<p>

      </p>

<p>

        Here is an example of C++ Network Library at it's absolute simplest. It downloads

        a file over HTTP from a URL given as a command line argument and prints the

        response to the console.

      </p>

<p>

      </p>

<p>

        

</p>

<pre class="programlisting"><span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">network</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span>

<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">iostream</span><span class="special">&gt;</span>



<span class="keyword">int</span>

<span class="identifier">main</span><span class="special">(</span><span class="keyword">int</span> <span class="identifier">argc</span><span class="special">,</span> <span class="keyword">char</span> <span class="special">*</span><span class="identifier">argv</span><span class="special">[])</span> <span class="special">{</span>

    <span class="keyword">namespace</span> <span class="identifier">http</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">network</span><span class="special">::</span><span class="identifier">http</span><span class="special">;</span>

    

    <span class="keyword">if</span> <span class="special">(</span><span class="identifier">argc</span> <span class="special">!=</span> <span class="number">2</span><span class="special">)</span> <span class="special">{</span>

        <span class="identifier">std</span><span class="special">::</span><span class="identifier">cout</span> <span class="special">&lt;&lt;</span> <span class="string">"Usage: "</span> <span class="special">&lt;&lt;</span> <span class="identifier">argv</span><span class="special">[</span><span class="number">0</span><span class="special">]</span> <span class="special">&lt;&lt;</span> <span class="string">" url"</span> <span class="special">&lt;&lt;</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">endl</span><span class="special">;</span>

        <span class="keyword">return</span> <span class="number">1</span><span class="special">;</span>

    <span class="special">}</span>

    

    <span class="keyword">try</span> <span class="special">{</span>

        <span class="line_callout_bug"><a class="co" name="c___network_library0co" href="quick_start.html#c___network_library0"><img src="http://www.boost.org/doc/src/images/callouts/1.png" alt="1" border="0"></a></span><span class="identifier">http</span><span class="special">::</span><span class="identifier">client</span> <span class="identifier">client</span><span class="special">;</span>

        <span class="line_callout_bug"><a class="co" name="c___network_library1co" href="quick_start.html#c___network_library1"><img src="http://www.boost.org/doc/src/images/callouts/2.png" alt="2" border="0"></a></span><span class="identifier">http</span><span class="special">::</span><span class="identifier">request</span> <span class="identifier">request</span><span class="special">(</span><span class="identifier">argv</span><span class="special">[</span><span class="number">1</span><span class="special">]);</span>

        <span class="line_callout_bug"><a class="co" name="c___network_library2co" href="quick_start.html#c___network_library2"><img src="http://www.boost.org/doc/src/images/callouts/3.png" alt="3" border="0"></a></span><span class="identifier">http</span><span class="special">::</span><span class="identifier">response</span> <span class="identifier">response</span> <span class="special">=</span> <span class="identifier">client</span><span class="special">.</span><span class="identifier">get</span><span class="special">(</span><span class="identifier">request</span><span class="special">);</span>



        <span class="line_callout_bug"><a class="co" name="c___network_library3co" href="quick_start.html#c___network_library3"><img src="http://www.boost.org/doc/src/images/callouts/4.png" alt="4" border="0"></a></span><span class="identifier">headers_range</span><span class="special">&lt;</span><span class="identifier">http</span><span class="special">::</span><span class="identifier">response</span><span class="special">&gt;::</span><span class="identifier">type</span> <span class="identifier">hdrs</span> <span class="special">=</span> <span class="identifier">headers</span><span class="special">(</span><span class="identifier">response</span><span class="special">);</span>

        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">range_iterator</span><span class="special">&lt;</span><span class="identifier">headers_range</span><span class="special">&lt;</span><span class="identifier">http</span><span class="special">::</span><span class="identifier">response</span><span class="special">&gt;::</span><span class="identifier">type</span><span class="special">&gt;::</span><span class="identifier">type</span>

            <span class="identifier">it</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">begin</span><span class="special">(</span><span class="identifier">hdrs</span><span class="special">),</span> <span class="identifier">end</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">end</span><span class="special">(</span><span class="identifier">hdrs</span><span class="special">);</span>

        <span class="keyword">for</span> <span class="special">(;</span> <span class="identifier">it</span> <span class="special">!=</span> <span class="identifier">end</span><span class="special">;</span> <span class="special">++</span><span class="identifier">it</span><span class="special">)</span> <span class="special">{</span>

            <span class="identifier">std</span><span class="special">::</span><span class="identifier">cout</span> <span class="special">&lt;&lt;</span> <span class="identifier">it</span><span class="special">-&gt;</span><span class="identifier">first</span> <span class="special">&lt;&lt;</span> <span class="string">": "</span> <span class="special">&lt;&lt;</span> <span class="identifier">it</span><span class="special">-&gt;</span><span class="identifier">second</span> <span class="special">&lt;&lt;</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">endl</span><span class="special">;</span>

        <span class="special">}</span>



        <span class="line_callout_bug"><a class="co" name="c___network_library4co" href="quick_start.html#c___network_library4"><img src="http://www.boost.org/doc/src/images/callouts/5.png" alt="5" border="0"></a></span><span class="identifier">std</span><span class="special">::</span><span class="identifier">cout</span> <span class="special">&lt;&lt;</span> <span class="identifier">http</span><span class="special">::</span><span class="identifier">body</span><span class="special">(</span><span class="identifier">response</span><span class="special">)</span> <span class="special">&lt;&lt;</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">endl</span><span class="special">;</span>

    <span class="special">}</span>

    <span class="keyword">catch</span> <span class="special">(</span><span class="identifier">std</span><span class="special">::</span><span class="identifier">exception</span> <span class="special">&amp;</span><span class="identifier">e</span><span class="special">)</span> <span class="special">{</span>

        <span class="identifier">std</span><span class="special">::</span><span class="identifier">cerr</span> <span class="special">&lt;&lt;</span> <span class="identifier">e</span><span class="special">.</span><span class="identifier">what</span><span class="special">()</span> <span class="special">&lt;&lt;</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">endl</span><span class="special">;</span>

        <span class="keyword">return</span> <span class="number">1</span><span class="special">;</span>

    <span class="special">}</span>

    

    <span class="keyword">return</span> <span class="number">0</span><span class="special">;</span>

<span class="special">}</span>

</pre>

<p>

      </p>

<p>

      </p>

<p>

        </p>

<div class="calloutlist"><table border="0" summary="Callout list">

<tr>

<td width="5%" valign="top" align="left"><p><a name="c___network_library0"></a><a href="#c___network_library0co"><img src="http://www.boost.org/doc/src/images/callouts/1.png" alt="1" border="0"></a> </p></td>

<td valign="top" align="left"><p> Create the client </p></td>

</tr>

<tr>

<td width="5%" valign="top" align="left"><p><a name="c___network_library1"></a><a href="#c___network_library1co"><img src="http://www.boost.org/doc/src/images/callouts/2.png" alt="2" border="0"></a> </p></td>

<td valign="top" align="left"><p> Create a request using a URI supplied on the command line

        </p></td>

</tr>

<tr>

<td width="5%" valign="top" align="left"><p><a name="c___network_library2"></a><a href="#c___network_library2co"><img src="http://www.boost.org/doc/src/images/callouts/3.png" alt="3" border="0"></a> </p></td>

<td valign="top" align="left"><p> Get a response </p></td>

</tr>

<tr>

<td width="5%" valign="top" align="left"><p><a name="c___network_library3"></a><a href="#c___network_library3co"><img src="http://www.boost.org/doc/src/images/callouts/4.png" alt="4" border="0"></a> </p></td>

<td valign="top" align="left"><p> Iterate through the response headers and print them to the

        console </p></td>

</tr>

<tr>

<td width="5%" valign="top" align="left"><p><a name="c___network_library4"></a><a href="#c___network_library4co"><img src="http://www.boost.org/doc/src/images/callouts/5.png" alt="5" border="0"></a> </p></td>

<td valign="top" align="left"><p> Print the response body to the console </p></td>

</tr>

</table></div>

<p>

      </p>

<p>

    </p>

</div>

<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>

<td align="left"></td>

<td align="right"><div class="copyright-footer">Copyright &#169; 2008 , 2009 Glyn Matthews Dean Michael Berris<p>

        Distributed under the Boost Software License, Version 1.0. (See accompanying

        file LICENSE_1_0.txt or copy at <a href="http://www.boost.org/LICENSE_1_0.txt" target="_top">http://www.boost.org/LICENSE_1_0.txt</a>)

      </p>

</div></td>

</tr></table>

<hr>

<div class="spirit-nav">

<a accesskey="p" href="../index.html"><img src="http://www.boost.org/doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="http://www.boost.org/doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="http://www.boost.org/doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="intro.html"><img src="http://www.boost.org/doc/html/images/next.png" alt="Next"></a>

</div>

</body>

</html>