[boost-doc-zh] r294 committed - [No log message]

From: codesite-noreply@xxxxxxxxxx
To: boost-doc-zh-notify@xxxxxxxxxxxxx
Date: Tue, 25 Aug 2009 05:10:22 +0000

Revision: 294
Author: totti19851101
Date: Mon Aug 24 22:09:55 2009
Log: [No log message]
http://code.google.com/p/boost-doc-zh/source/detail?r=294

Modified:
 /trunk/doc/html/boost_asio/tutorial/tutdaytime1.html

=======================================

--- /trunk/doc/html/boost_asio/tutorial/tutdaytime1.html Wed May 2703:09:50 2009+++ /trunk/doc/html/boost_asio/tutorial/tutdaytime1.html Mon Aug 2422:09:55 2009

@@ -1,6 +1,6 @@
 <html>
 <head>
-<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>Daytime.1 - A synchronous TCP daytime client</title>
 <link rel="stylesheet" href="../../boostbook.css" type="text/css">
 <meta name="generator" content="DocBook XSL Stylesheets V1.74.3">
@@ -24,23 +24,20 @@
 </div>
 <div class="section" lang="en">
 <div class="titlepage"><div><div><h3 class="title">

-<a name="boost_asio.tutorial.tutdaytime1"></a><a class="link"href="tutdaytime1.html" title="Daytime.1 - A synchronous TCP daytimeclient"> Daytime.1 - A synchronous

-      TCP daytime client</a>

+<a name="boost_asio.tutorial.tutdaytime1"></a><a class="link"href="tutdaytime1.html" title="Daytime.1 - A synchronous TCP daytimeclient"> Daytime.1 - 同步TCP daytime客户端</a>

 </h3></div></div></div>
 <p>

- This tutorial program shows how to use asio to implement a clientapplication

-        with TCP.
+        本示例程序显示如何使用Asio来实现一个TCP客户端程序。
       </p>
 <p>
-        We start by including the necessary header files.
+       让我们从添加必需的头文件开始。
       </p>

<pre class="programlisting">#include<<spanclass="identifier">iostream>#include <spanclass="special"><boost<spanclass="special">/array<spanclass="special">.hpp<spanclass="special">>#include <spanclass="special"><boost<spanclass="special">/asio<spanclass="special">.hpp<spanclass="special">>

 </pre>
 <p>

- The purpose of this application is to access a daytime service, sowe need

-        the user to specify the server.

+ 这个应用程序的目的是访问一个daytime服务器，因此我们需要用户去指定服务器。（如time-nw.nist.gov,用IP亦可）。

       </p>

<pre class="programlisting">using <spanclass="identifier">boost::<spanclass="identifier">asio::<spanclass="identifier">ip::<spanclass="identifier">tcp;


@@ -55,38 +52,33 @@
     <span class="special">}</span>
 </pre>
 <p>

- All programs that use asio need to have at least one <aclass="link" href="../reference/io_service.html"title="io_service">io_service</a>

-        object.

+ 所有使用asio的程序都至少需要一个<a class="link"href="../reference/io_service.html" title="io_service">io_service</a>

+        对象。
       </p>

<pre class="programlisting"> boost<spanclass="special">::asio<spanclass="special">::io_service <spanclass="identifier">io_service;

 </pre>
 <p>

- We need to turn the server name that was specified as a parameterto the- application, into a TCP endpoint. To do this we use an <aclass="link" href="../reference/ip__tcp/resolver.html"title="ip::tcp::resolver">ip::tcp::resolver</a>

-        object.

+ 我们需要把服务器的名称转化为TCP的节点，而该名称是通过应用程序的参数指定的。我们使用<a class="link" href="../reference/ip__tcp/resolver.html"title="ip::tcp::resolver">ip::tcp::resolver</a>

+        对象来完成。
       </p>

<pre class="programlisting"> tcp<spanclass="special">::resolver <spanclass="identifier">resolver(<spanclass="identifier">io_service);

 </pre>
 <p>

- A resolver takes a query object and turns it into a list ofendpoints. We- construct a query using the name of the server, specified in <codeclass="computeroutput">argv<spanclass="special">[1<spanclass="special">]</code>, and the name of the service, in this case- <code class="computeroutput"><spanclass="string">"daytime"</code>.+ 一个resolver对象获得一个query对象,并将其转换为节点列表.我们通过<code class="computeroutput">argv<spanclass="special">[1<spanclass="special">]</code>中的服务器名称和服务名，在这里是+ <code class="computeroutput"><spanclass="string">"daytime"</code>，构造一个query。

       </p>

 </pre>
 <p>

- The list of endpoints is returned using an iterator of type <aclass="link" href="../reference/ip__basic_resolver/iterator.html"title="ip::basic_resolver::iterator">ip::tcp::resolver::iterator</a>.- A default constructed <a class="link"href="../reference/ip__basic_resolver/iterator.html"title="ip::basic_resolver::iterator">ip::tcp::resolver::iterator</a>

-        object is used as the end iterator.

+ 节点列表用<a class="link"href="../reference/ip__basic_resolver/iterator.html"title="ip::basic_resolver::iterator">ip::tcp::resolver::iterator</a>类型的迭代器返回。+ 返回的iterator将采用<a class="link"href="../reference/ip__basic_resolver/iterator.html"title="ip::basic_resolver::iterator">ip::tcp::resolver::iterator</a>

+        的默认构造函数来构造。
       </p>

<pre class="programlisting"> tcp<spanclass="special">::resolver<spanclass="special">::iterator <spanclass="identifier">endpoint_iterator =resolver.<spanclass="identifier">resolve(<spanclass="identifier">query);tcp<spanclass="special">::resolver<spanclass="special">::iterator <spanclass="identifier">end;

 </pre>
 <p>

- Now we create and connect the socket. The list of endpointsobtained above- may contain both IPv4 and IPv6 endpoints, so we need to try eachof them- until we find one that works. This keeps the client programindependent of

-        a specific IP version.

+ 现在我们建立一个socket并连接之,由于获得的节点既有IPv4也有IPv6的。所以,我们需要依次尝试访问它们直到找到一个可以正常工作的。这样做可使得我们的程序独立于特定的IP版本。

       </p>

<pre class="programlisting"> tcp<spanclass="special">::socket <spanclass="identifier">socket(<spanclass="identifier">io_service);boost<spanclass="special">::system<spanclass="special">::error_code <spanclass="identifier">error = <spanclass="identifier">boost::<spanclass="identifier">asio::<spanclass="identifier">error::<spanclass="identifier">host_not_found;

@@ -99,15 +91,11 @@

throw <spanclass="identifier">boost::<spanclass="identifier">system::<spanclass="identifier">system_error(<spanclass="identifier">error);

 </pre>
 <p>

- The connection is open. All we need to do now is read the responsefrom the

-        daytime service.
+        连接打开后，现在我们需要做的就是读取daytime服务器的响应。
       </p>
 <p>

- We use a <code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">array</code> to hold the received data. Theboost::asio::buffer()- function automatically determines the size of the array to helpprevent buffer- overruns. Instead of a <code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">array</code>,- we could have used a <code class="computeroutput"><spanclass="keyword">char []</code>- or <code class="computeroutput"><spanclass="identifier">std::<spanclass="identifier">vector</code>.+ 我们使用<code class="computeroutput"><spanclass="identifier">boost::<spanclass="identifier">array</code>来存放接收到的数据。 Theboost::asio::buffer()+ 函数会自动确定array的长度来防止缓冲区溢出。我们也可以使用 char []或 std::vector来代替boost::array。

       </p>

<pre class="programlisting"> for <spanclass="special">(;;)

     <span class="special">{</span>
@@ -117,9 +105,8 @@

size_t <spanclass="identifier">len = <spanclass="identifier">socket.<spanclass="identifier">read_some(<spanclass="identifier">boost::<spanclass="identifier">asio::<spanclass="identifier">buffer(<spanclass="identifier">buf), <spanclass="identifier">error);

 </pre>
 <p>

- When the server closes the connection, the <a class="link"href="../reference/basic_stream_socket/read_some.html"title="basic_stream_socket::read_some">ip::tcp::socket::read_some()</a>- function will exit with the boost::asio::error::eof error, whichis how we

-        know to exit the loop.

+ 当服务器关闭连接时,<a class="link"href="../reference/basic_stream_socket/read_some.html"title="basic_stream_socket::read_some">ip::tcp::socket::read_some()</a>+ 函数会以boost::asio::error::eof错误标志返回, 通过该错误标志，我们知道应该退出循环了。

       </p>

<pre class="programlisting"> if <spanclass="special">(error <spanclass="special">== boost<spanclass="special">::asio<spanclass="special">::error<spanclass="special">::eof<spanclass="special">)break;// Connection closed cleanly by peer.

@@ -130,7 +117,7 @@
     <span class="special">}</span>
 </pre>
 <p>
-        Finally, handle any exceptions that may have been thrown.
+        最后，处理所有可能抛出的异常 。
       </p>
 <pre class="programlisting">  <span class="special">}</span>

catch (<spanclass="identifier">std::<spanclass="identifier">exception& <spanclass="identifier">e)

@@ -139,14 +126,13 @@
   <span class="special">}</span>
 </pre>
 <p>

- See the <a class="link" href="tutdaytime1/src.html" title="Sourcelisting for Daytime.1">full source listing</a>+ 查看<a class="link" href="tutdaytime1/src.html" title="Sourcelisting for Daytime.1">本例全部源代码</a>

       </p>
 <p>

- Return to the <a class="link" href="../tutorial.html"title="Tutorial">tutorial index</a>+ 返回<a class="link" href="../tutorial.html" title="Tutorial">指南</a>

       </p>
 <p>

- Next: <a class="link" href="tutdaytime2.html" title="Daytime.2 - Asynchronous TCP daytime server">Daytime.2 - A synchronous

-        TCP daytime server</a>

+ 下一例: <a class="link" href="tutdaytime2.html" title="Daytime.2 -A synchronous TCP daytime server">Daytime.2 - 同步TCP daytime服务器</a>

       </p>
 </div>

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

[boost-doc-zh] r294 committed - [No log message]

Other related posts: