diff options
Diffstat (limited to 'doc/html/chrono.html')
-rw-r--r-- | doc/html/chrono.html | 72 |
1 files changed, 45 insertions, 27 deletions
diff --git a/doc/html/chrono.html b/doc/html/chrono.html index d48fd51627..746acf30da 100644 --- a/doc/html/chrono.html +++ b/doc/html/chrono.html @@ -1,12 +1,12 @@ <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=US-ASCII"> -<title>Chapter 4. Boost.Chrono 1.2.3</title> +<title>Chapter 6. Boost.Chrono 2.0.4</title> <link rel="stylesheet" href="../../doc/src/boostbook.css" type="text/css"> -<meta name="generator" content="DocBook XSL Stylesheets V1.76.1"> +<meta name="generator" content="DocBook XSL Stylesheets V1.78.1"> <link rel="home" href="index.html" title="The Boost C++ Libraries BoostBook Documentation Subset"> <link rel="up" href="libraries.html" title="Part I. The Boost C++ Libraries (BoostBook Subset)"> -<link rel="prev" href="array/ack.html" title="Acknowledgements"> +<link rel="prev" href="atomic/porting.html" title="Porting"> <link rel="next" href="chrono/users_guide.html" title="User's Guide"> </head> <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> @@ -20,12 +20,12 @@ </tr></table> <hr> <div class="spirit-nav"> -<a accesskey="p" href="array/ack.html"><img src="../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="libraries.html"><img src="../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="index.html"><img src="../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="chrono/users_guide.html"><img src="../../doc/src/images/next.png" alt="Next"></a> +<a accesskey="p" href="atomic/porting.html"><img src="../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="libraries.html"><img src="../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="index.html"><img src="../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="chrono/users_guide.html"><img src="../../doc/src/images/next.png" alt="Next"></a> </div> <div class="chapter"> <div class="titlepage"><div> <div><h2 class="title"> -<a name="chrono"></a>Chapter 4. Boost.Chrono 1.2.3</h2></div> +<a name="chrono"></a>Chapter 6. Boost.Chrono 2.0.4</h2></div> <div><div class="author"><h3 class="author"> <span class="firstname">Howard</span> <span class="surname">Hinnant</span> </h3></div></div> @@ -37,8 +37,7 @@ </h3></div></div> <div><p class="copyright">Copyright © 2008 Howard Hinnant</p></div> <div><p class="copyright">Copyright © 2006, 2008 Beman Dawes</p></div> -<div><p class="copyright">Copyright © 2009-2011 Vicente J. Botet - Escriba</p></div> +<div><p class="copyright">Copyright © 2009-2013 Vicente J. Botet Escriba</p></div> <div><div class="legalnotice"> <a name="chrono.legal"></a><p> Distributed under the Boost Software License, Version 1.0. (See accompanying @@ -48,7 +47,7 @@ </div></div> <div class="toc"> <p><b>Table of Contents</b></p> -<dl> +<dl class="toc"> <dt><span class="section"><a href="chrono.html#chrono.overview">Overview</a></span></dt> <dd><dl> <dt><span class="section"><a href="chrono.html#chrono.overview.motivation">Motivation</a></span></dt> @@ -65,7 +64,8 @@ <dd><dl> <dt><span class="section"><a href="chrono/reference.html#chrono.reference.chrono_include_hpp">Header <code class="computeroutput"><span class="special"><</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">chrono</span><span class="special">/</span><span class="identifier">include</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">></span></code></a></span></dt> <dt><span class="section"><a href="chrono/reference.html#chrono.reference.cpp0x">Included on the C++11 Recommendation</a></span></dt> -<dt><span class="section"><a href="chrono/reference.html#chrono.reference.io">Chrono I/O</a></span></dt> +<dt><span class="section"><a href="chrono/reference.html#chrono.reference.io_v1">Chrono I/O V1</a></span></dt> +<dt><span class="section"><a href="chrono/reference.html#chrono.reference.io">Chrono I/O V2</a></span></dt> <dt><span class="section"><a href="chrono/reference.html#chrono.reference.round">Chrono Rounding Utilities</a></span></dt> <dt><span class="section"><a href="chrono/reference.html#chrono.reference.other_clocks">Other Clocks</a></span></dt> </dl></dd> @@ -91,7 +91,7 @@ <div class="titlepage"><div><div><h2 class="title" style="clear: both"> <a name="chrono.overview"></a><a class="link" href="chrono.html#chrono.overview" title="Overview">Overview</a> </h2></div></div></div> -<div class="toc"><dl> +<div class="toc"><dl class="toc"> <dt><span class="section"><a href="chrono.html#chrono.overview.motivation">Motivation</a></span></dt> <dt><span class="section"><a href="chrono.html#chrono.overview.description">Description</a></span></dt> </dl></div> @@ -104,13 +104,13 @@ </p></blockquote></div> <h4> <a name="chrono.overview.h0"></a> - <span><a name="chrono.overview.how_to_use_this_documentation"></a></span><a class="link" href="chrono.html#chrono.overview.how_to_use_this_documentation">How + <span class="phrase"><a name="chrono.overview.how_to_use_this_documentation"></a></span><a class="link" href="chrono.html#chrono.overview.how_to_use_this_documentation">How to Use This Documentation</a> </h4> <p> This documentation makes use of the following naming and formatting conventions. </p> -<div class="itemizedlist"><ul class="itemizedlist" type="disc"> +<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "> <li class="listitem"> Code is in <code class="computeroutput"><span class="identifier">fixed</span> <span class="identifier">width</span> <span class="identifier">font</span></code> and is syntax-highlighted. @@ -159,7 +159,7 @@ </h3></div></div></div> <h5> <a name="chrono.overview.motivation.h0"></a> - <span><a name="chrono.overview.motivation.time"></a></span><a class="link" href="chrono.html#chrono.overview.motivation.time">Time</a> + <span class="phrase"><a name="chrono.overview.motivation.time"></a></span><a class="link" href="chrono.html#chrono.overview.motivation.time">Time</a> </h5> <p> We all deal with time every day of our lives. We've intuitively known it @@ -178,11 +178,11 @@ </p> <p> In addition to the clocks provided by the standard proposal, <span class="bold"><strong>Boost.Chrono</strong></span> - provides specific process clocks and a thread clock. + provides specific process and thread clocks. </p> <h5> <a name="chrono.overview.motivation.h1"></a> - <span><a name="chrono.overview.motivation.wall_clock_versus_system_and_user_time"></a></span><a class="link" href="chrono.html#chrono.overview.motivation.wall_clock_versus_system_and_user_time">Wall + <span class="phrase"><a name="chrono.overview.motivation.wall_clock_versus_system_and_user_time"></a></span><a class="link" href="chrono.html#chrono.overview.motivation.wall_clock_versus_system_and_user_time">Wall clock versus system and user time</a> </h5> <p> @@ -204,9 +204,9 @@ </p> <h5> <a name="chrono.overview.description.h0"></a> - <span><a name="chrono.overview.description.standard"></a></span><a class="link" href="chrono.html#chrono.overview.description.standard">Standard</a> + <span class="phrase"><a name="chrono.overview.description.standard"></a></span><a class="link" href="chrono.html#chrono.overview.description.standard">Standard</a> </h5> -<div class="itemizedlist"><ul class="itemizedlist" type="disc"> +<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "> <li class="listitem"> A means to represent time durations: managed by the generic <a class="link" href="chrono/reference.html#chrono.reference.cpp0x.duration_hpp.duration" title="Class Template duration<>"><code class="computeroutput"><span class="identifier">duration</span></code></a> class . Examples of time durations include days, <a class="link" href="chrono/reference.html#chrono.reference.cpp0x.duration_hpp.duration_typedefs" title="duration typedefs"><code class="computeroutput"><span class="identifier">minutes</span></code></a>, <a class="link" href="chrono/reference.html#chrono.reference.cpp0x.duration_hpp.duration_typedefs" title="duration typedefs"><code class="computeroutput"><span class="identifier">seconds</span></code></a> and <a class="link" href="chrono/reference.html#chrono.reference.cpp0x.duration_hpp.duration_typedefs" title="duration typedefs"><code class="computeroutput"><span class="identifier">nanoseconds</span></code></a>, which can be represented @@ -228,7 +228,7 @@ </ul></div> <h5> <a name="chrono.overview.description.h1"></a> - <span><a name="chrono.overview.description.other_clocks"></a></span><a class="link" href="chrono.html#chrono.overview.description.other_clocks">Other + <span class="phrase"><a name="chrono.overview.description.other_clocks"></a></span><a class="link" href="chrono.html#chrono.overview.description.other_clocks">Other clocks</a> </h5> <p> @@ -237,7 +237,7 @@ time APIs, thereby allowing the extraction of wall clock time, user CPU time, system CPU time spent by the process, </p> -<div class="itemizedlist"><ul class="itemizedlist" type="disc"> +<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "> <li class="listitem"> <a class="link" href="chrono/reference.html#chrono.reference.other_clocks.process_cpu_clocks_hpp.process_real_cpu_clock" title="Class process_real_cpu_clock"><code class="computeroutput"><span class="identifier">process_real_cpu_clock</span></code></a>, captures wall clock CPU time spent by the current process. @@ -266,17 +266,35 @@ </p> <h5> <a name="chrono.overview.description.h2"></a> - <span><a name="chrono.overview.description.i_o"></a></span><a class="link" href="chrono.html#chrono.overview.description.i_o">I/O</a> + <span class="phrase"><a name="chrono.overview.description.i_o"></a></span><a class="link" href="chrono.html#chrono.overview.description.i_o">I/O</a> </h5> <p> - It provides I/O for <a class="link" href="chrono/reference.html#chrono.reference.cpp0x.duration_hpp.duration" title="Class Template duration<>"><code class="computeroutput"><span class="identifier">duration</span></code></a> and <a class="link" href="chrono/reference.html#chrono.reference.cpp0x.time_point_hpp.time_point" title="Class template time_point<>"><code class="computeroutput"><span class="identifier">time_point</span></code></a>. It builds on <code class="computeroutput"><span class="special"><</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">ratio</span><span class="special">/</span><span class="identifier">ratio_io</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">></span></code> + It provides I/O for <a class="link" href="chrono/reference.html#chrono.reference.cpp0x.duration_hpp.duration" title="Class Template duration<>"><code class="computeroutput"><span class="identifier">duration</span></code></a> and <a class="link" href="chrono/reference.html#chrono.reference.cpp0x.time_point_hpp.time_point" title="Class template time_point<>"><code class="computeroutput"><span class="identifier">time_point</span></code></a>. This I/O makes use of + these types much more convenient. In following the "you only pay for + what you use" philosophy, this extra functionality is located in a header + separate from <boost/chrono/chrono.hpp>, namely <boost/chrono/chrono_io.hpp>. + </p> +<p> + It builds on <code class="computeroutput"><span class="special"><</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">ratio</span><span class="special">/</span><span class="identifier">ratio_io</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">></span></code> to provide readable and flexible formatting and parsing for types in <code class="computeroutput"><span class="special"><</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">chrono</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">></span></code>. - The <a class="link" href="chrono/reference.html#chrono.reference.cpp0x.duration_hpp.duration" title="Class Template duration<>"><code class="computeroutput"><span class="identifier">duration</span></code></a> unit names can be customized - through a new facet: <a class="link" href="chrono/reference.html#chrono.reference.io.chrono_io_hpp.duration_punct" title="Template Class duration_punct<>"><code class="computeroutput"><span class="identifier">duration_punct</span></code></a>. + This textural representation uses <a href="http://en.wikipedia.org/wiki/SI_prefix#List_of_SI_prefixes" target="_top">SI + prefixes</a> whenever possible. This makes it easy for <code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">milliseconds</span></code> to be represented by the text + "milliseconds", or a hypothetical meter class to print out "millimeter". + The <a class="link" href="chrono/reference.html#chrono.reference.cpp0x.duration_hpp.duration" title="Class Template duration<>"><code class="computeroutput"><span class="identifier">duration</span></code></a> and the <a class="link" href="chrono/reference.html#chrono.reference.cpp0x.time_point_hpp.time_point" title="Class template time_point<>"><code class="computeroutput"><span class="identifier">time_point</span></code></a> i/o can be customized + through the new facets: <a class="link" href="chrono/reference.html#chrono.reference.io.duration_units_hpp.duration_units" title="Template Class duration_units"><code class="computeroutput"><span class="identifier">duration_units</span></code></a> and __time_point_units. + The user can specialize these facets so that the the chrono i/o could be + localizable. However Boost.Chrono doesn't provides a complete locale solution. + </p> +<p> + <code class="computeroutput"><span class="identifier">system_clock</span><span class="special">::</span><span class="identifier">time_point</span></code> I/O is proposed in terms of + UTC timepoints, strongly guided by ISO 9899:1999, Programming languages - + C, ISO 9945:2003, Information Technology - Portable Operating System Interface + (POSIX) and ISO 8601:2004, Data elements and interchange formats - Information + interchange - Representation of dates and times. </p> <h5> <a name="chrono.overview.description.h3"></a> - <span><a name="chrono.overview.description.rounding_utilities"></a></span><a class="link" href="chrono.html#chrono.overview.description.rounding_utilities">Rounding + <span class="phrase"><a name="chrono.overview.description.rounding_utilities"></a></span><a class="link" href="chrono.html#chrono.overview.description.rounding_utilities">Rounding utilities</a> </h5> <p> @@ -284,7 +302,7 @@ </p> <h5> <a name="chrono.overview.description.h4"></a> - <span><a name="chrono.overview.description.caveat_emptor"></a></span><a class="link" href="chrono.html#chrono.overview.description.caveat_emptor">Caveat + <span class="phrase"><a name="chrono.overview.description.caveat_emptor"></a></span><a class="link" href="chrono.html#chrono.overview.description.caveat_emptor">Caveat Emptor</a> </h5> <p> @@ -299,12 +317,12 @@ </div> </div> <table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr> -<td align="left"><p><small>Last revised: August 15, 2012 at 23:43:54 GMT</small></p></td> +<td align="left"><p><small>Last revised: October 30, 2014 at 10:18:25 GMT</small></p></td> <td align="right"><div class="copyright-footer"></div></td> </tr></table> <hr> <div class="spirit-nav"> -<a accesskey="p" href="array/ack.html"><img src="../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="libraries.html"><img src="../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="index.html"><img src="../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="chrono/users_guide.html"><img src="../../doc/src/images/next.png" alt="Next"></a> +<a accesskey="p" href="atomic/porting.html"><img src="../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="libraries.html"><img src="../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="index.html"><img src="../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="chrono/users_guide.html"><img src="../../doc/src/images/next.png" alt="Next"></a> </div> </body> </html> |