Menu
▾
▴
[Cpptool-cvs] rfta/deplib/boostcvs/libs/filesystem/doc convenience.htm,1.2,1.3 do-list.htm,1.3,1.4 exception.htm,1.3,1.4 index.htm,1.3,1.4
|
From: Baptiste L. <bl...@us...> - 2004-06-13 11:57:04
|
Update of /cvsroot/cpptool/rfta/deplib/boostcvs/libs/filesystem/doc In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv3989/libs/filesystem/doc Modified Files: convenience.htm do-list.htm exception.htm index.htm Log Message: * added boost 1.30.2 headers & sources Index: exception.htm =================================================================== RCS file: /cvsroot/cpptool/rfta/deplib/boostcvs/libs/filesystem/doc/exception.htm,v retrieving revision 1.3 retrieving revision 1.4 diff -C2 -d -r1.3 -r1.4 *** exception.htm 10 May 2003 15:17:32 -0000 1.3 --- exception.htm 13 Jun 2004 11:56:54 -0000 1.4 *************** *** 26,31 **** <p>The design evolved based on user requests to ease portability and ! internationalization. See the Boost <a href="../../../more/error_handling.html"> ! Error and Exception Handling</a> guidelines.</p> <h2><a name="Synopsis">Synopsis</a></h2> --- 26,30 ---- <p>The design evolved based on user requests to ease portability and ! internationalization.</p> <h2><a name="Synopsis">Synopsis</a></h2> *************** *** 55,59 **** }; ! class filesystem_error : public std::exception { public: --- 54,58 ---- }; ! class filesystem_error : public std::runtime_error { public: *************** *** 74,79 **** ~filesystem_error() throw(); - virtual const char * what() const throw(); - <i>sys_err</i> <a href="#native_error">native_error</a>() const; error_code <a href="#error">error</a>() const; --- 73,76 ---- *************** *** 118,129 **** <p><b>Effects:</b> Constructs a <i>filesystem_error</i> object.</p> </blockquote> - <h3><a name="what">what</a></h3> - <blockquote> - <p><code>virtual const char * what() const throw();</code></p> - <p><b>Returns:</b> A string identifying the error, including who(), path1(), - path2(), and related messages. If an error occurs in the preparation of the - string, particularly in low-memory situations, an implementation is permitted to - return a simpler static string.</p> - </blockquote> <h3><a name="native_error">native_error</a></h3> <blockquote> --- 115,118 ---- *************** *** 145,151 **** <pre>const std::string & who() const;</pre> ! <p><b>Returns:</b> The <code>who</code> argument to the constructor. An ! implementation is permitted to return an empty string if an exception, for ! example, std::bad_alloc, occurs during processing.</p> </blockquote> --- 134,138 ---- <pre>const std::string & who() const;</pre> ! <p><b>Returns:</b> The <code>who</code> argument to the constructor.</p> </blockquote> *************** *** 155,161 **** <p><b>Returns:</b> The <code>path1</code> argument to the constructor, if any, ! otherwise <code>path()</code>. An implementation is permitted to return an empty ! path if an exception, for example, std::bad_alloc, occurs during ! processing.</p> </blockquote> --- 142,146 ---- <p><b>Returns:</b> The <code>path1</code> argument to the constructor, if any, ! otherwise <code>path()</code>.</p> </blockquote> *************** *** 165,171 **** <p><b>Returns:</b> The <code>path2</code> argument to the constructor, if any, ! otherwise <code>path()</code>. An implementation is permitted to return an empty ! path if an exception, for example, std::bad_alloc, occurs during ! processing.</p> </blockquote> --- 150,154 ---- <p><b>Returns:</b> The <code>path2</code> argument to the constructor, if any, ! otherwise <code>path()</code>.</p> </blockquote> *************** *** 177,181 **** <p>© Copyright Beman Dawes, 2002</p> <p>Revised ! <!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%d %B, %Y" startspan -->23 March, 2003<!--webbot bot="Timestamp" endspan i-checksum="28836" --></p> </body> --- 160,164 ---- <p>© Copyright Beman Dawes, 2002</p> <p>Revised ! <!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%d %B, %Y" startspan -->02 January, 2003<!--webbot bot="Timestamp" endspan i-checksum="38568" --></p> </body> Index: do-list.htm =================================================================== RCS file: /cvsroot/cpptool/rfta/deplib/boostcvs/libs/filesystem/doc/do-list.htm,v retrieving revision 1.3 retrieving revision 1.4 diff -C2 -d -r1.3 -r1.4 *** do-list.htm 10 May 2003 15:17:32 -0000 1.3 --- do-list.htm 13 Jun 2004 11:56:54 -0000 1.4 *************** *** 10,13 **** --- 10,18 ---- and complete(). Also, path_test cases at line 410 need review, correction.<br> </li> + <li>Replace filesystem_error impl with shared_ptr. (Dave Abrahams).<br> + </li> + <li>Consider changing who() + interface (and ctors to const char *).<br> + </li> <li>Add a path::swap member function guaranteed not to throw. (Geurt Vos).<br> </li> *************** *** 39,41 **** <p>© Copyright Beman Dawes, 2002</p> <p>Revised ! <!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%d %B, %Y" startspan -->23 March, 2003<!--webbot bot="Timestamp" endspan i-checksum="28836" --></p> \ No newline at end of file --- 44,46 ---- <p>© Copyright Beman Dawes, 2002</p> <p>Revised ! <!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%d %B, %Y" startspan -->17 March, 2003<!--webbot bot="Timestamp" endspan i-checksum="28843" --></p> \ No newline at end of file Index: index.htm =================================================================== RCS file: /cvsroot/cpptool/rfta/deplib/boostcvs/libs/filesystem/doc/index.htm,v retrieving revision 1.3 retrieving revision 1.4 diff -C2 -d -r1.3 -r1.4 *** index.htm 10 May 2003 15:17:32 -0000 1.3 --- index.htm 13 Jun 2004 11:56:54 -0000 1.4 *************** *** 428,437 **** <p>A lengthy discussion on the C++ committee's library reflector illuminated the "illusion ! of portability" problem, particularly in postings by PJ Plauger and Pete Becker.</p> <hr> <p>© Copyright Beman Dawes, 2002</p> <p>Revised ! <!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%d %B, %Y" startspan -->08 April, 2003<!--webbot bot="Timestamp" endspan i-checksum="29884" --></p> </body> --- 428,437 ---- <p>A lengthy discussion on the C++ committee's library reflector illuminated the "illusion ! of portability" problem, particularly in postings by JP Plauger and Pete Becker.</p> <hr> <p>© Copyright Beman Dawes, 2002</p> <p>Revised ! <!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%d %B, %Y" startspan -->16 March, 2003<!--webbot bot="Timestamp" endspan i-checksum="28841" --></p> </body> Index: convenience.htm =================================================================== RCS file: /cvsroot/cpptool/rfta/deplib/boostcvs/libs/filesystem/doc/convenience.htm,v retrieving revision 1.2 retrieving revision 1.3 diff -C2 -d -r1.2 -r1.3 *** convenience.htm 10 May 2003 15:17:32 -0000 1.2 --- convenience.htm 13 Jun 2004 11:56:54 -0000 1.3 *************** *** 25,32 **** <dl class="index"> <dt><a href="#create_directories">create_directories</a> ! <dt><a href="#extension">extension</a> ! <dt><a href="#basename">basename</a> ! <dt><a href="#change_extension">change_extension</a> ! </dl> <h2 id="create_directoies">create_directories</h2> --- 25,29 ---- <dl class="index"> <dt><a href="#create_directories">create_directories</a> ! </ol> <h2 id="create_directoies">create_directories</h2> *************** *** 45,117 **** </blockquote> - <h2 id="extension">extension</h2> - - <blockquote> - - <p><code>std::string extension( const path & ph );</code></p> - - <p><b>Returns:</b> if <code>ph.leaf()</code> contains a dot ('.'), - returns the substring of <code>ph.leaf()</code> starting from the last dot and - ending at the string's end. Otherwise, returns empty string. - <p><b>Rationale:</b> <ul> - <li>The dot is included in the return value so that it's - possible to tell if extension is empty or absent. - <li>It was noted that this defintion of extension is probably not sufficient - when using <a href="http://tinyurl.com/9tih">Alternate Data Streams</a> — - a filesystem feature specific to NTFS. However, semantic in this case was not - clear, and the current one is quite usefull still. - </ul> - <p><b>Acknowlegements:</b> Carl Daniel and Pavel Vozenilek noticed and - discussed the ADS issue. - - <p>Contributed by Vladimir Prus.</p> - - </blockquote> - - <h2 id="basename">basename</h2> - - <blockquote> - - <p><code>std::string basename( const path & ph );</code></p> - - <p><b>Returns:</b> if <code>ph.leaf()</code> contains a dot ('.'), - returns the substring of <code>ph.leaf()</code> starting from beginning and - ending at the last dot (the dot is not included). Otherwise, returns - <code>ph.leaf()</code> - - </p> - - <p>Contributed by Vladimir Prus.</p> - - </blockquote> - - <h2 id="change_extension">change_extension</h2> - - <blockquote> - - <p><code>path basename( const path & ph, const std::string & new_extension );</code></p> - - <p><b>Postcondition:</b> <code>basename(return_value) == basename(ph) - && extension(return_value) == new_extension</code> - <p><b>Note:</b> It follows from the semantic of <code>extension</code> that - <code>new_extension</code> should include dot to achieve reasonable results. - </p> - <p><b>Rationale:</b> Previously, this functions had - <code>!ph.leaf().empty()</code> as precondition. It's not clear if it was - right or wrong. Changing extension of an empty path looks pointless. On the - other hand, the value of precondition was questionable: one would better place such - checks at the points where paths are entered by the user. Current decision - is to drop the precondition.</p> - - <p>Contributed by Vladimir Prus.</p> - - </blockquote> - - - <hr> ! <p>© Copyright Vladimir Prus, 2003</p> <p>Revised ! <!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%d %B, %Y" startspan -->5 May, 2003<!--webbot bot="Timestamp" endspan i-checksum="38510" --></p> <p> </p> --- 42,49 ---- </blockquote> <hr> ! <p>© Copyright Beman Dawes, 2002</p> <p>Revised ! <!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%d %B, %Y" startspan -->23 December, 2002<!--webbot bot="Timestamp" endspan i-checksum="38510" --></p> <p> </p> |
