Merge branch 'develop'

This commit is contained in:
Glen Fernandes
2019-12-14 10:20:24 -05:00
19 changed files with 1114 additions and 1005 deletions

56
.appveyor.yml Normal file
View File

@ -0,0 +1,56 @@
# Copyright 2019 Glen Fernandes
# Distributed under the Boost Software License, Version 1.0.
version: 1.0.{build}-{branch}
shallow_clone: true
branches:
only:
- master
- develop
environment:
matrix:
- APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2015
TOOLSET: msvc-9.0
- APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2015
TOOLSET: msvc-10.0
- APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2015
TOOLSET: msvc-11.0
- APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2015
TOOLSET: msvc-12.0
ADDRMD: 32,64
- APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2015
TOOLSET: msvc-14.0
ADDRMD: 32,64
- APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2017
TOOLSET: msvc-14.1
ADDRMD: 32,64
CXXSTD: 14,17
- APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2017
TOOLSET: clang-win
ADDRMD: 32,64
CXXSTD: 14,17
install:
- set BOOST_BRANCH=develop
- if "%APPVEYOR_REPO_BRANCH%" == "master" set BOOST_BRANCH=master
- cd ..
- git clone -b %BOOST_BRANCH% https://github.com/boostorg/boost.git boost
- cd boost
- git submodule update --init tools/build
- git submodule update --init libs/config
- git submodule update --init tools/boostdep
- xcopy /s /e /q %APPVEYOR_BUILD_FOLDER% libs\io\
- python tools/boostdep/depinst/depinst.py io
- cmd /c bootstrap
- b2 headers
build: off
test_script:
- PATH=%ADDPATH%%PATH%
- if not "%CXXSTD%" == "" set CXXSTD=cxxstd=%CXXSTD%
- if not "%ADDRMD%" == "" set ADDRMD=address-model=%ADDRMD%
- b2 libs/io/test toolset=%TOOLSET% %CXXSTD% %ADDRMD%

View File

@ -1,39 +1,297 @@
# Copyright 2017 Edward Diener
# Copyright 2019 Glen Fernandes
# Distributed under the Boost Software License, Version 1.0.
# (See accompanying file LICENSE_1_0.txt or copy at http://boost.org/LICENSE_1_0.txt)
language: cpp
sudo: false
python: "2.7"
dist: trusty
os:
- linux
- osx
python: "2.7"
branches:
only:
- master
- develop
env:
matrix:
- BOGUS_JOB=true
matrix:
exclude:
- env: BOGUS_JOB=true
include:
- os: linux
compiler: g++
env: TOOLSET=gcc COMPILER=g++ CXXSTD=03,11
- os: linux
compiler: g++-4.4
env: TOOLSET=gcc COMPILER=g++-4.4 CXXSTD=98,0x
addons:
apt:
packages:
- g++-4.4
sources:
- ubuntu-toolchain-r-test
- os: linux
compiler: g++-4.6
env: TOOLSET=gcc COMPILER=g++-4.6 CXXSTD=03,0x
addons:
apt:
packages:
- g++-4.6
sources:
- ubuntu-toolchain-r-test
- os: linux
compiler: g++-4.7
env: TOOLSET=gcc COMPILER=g++-4.7 CXXSTD=03,11
addons:
apt:
packages:
- g++-4.7
sources:
- ubuntu-toolchain-r-test
- os: linux
compiler: g++-4.8
env: TOOLSET=gcc COMPILER=g++-4.8 CXXSTD=03,11
addons:
apt:
packages:
- g++-4.8
sources:
- ubuntu-toolchain-r-test
- os: linux
compiler: g++-4.9
env: TOOLSET=gcc COMPILER=g++-4.9 CXXSTD=03,11
addons:
apt:
packages:
- g++-4.9
sources:
- ubuntu-toolchain-r-test
- os: linux
compiler: g++-5
env: TOOLSET=gcc COMPILER=g++-5 CXXSTD=03,11,14,1z
addons:
apt:
packages:
- g++-5
sources:
- ubuntu-toolchain-r-test
- os: linux
compiler: g++-6
env: TOOLSET=gcc COMPILER=g++-6 CXXSTD=03,11,14,1z
addons:
apt:
packages:
- g++-6
sources:
- ubuntu-toolchain-r-test
- os: linux
compiler: g++-7
env: TOOLSET=gcc COMPILER=g++-7 CXXSTD=03,11,14,17
addons:
apt:
packages:
- g++-7
sources:
- ubuntu-toolchain-r-test
- os: linux
compiler: g++-8
env: TOOLSET=gcc COMPILER=g++-8 CXXSTD=03,11,14,17,2a
addons:
apt:
packages:
- g++-8
sources:
- ubuntu-toolchain-r-test
- os: linux
compiler: g++-9
env: TOOLSET=gcc COMPILER=g++-9 CXXSTD=03,11,14,17,2a
addons:
apt:
packages:
- g++-9
sources:
- ubuntu-toolchain-r-test
- os: linux
compiler: clang++
env: TOOLSET=clang COMPILER=clang++ CXXSTD=03,11
- os: linux
compiler: /usr/bin/clang++
env: TOOLSET=clang COMPILER=/usr/bin/clang++ CXXSTD=03,11
addons:
apt:
packages:
- clang-3.3
- os: linux
compiler: /usr/bin/clang++
env: TOOLSET=clang COMPILER=/usr/bin/clang++ CXXSTD=03,11
addons:
apt:
packages:
- clang-3.4
- os: linux
compiler: clang++-3.5
env: TOOLSET=clang COMPILER=clang++-3.5 CXXSTD=03,11,14,1z
addons:
apt:
packages:
- clang-3.5
- libstdc++-4.9-dev
sources:
- ubuntu-toolchain-r-test
- llvm-toolchain-precise-3.5
- os: linux
compiler: clang++-3.6
env: TOOLSET=clang COMPILER=clang++-3.6 CXXSTD=03,11,14,1z
addons:
apt:
packages:
- clang-3.6
sources:
- ubuntu-toolchain-r-test
- llvm-toolchain-precise-3.6
- os: linux
compiler: clang++-3.7
env: TOOLSET=clang COMPILER=clang++-3.7 CXXSTD=03,11,14,1z
addons:
apt:
packages:
- clang-3.7
sources:
- ubuntu-toolchain-r-test
- llvm-toolchain-precise-3.7
- os: linux
compiler: clang++-3.8
env: TOOLSET=clang COMPILER=clang++-3.8 CXXSTD=03,11,14,1z
addons:
apt:
packages:
- clang-3.8
- libstdc++-4.9-dev
sources:
- ubuntu-toolchain-r-test
- llvm-toolchain-precise-3.8
- os: linux
compiler: clang++-3.9
env: TOOLSET=clang COMPILER=clang++-3.9 CXXSTD=03,11,14,1z
addons:
apt:
packages:
- clang-3.9
- libstdc++-4.9-dev
sources:
- ubuntu-toolchain-r-test
- llvm-toolchain-precise-3.9
- os: linux
compiler: clang++-4.0
env: TOOLSET=clang COMPILER=clang++-4.0 CXXSTD=03,11,14,1z
addons:
apt:
packages:
- clang-4.0
sources:
- ubuntu-toolchain-r-test
- llvm-toolchain-trusty-4.0
- os: linux
compiler: clang++-5.0
env: TOOLSET=clang COMPILER=clang++-5.0 CXXSTD=03,11,14,1z
addons:
apt:
packages:
- clang-5.0
sources:
- ubuntu-toolchain-r-test
- llvm-toolchain-trusty-5.0
- os: linux
compiler: clang++-6.0
env: TOOLSET=clang COMPILER=clang++-6.0 CXXSTD=03,11,14,17,2a
addons:
apt:
packages:
- clang-6.0
sources:
- ubuntu-toolchain-r-test
- llvm-toolchain-trusty-6.0
- os: linux
compiler: clang++-7
env: TOOLSET=clang COMPILER=clang++-7 CXXSTD=03,11,14,17,2a
addons:
apt:
packages:
- clang-7
sources:
- ubuntu-toolchain-r-test
- llvm-toolchain-trusty-7
- os: linux
compiler: clang++-8
env: TOOLSET=clang COMPILER=clang++-8 CXXSTD=03,11,14,17,2a
addons:
apt:
packages:
- clang-8
sources:
- ubuntu-toolchain-r-test
- llvm-toolchain-trusty-8
- os: linux
compiler: clang++-libc++
env: TOOLSET=clang COMPILER=clang++-libc++ CXXSTD=03,11,14,1z
addons:
apt:
packages:
- libc++-dev
- os: osx
compiler: clang++
env: TOOLSET=clang COMPILER=clang++ CXXSTD=03,11,14,1z
install:
- BOOST_BRANCH=develop && [ "$TRAVIS_BRANCH" == "master" ] && BOOST_BRANCH=master || true
- cd ..
- git clone -b $TRAVIS_BRANCH --depth 1 https://github.com/boostorg/boost.git boost-root
- cd boost-root
- git clone -b $BOOST_BRANCH https://github.com/boostorg/boost.git boost
- cd boost
- git submodule update --init tools/build
- git submodule update --init libs/config
- git submodule update --init tools/boostdep
- mkdir -p libs/io
- cp -r $TRAVIS_BUILD_DIR/* libs/io
- python tools/boostdep/depinst/depinst.py io
- ./bootstrap.sh
- ./b2 headers
script:
- TOOLSET=gcc,clang
- if [ $TRAVIS_OS_NAME == osx ]; then TOOLSET=clang; fi
- ./b2 --verbose-test libs/config/test//config_info toolset=$TOOLSET || true
- ./b2 libs/io/test toolset=$TOOLSET
- |-
echo "using $TOOLSET : : $COMPILER ;" > ~/user-config.jam
- ./b2 libs/io/test toolset=$TOOLSET cxxstd=$CXXSTD
notifications:
email:

16
CMakeLists.txt Normal file
View File

@ -0,0 +1,16 @@
# Copyright 2018 Mike Dev
# Distributed under the Boost Software License, Version 1.0.
# See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt
cmake_minimum_required( VERSION 3.5 )
project( BoostIO LANGUAGES CXX )
add_library( boost_io INTERFACE )
add_library( Boost::io ALIAS boost_io )
target_include_directories( boost_io INTERFACE include )
target_link_libraries( boost_io
INTERFACE
Boost::config
)

View File

@ -1,36 +0,0 @@
# Copyright 2017 Edward Diener
# Distributed under the Boost Software License, Version 1.0.
# (See accompanying file LICENSE_1_0.txt or copy at http://boost.org/LICENSE_1_0.txt)
version: 1.0.{build}-{branch}
shallow_clone: true
branches:
only:
- master
- develop
environment:
matrix:
- APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2015
TOOLSET: msvc-9.0,msvc-10.0,msvc-11.0,msvc-12.0,msvc-14.0
- APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2017
TOOLSET: msvc-14.1
install:
- cd ..
- git clone -b %APPVEYOR_REPO_BRANCH% https://github.com/boostorg/boost.git boost-root
- cd boost-root
- git submodule update --init tools/build
- git submodule update --init libs/config
- git submodule update --init tools/boostdep
- xcopy /s /e /q %APPVEYOR_BUILD_FOLDER% libs\io
- python tools/boostdep/depinst/depinst.py io
- bootstrap
- b2 headers
build: off
test_script:
- b2 libs/io/test toolset=%TOOLSET%

23
doc/Jamfile Normal file
View File

@ -0,0 +1,23 @@
# Copyright 2019 Glen Joseph Fernandes
# (glenjofe@gmail.com)
#
# Distributed under the Boost Software License, Version 1.0.
# (http://www.boost.org/LICENSE_1_0.txt)
import asciidoctor ;
html io.html : io.adoc ;
install html_ : io.html : <location>html ;
pdf io.pdf : io.adoc ;
explicit io.pdf ;
install pdf_ : io.pdf : <location>pdf ;
explicit pdf_ ;
alias boostdoc ;
explicit boostdoc ;
alias boostrelease : html_ ;
explicit boostrelease ;

View File

@ -1,67 +0,0 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
<html>
<head>
<title>Boost I/O Library</title>
</head>
<body bgcolor="white" text="black">
<table border="1" bgcolor="teal" cellpadding="2">
<tr>
<td bgcolor="white"><img src="../../../boost.png"
alt="boost.png (6897 bytes)" width="277"
height="86"></td>
<td><a href="../../../index.htm"><font face="Arial"
color="white"><big>Home</big></font></a></td>
<td><a href="../../libraries.htm"><font face="Arial"
color="white"><big>Libraries</big></font></a></td>
<td><a href="http://www.boost.org/people/people.htm"><font face="Arial"
color="white"><big>People</big></font></a></td>
<td><a href="http://www.boost.org/more/faq.htm"><font face="Arial"
color="white"><big>FAQ</big></font></a></td>
<td><a href="../../../more/index.htm"><font face="Arial"
color="white"><big>More</big></font></a></td>
</tr>
</table>
<h1>Boost Input/Output Library</h1>
<table border="1" cellpadding="5" align="center">
<tr>
<th>Header / Docs</th>
<th>Contents</th>
</tr>
<tr>
<td align="center">
<code><a href="../../../boost/io_fwd.hpp">&lt;boost/io_fwd.hpp&gt;</a></code>
</td>
<td valign="top">
Forward declaration header.
</td>
</tr>
<tr>
<td align="center">
<code><a href="../../../boost/io/ios_state.hpp">&lt;boost/io/ios_state.hpp&gt;</a></code><br>
<br><a href="ios_state.html">documentation</a>
</td>
<td valign="top">
State-saving classes for various IOStream attributes.
</td>
</tr>
</table>
<h2>Rationale</h2>
<p>The I/O sub-library of Boost helps segregate the large number of
Boost headers. This sub-library should contain various items to use
with/for the standard I/O library.</p>
<hr>
<p>Revised: 26 Feb 2002</p>
<p>Copyright 2002 Daryle Walker. Use, modification, and distribution are
subject to the Boost Software License, Version 1.0. (See accompanying file <a
href="../../../LICENSE_1_0.txt">LICENSE_1_0.txt</a> or a copy at &lt;<a
href="http://www.boost.org/LICENSE_1_0.txt">http://www.boost.org/LICENSE_1_0.txt</a>&gt;.)</p>
</body>
</html>

32
doc/io.adoc Normal file
View File

@ -0,0 +1,32 @@
////
Copyright 2019 Glen Joseph Fernandes
(glenjofe@gmail.com)
Distributed under the Boost Software License, Version 1.0.
(http://www.boost.org/LICENSE_1_0.txt)
////
# Boost.IO
Daryle Walker, Beman Dawes
:idprefix:
:source-language: cpp
:toc: left
The I/O sub-library of Boost helps segregate the large number of Boost headers.
This sub-library should contain various items to use with/for the standard I/O
library.
:leveloffset: +1
include::ios_state.adoc[]
:leveloffset: -1
## Copyright and License
* Copyright 2002 Daryle Walker
* Copyright 2002, 2006, 2007, 2009, 2010 Beman Dawes
* Copyright 2019 Glen Joseph Fernandes
Distributed under the
http://www.boost.org/LICENSE_1_0.txt[Boost Software License, Version 1.0].

316
doc/ios_state.adoc Normal file
View File

@ -0,0 +1,316 @@
////
Copyright 2019 Glen Joseph Fernandes
(glenjofe@gmail.com)
Distributed under the Boost Software License, Version 1.0.
(http://www.boost.org/LICENSE_1_0.txt)
////
# ios_state, <boost/io/ios_state.hpp>
:toc:
:toc-title:
:idprefix:
## Description
The header `<boost/io/ios_state.hpp>` covers saving the stream state of objects
in the {cpp} IOStreams system.
## Rationale
Sometimes a certain value has to change only for a limited scope. Saver classes
save a copy of the current state of some object (or an aspect of an object),
and reset the object's state at destruction time, undoing any change the object
may have gone through.
The saver class strategy is helpful when using I/O stream objects. Manipulator
objects can change some aspect of a stream during input or output. The state
changed by the manipulator usually sticks to its new value after the I/O
transaction. This can be a problem if manipulators are used in a function that
is not supposed to externally change a stream's state.
```
#include <ostream>
#include <ios>
void hex_my_byte(std::ostream& os, char byte)
{
os << std::hex << static_cast<unsigned>(byte);
}
```
The `os` stream will retain its new hexadecimal printing mode after the call to
`hex_my_byte`. The stream's printing mode can be saved and restored with manual
calls to the stream's state inspecting and mutating member functions. The
manual method becomes unwieldy if the main functionality is complex and/or
needs to be exception safe. A saver class can implement the better
"resource acquisition is initialization" strategy.
See the example below for better code, using saver classes.
## Header Synopsis
```
namespace boost {
namespace io {
class ios_flags_saver;
class ios_precision_saver;
class ios_width_saver;
class ios_base_all_saver;
template<class Ch, class Tr = std::char_traits<Ch> >
class basic_ios_iostate_saver;
template<class Ch, class Tr = std::char_traits<Ch> >
class basic_ios_exception_saver;
template<class Ch, class Tr = std::char_traits<Ch> >
class basic_ios_tie_saver;
template<class Ch, class Tr = std::char_traits<Ch> >
class basic_ios_rdbuf_saver;
template<class Ch, class Tr = std::char_traits<Ch> >
class basic_ios_fill_saver;
template<class Ch, class Tr = std::char_traits<Ch> >
class basic_ios_locale_saver;
template<class Ch, class Tr = std::char_traits<Ch> >
class basic_ios_all_saver;
typedef basic_ios_iostate_saver<char> ios_iostate_saver;
typedef basic_ios_iostate_saver<wchar_t> wios_iostate_saver;
typedef basic_ios_exception_saver<char> ios_exception_saver;
typedef basic_ios_exception_saver<wchar_t> wios_exception_saver;
typedef basic_ios_tie_saver<char> ios_tie_saver;
typedef basic_ios_tie_saver<wchar_t> wios_tie_saver;
typedef basic_ios_rdbuf_saver<char> ios_rdbuf_saver;
typedef basic_ios_rdbuf_saver<wchar_t> wios_rdbuf_saver;
typedef basic_ios_fill_saver<char> ios_fill_saver;
typedef basic_ios_fill_saver<wchar_t> wios_fill_saver;
typedef basic_ios_locale_saver<char> ios_locale_saver;
typedef basic_ios_locale_saver<wchar_t> wios_locale_saver;
typedef basic_ios_all_saver<char> ios_all_saver;
typedef basic_ios_all_saver<wchar_t> wios_all_saver;
class ios_iword_saver;
class ios_pword_saver;
class ios_all_word_saver;
} // io
} // boost
```
## Savers for Basic Standard Attributes
The basic saver classes have this format:
[subs=+quotes]
```
class saver_class {
typedef std::ios_base state_type;
typedef `implementation_defined` aspect_type;
explicit saver_class(state_type& s);
saver_class(state_type& s, const aspect_type& new_value);
~saver_class();
void restore();
};
```
The `state_type` is the IOStreams base class `std::ios_base`. The user would
usually place an actual input, output, or combined stream object for the
state-type parameter, and not a base class object. The first constructor takes
a stream object and saves a reference to the stream and the current value of a
particular stream attribute. The second constructor works like the first, and
uses its second argument to change the stream's attribute to the new
`aspect_type` value given. The destructor restores the stream's attribute to
the saved value. The restoration can be activated early (and often) with the
`restore` member function.
.Basic IOStreams State Saver Classes
[%header,cols=5*]
|===
|Class |Saved Attribute |Attribute Type |Reading Method |Writing Method
|`ios_flags_saver`
|Format control flags
|`std::ios_base::fmtflags`
|`flags`
|`flags`
|`ios_precision_saver`
|Number of digits to print after decimal point
|`std::streamsize`
|`precision`
|`precision`
|`ios_width_saver`
|Minimum field width for printing objects
|`std::streamsize`
|`width`
|`width`
|===
## Savers for Advanced Standard Attributes
The saver class templates have this format:
[subs=+quotes]
```
template<class Ch, class Tr>
class saver_class {
typedef std::basic_ios<Ch, Tr> state_type;
typedef `implementation-defined` aspect_type;
explicit saver_class(state_type& s);
saver_class(state_type& s, const aspect_type& new_value);
~saver_class();
void restore();
};
```
The `state_type` is a version of the IOStreams base class template
`std::basic_ios<Ch, Tr>`, where `Ch` is a character type and `Tr` is a
character traits class. The user would usually place an actual input,
output, or combined stream object for the state-type parameter, and not a base
class object. The first constructor takes a stream object and saves a reference
to the stream and the current value of a particular stream attribute. The
second constructor works like the first, and uses its second argument to change
the stream's attribute to the new `aspect_type` value given. The destructor
restores the stream's attribute to the saved value. The restoration can be
activated early (and often) with the `restore` member function.
.Advanced IOStreams State Saver Class Templates
[%header,cols=5*]
|===
|Class |Saved Attribute |Attribute Type |Reading Method |Writing Method
|`basic_ios_iostate_saver<Ch, Tr>`
|Failure state of the stream [1], [2]
|`std::ios_base::iostate`
|`rdstate`
|`clear`
|`basic_ios_exception_saver<Ch, Tr>`
|Which failure states trigger an exception [1]
|`std::ios_base::iostate`
|`exceptions`
|`exceptions`
|`basic_ios_tie_saver<Ch, Tr>`
|Output stream synchronized with the stream
|`std::basic_ostream<Ch, Tr>*`
|`tie`
|`tie`
|`basic_ios_rdbuf_saver<Ch, Tr>`
|Stream buffer associated with the stream [2]
|`std::basic_streambuf<Ch, Tr>*`
|`rdbuf`
|`rdbuf`
|`basic_ios_fill_saver<Ch, Tr>`
|Character used to pad oversized field widths
|`Ch`
|`fill`
|`fill`
|`basic_ios_locale_saver<Ch, Tr>`
|Locale information associated with the stream [3]
|`std::locale`
|`getloc` (from `std::ios_base`)
|`imbue` (from `std::basic_ios<Ch, Tr>`)
|===
### Notes
1. When the failure state flags and/or the failure state exception watching
flags are changed, an exception is thrown if a match occurs among the two sets
of flags. This could mean that the constructor or destructor of these class
templates may throw.
2. When the associated stream buffer is changed, the stream's failure state set
is reset to "good" if the given stream buffer's address is non-NULL, but the
"bad" failure state is set if that address is NULL. This means that a saved
failure state of "good" may be restored as "bad" if the stream is stripped of
an associated stream buffer. Worse, given a NULL stream buffer address, an
exception is thrown if the "bad" failure state is being watched. This could
mean that the constructor or destructor of these class templates may throw.
3. The saver for the locale uses the `std::basic_ios<Ch, Tr>` class to extract
their information, although it could have used the functionality in
`std::ios_base`. The problem is that the versions of the needed member
functions in `ios_base` are not polymorphically related to the ones in
`basic_ios`. The stream classes that will be used with the saver classes should
use the versions of the member functions closest to them by inheritance, which
means the ones in `basic_ios`.
## Savers for User-Defined Attributes
There are three class (templates) for combined attribute savers. The
`ios_base_all_saver` saver class combines the functionality of all the basic
attribute saver classes. It has a constructor that takes the stream to have its
state preserved. The `basic_ios_all_saver` combines the functionality of all
the advanced attribute saver class templates and the combined basic attribute
saver class. It has a constructor that takes the stream to have its state
preserved. The `ios_all_word_saver` saver class combines the saver classes that
preserve user-defined formatting information. Its constructor takes the stream
to have its attributes saved and the index of the user-defined attributes. The
destructor for each class restores the saved state. Restoration can be
activated early (and often) for a class with the restore member function.
## Example
The code used in the rationale can be improved at two places. The printing
function could use a saver around the code that changes the formatting state.
Or the calling function can surround the call with a saver. Or both can be
done, especially if the user does not know if the printing function uses a
state saver. If the user wants a series of changes back & forth, without
surrounding each change within a separate block, the restore member function
can be called between each trial.
```
#include <boost/io/ios_state.hpp>
#include <ios>
#include <iostream>
#include <ostream>
void new_hex_my_byte(std::ostream& os, char byte)
{
boost::io::ios_flags_saver ifs(os);
os << std::hex << static_cast<unsigned>(byte);
}
int main()
{
// ...
{
boost::io::ios_all_saver ias(std::cout);
new_hex_my_byte(std::cout, 'A');
}
// ...
{
boost::io::ios_all_saver ias(std::cerr);
new_hex_my_byte(std::cerr, 'b');
ias.restore();
new_hex_my_byte(std::cerr, 'C');
}
// ...
}
```
## Credits
### Daryle Walker
Started the library. Contributed the initial versions of the format flags,
precision, width, and user-defined format flags saver classes. Contributed the
initial versions of the success state, success state exception flags, output
stream tie, stream buffer, character fill, and locale saver class templates.
Contributed the combined attribute classes and class template. Contributed the
test file `ios_state_test.cpp`.
## History
### 28 Feb 2005
Daryle Walker added the restore member functions, based on suggestions by
Gennadiy Rozental and Rob Stewart.
### 13 Mar 2002
Daryle Walker implemented the initial version.

View File

@ -1,468 +0,0 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
<html>
<head>
<title>I/O Stream-State Saver Library</title>
</head>
<body text="black" bgcolor="white" link="blue" vlink="purple" alink="red">
<h1><img src="../../../boost.png" alt="boost.png (6897 bytes)"
align="middle" width="277" height="86">Header &lt;<cite><a
href="../../../boost/io/ios_state.hpp">boost/io/ios_state.hpp</a></cite>
&gt;</h1>
<p>The header <cite><a
href="../../../boost/io/ios_state.hpp">boost/io/ios_state.hpp</a></cite>
covers saving the stream state of objects in the C++ IOStreams
system.</p>
<h2><a name="contents">Contents</a></h2>
<ol>
<li><a href="#contents">Contents</a></li>
<li><a href="#rationale">Rationale</a></li>
<li><a href="#header">Header Synopsis</a></li>
<li><a href="#base_savers">Savers for Basic Standard Attributes</a></li>
<li><a href="#adv_savers">Savers for Advanced Standard Attributes</a></li>
<li><a href="#user_savers">Savers for User-Defined Attributes</a></li>
<li><a href="#combo_savers">Savers for Combined Attributes</a></li>
<li><a href="#example">Example</a></li>
<li><a href="#refer">References</a></li>
<li><a href="#credits">Credits</a>
<ul>
<li><a href="#contributors">Contributors</a></li>
<li><a href="#history">History</a></li>
</ul></li>
</ol>
<h2><a name="rationale">Rationale</a></h2>
<p>Sometimes a certain value has to change only for a limited scope.
Saver classes save a copy of the current state of some object (or an
aspect of an object), and reset the object's state at destruction time,
undoing any change the object may have gone through.</p>
<p>The saver class strategy is helpful when using I/O stream objects.
Manipulator objects can change some aspect of a stream during input or
output. The state changed by the manipulator usually sticks to its new
value after the I/O transaction. This can be a problem if manipulators
are used in a function that is not supposed to externally change a
stream's state.</p>
<blockquote><pre>#include &lt;ostream&gt;
#include &lt;ios&gt;
void hex_my_byte( std::ostream &amp;os, char byte )
{
os &lt;&lt; std::hex &lt;&lt; static_cast&lt;unsigned&gt;(byte);
}
</pre></blockquote>
<p>The <var>os</var> stream will retain its new hexadecimal printing
mode after the call to <code>hex_my_byte</code>. The stream's printing
mode can be saved and restored with manual calls to the stream's state
inspecting and mutating member functions. The manual method becomes
unwieldy if the main functionality is complex and/or needs to be
exception safe. A saver class can implement the better &quot;resource
acquisition is initialization&quot; strategy.</p>
<p>See the <a href="#example">example</a> below for better code, using
saver classes.</p>
<h2><a name="header">Header Synopsis</a></h2>
<blockquote><pre>#include &lt;iosfwd&gt; <i>// for std::char_traits (declaration)</i>
namespace boost
{
namespace io
{
class ios_flags_saver;
class ios_precision_saver;
class ios_width_saver;
class ios_base_all_saver;
template &lt; typename Ch, class Tr = ::std::char_traits&lt;Ch&gt; &gt;
class basic_ios_iostate_saver;
template &lt; typename Ch, class Tr = ::std::char_traits&lt;Ch&gt; &gt;
class basic_ios_exception_saver;
template &lt; typename Ch, class Tr = ::std::char_traits&lt;Ch&gt; &gt;
class basic_ios_tie_saver;
template &lt; typename Ch, class Tr = ::std::char_traits&lt;Ch&gt; &gt;
class basic_ios_rdbuf_saver;
template &lt; typename Ch, class Tr = ::std::char_traits&lt;Ch&gt; &gt;
class basic_ios_fill_saver;
template &lt; typename Ch, class Tr = ::std::char_traits&lt;Ch&gt; &gt;
class basic_ios_locale_saver;
template &lt; typename Ch, class Tr = ::std::char_traits&lt;Ch&gt; &gt;
class basic_ios_all_saver;
typedef basic_ios_iostate_saver&lt;char&gt; ios_iostate_saver;
typedef basic_ios_iostate_saver&lt;wchar_t&gt; wios_iostate_saver;
typedef basic_ios_exception_saver&lt;char&gt; ios_exception_saver;
typedef basic_ios_exception_saver&lt;wchar_t&gt; wios_exception_saver;
typedef basic_ios_tie_saver&lt;char&gt; ios_tie_saver;
typedef basic_ios_tie_saver&lt;wchar_t&gt; wios_tie_saver;
typedef basic_ios_rdbuf_saver&lt;char&gt; ios_rdbuf_saver;
typedef basic_ios_rdbuf_saver&lt;wchar_t&gt; wios_rdbuf_saver;
typedef basic_ios_fill_saver&lt;char&gt; ios_fill_saver;
typedef basic_ios_fill_saver&lt;wchar_t&gt; wios_fill_saver;
typedef basic_ios_locale_saver&lt;char&gt; ios_locale_saver;
typedef basic_ios_locale_saver&lt;wchar_t&gt; wios_locale_saver;
typedef basic_ios_all_saver&lt;char&gt; ios_all_saver;
typedef basic_ios_all_saver&lt;wchar_t&gt; wios_all_saver;
class ios_iword_saver;
class ios_pword_saver;
class ios_all_word_saver;
}
}
</pre></blockquote>
<h2><a name="base_savers">Savers for Basic Standard Attributes</a></h2>
<p>The basic saver classes have this format:</p>
<blockquote><pre>class <var>saver_class</var>
{
typedef std::ios_base state_type;
typedef <i>implementation_defined</i> aspect_type;
explicit saver_class( state_type &amp;s );
saver_class( state_type &amp;s, <var>aspect_type</var> const &amp;new_value );
~saver_class();
void restore();
};
</pre></blockquote>
<p>The <var>state_type</var> is the IOStreams base class
<code>std::ios_base</code>. The user would usually place an actual
input, output, or combined stream object for the state-type parameter,
and not a base class object. The first constructor takes a stream
object and saves a reference to the stream and the current value of a
particular stream attribute. The second constructor works like the
first, and uses its second argument to change the stream's attribute to
the new <var>aspect_type</var> value given. The destructor restores the
stream's attribute to the saved value. The restoration can be activated
early (and often) with the <code>restore</code> member function.</p>
<table border="1" align="center">
<caption>Basic IOStreams State Saver Classes</caption>
<tr>
<th>Class</th>
<th>Saved Attribute</th>
<th>Attribute Type</th>
<th>Reading Method</th>
<th>Writing Method</th>
</tr>
<tr>
<td><code>boost::io::ios_flags_saver</code></td>
<td>Format control flags</td>
<td><code>std::ios_base::fmtflags</code></td>
<td><code>flags</code></td>
<td><code>flags</code></td>
</tr>
<tr>
<td><code>boost::io::ios_precision_saver</code></td>
<td>Number of digits to print after decimal point</td>
<td><code>std::streamsize</code></td>
<td><code>precision</code></td>
<td><code>precision</code></td>
</tr>
<tr>
<td><code>boost::io::ios_width_saver</code></td>
<td>Minimum field width for printing objects</td>
<td><code>std::streamsize</code></td>
<td><code>width</code></td>
<td><code>width</code></td>
</tr>
</table>
<h2><a name="adv_savers">Savers for Advanced Standard Attributes</a></h2>
<p>The saver class templates have this format:</p>
<blockquote><pre>template &lt; typename Ch, class Tr &gt;
class <var>saver_class</var>
{
typedef std::basic_ios&lt;Ch, Tr&gt; state_type;
typedef <i>implementation_defined</i> aspect_type;
explicit saver_class( state_type &amp;s );
saver_class( state_type &amp;s, <var>aspect_type</var> const &amp;new_value );
~saver_class();
void restore();
};
</pre></blockquote>
<p>The <var>state_type</var> is a version of the IOStreams base class
template <code>std::basic_ios&lt;Ch, Tr&gt;</code>, where
<code>Ch</code> is a character type and <code>Tr</code> is a character
traits class. The user would usually place an actual input, output, or
combined stream object for the state-type parameter, and not a base
class object. The first constructor takes a stream object and saves a
reference to the stream and the current value of a particular stream
attribute. The second constructor works like the first, and uses its
second argument to change the stream's attribute to the new
<var>aspect_type</var> value given. The destructor restores the stream's
attribute to the saved value. The restoration can be activated
early (and often) with the <code>restore</code> member function.</p>
<table border="1" align="center">
<caption>Advanced IOStreams State Saver Class Templates</caption>
<tr>
<th>Class Template</th>
<th>Saved Attribute</th>
<th>Attribute Type</th>
<th>Reading Method</th>
<th>Writing Method</th>
</tr>
<tr>
<td><code>boost::io::basic_ios_iostate_saver&lt;Ch, Tr&gt;</code></td>
<td>Failure state of the stream <a href="#Note1">[1]</a>, <a href="#Note2">[2]</a></td>
<td><code>std::ios_base::iostate</code></td>
<td><code>rdstate</code></td>
<td><code>clear</code></td>
</tr>
<tr>
<td><code>boost::io::basic_ios_exception_saver&lt;Ch, Tr&gt;</code></td>
<td>Which failure states trigger an exception <a href="#Note1">[1]</a></td>
<td><code>std::ios_base::iostate</code></td>
<td><code>exceptions</code></td>
<td><code>exceptions</code></td>
</tr>
<tr>
<td><code>boost::io::basic_ios_tie_saver&lt;Ch, Tr&gt;</code></td>
<td>Output stream synchronized with the stream</td>
<td><code>std::basic_ostream&lt;Ch, Tr&gt; *</code></td>
<td><code>tie</code></td>
<td><code>tie</code></td>
</tr>
<tr>
<td><code>boost::io::basic_ios_rdbuf_saver&lt;Ch, Tr&gt;</code></td>
<td>Stream buffer associated with the stream <a href="#Note2">[2]</a></td>
<td><code>std::basic_streambuf&lt;Ch, Tr&gt; *</code></td>
<td><code>rdbuf</code></td>
<td><code>rdbuf</code></td>
</tr>
<tr>
<td><code>boost::io::basic_ios_fill_saver&lt;Ch, Tr&gt;</code></td>
<td>Character used to pad oversized field widths</td>
<td><code>Ch</code></td>
<td><code>fill</code></td>
<td><code>fill</code></td>
</tr>
<tr>
<td><code>boost::io::basic_ios_locale_saver&lt;Ch, Tr&gt;</code></td>
<td>Locale information associated with the stream <a href="#Note3">[3]</a></td>
<td><code>std::locale</code></td>
<td><code>getloc</code> (from <code>std::ios_base</code>)</td>
<td><code>imbue</code> (from <code>std::basic_ios&lt;Ch, Tr&gt;</code>)</td>
</tr>
</table>
<h3>Notes</h3>
<ol>
<li>When the failure state flags and/or the failure state exception
watching flags are changed, an exception is thrown if a match
occurs among the two sets of flags. This could mean that
the <a name="Note1">constructor or destructor of these class
templates may throw</a>.</li>
<li>When the associated stream buffer is changed, the stream's
failure state set is reset to &quot;good&quot; if the given stream
buffer's address is non-NULL, but the &quot;bad&quot; failure
state is set if that address is NULL. This means that a saved
failure state of &quot;good&quot; may be restored as &quot;bad&quot;
if the stream is stripped of an associated stream buffer. Worse,
given a NULL stream buffer address, an exception is thrown if the
&quot;bad&quot; failure state is being watched. This could mean
that the <a name="Note2">constructor or destructor of these class
templates may throw</a>.</li>
<li>The <a name="Note3">saver for the locale uses the
<code>std::basic_ios&lt;Ch, Tr&gt;</code> class to extract their
information</a>, although it could have used the functionality
in <code>std::ios_base</code>. The problem is that the versions
of the needed member functions in <code>ios_base</code> are not
polymorphically related to the ones in <code>basic_ios</code>.
The stream classes that will be used with the saver classes
should use the versions of the member functions closest to them
by inheritance, which means the ones in
<code>basic_ios</code>.</li>
</ol>
<h2><a name="user_savers">Savers for User-Defined Attributes</a></h2>
<p>The saver classes for user-defined formatting information have this
format:</p>
<blockquote><pre>#include &lt;iosfwd&gt; <i>// for std::ios_base (declaration)</i>
class <var>saver_class</var>
{
typedef std::ios_base state_type;
typedef int index_type;
typedef <i>implementation_defined</i> aspect_type;
explicit saver_class( state_type &amp;s, index_type i );
saver_class( state_type &amp;s, index_type i, <var>aspect_type</var> const &amp;new_value );
~saver_class();
void restore();
};
</pre></blockquote>
<p>The index <var>i</var> differentiates between specific user-defined
formatting attributes. The index can only be determined at run-time
(most likely with the class-static <code>std::ios_base::xalloc</code>
member function).</p>
<p>The <var>state_type</var> is the base class of the IOStreams system,
<code>std::ios_base</code>. The user would usually place an actual
input, output, or combined stream object for the state-type parameter,
and not a base class object. The first constructor takes a stream
object and index and saves a reference to the stream and the current
value of a particular stream attribute. The second constructor works
like the first, and uses its third argument to change the stream's
attribute to the new <var>aspect_type</var> value given. The destructor
restores the stream's attribute to the saved value. The restoration can
be activated early (and often) with the <code>restore</code> member
function.</p>
<table border="1" align="center">
<caption>IOStream User-Defined State Saver Classes</caption>
<tr>
<th>Class</th>
<th>Saved Attribute</th>
<th>Attribute Type</th>
<th>Reference Method</th>
</tr>
<tr>
<td><code>boost::io::ios_iword_saver</code></td>
<td>Numeric user-defined format flag</td>
<td><code>long</code></td>
<td><code>iword</code></td>
</tr>
<tr>
<td><code>boost::io::ios_pword_saver</code></td>
<td>Pointer user-defined format flag</td>
<td><code>void *</code></td>
<td><code>pword</code></td>
</tr>
</table>
<h2><a name="combo_savers">Savers for Combined Attributes</a></h2>
<p>There are three class (templates) for combined attribute savers. The
<code>boost:io::ios_base_all_saver</code> saver class combines the
functionality of all the basic attribute saver classes. It has a
constructor that takes the stream to have its state preserved. The
<code>boost::io::basic_ios_all_saver</code> combines the functionality
of all the advanced attribute saver class templates and the combined
basic attribute saver class. It has a constructor that takes the stream
to have its state preserved. The
<code>boost::io::ios_all_word_saver</code> saver class combines the
saver classes that preserve user-defined formatting information. Its
constructor takes the stream to have its attributes saved and the index
of the user-defined attributes. The destructor for each class restores
the saved state. Restoration can be activated early (and often) for a
class with the <code>restore</code> member function.</p>
<h2><a name="example">Example</a></h2>
<p>The code used in the <a href="#rationale">rationale</a> can be
improved at two places. The printing function could use a saver around
the code that changes the formatting state. Or the calling function can
surround the call with a saver. Or both can be done, especially if the
user does not know if the printing function uses a state saver. If the
user wants a series of changes back &amp; forth, without surrounding each
change within a separate block, the <code>restore</code> member function
can be called between each trial.</p>
<blockquote><pre>#include &lt;boost/io/ios_state.hpp&gt;
#include &lt;ios&gt;
#include &lt;iostream&gt;
#include &lt;ostream&gt;
void new_hex_my_byte( std::ostream &amp;os, char byte )
{
boost::io::ios_flags_saver ifs( os );
os &lt;&lt; std::hex &lt;&lt; static_cast&lt;unsigned&gt;(byte);
}
int main()
{
using std::cout;
using std::cerr;
//...
{
boost::io::ios_all_saver ias( cout );
new_hex_my_byte( cout, 'A' );
}
//...
{
boost::io::ios_all_saver ias( cerr );
new_hex_my_byte( cerr, 'b' );
ias.restore();
new_hex_my_byte( cerr, 'C' );
}
//...
}
</pre></blockquote>
<h2><a name="refer">References</a></h2>
<ul>
<li>The I/O state saver library header itself: <cite><a
href="../../../boost/io/ios_state.hpp">boost/io/ios_state.hpp</a></cite></li>
<li>Some test/example code: <cite><a
href="../test/ios_state_test.cpp">ios_state_test.cpp</a></cite></li>
</ul>
<h2><a name="credits">Credits</a></h2>
<h3><a name="contributors">Contributors</a></h3>
<dl>
<dt><a href="http://www.boost.org/people/daryle_walker.html">Daryle Walker</a>
<dd>Started the library. Contributed the initial versions of the
format flags, precision, width, and user-defined format flags
saver classes. Contributed the initial versions of the success
state, success state exception flags, output stream tie, stream
buffer, character fill, and locale saver class templates.
Contributed the combined attribute classes and class template.
Contributed the test file <cite><a
href="../test/ios_state_test.cpp">ios_state_test.cpp</a></cite>.
</dl>
<h3><a name="history">History</a></h3>
<dl>
<dt>28 Feb 2005, Daryle Walker
<dd>Added the <code>restore</code> member functions, based on suggestions
by Gennadiy Rozental and Rob Stewart
<dt>13 Mar 2002, Daryle Walker
<dd>Initial version
</dl>
<hr>
<p>Revised: 28 February 2005</p>
<p>Copyright 2002, 2005 Daryle Walker. Use, modification, and distribution
are subject to the Boost Software License, Version 1.0. (See accompanying
file <a href="../../../LICENSE_1_0.txt">LICENSE_1_0.txt</a> or a copy at
&lt;<a href="http://www.boost.org/LICENSE_1_0.txt">http://www.boost.org/LICENSE_1_0.txt</a>&gt;.)</p>
</body>
</html>

139
doc/quoted.adoc Normal file
View File

@ -0,0 +1,139 @@
////
Copyright 2019 Glen Joseph Fernandes
(glenjofe@gmail.com)
Distributed under the Boost Software License, Version 1.0.
(http://www.boost.org/LICENSE_1_0.txt)
////
# quoted, <boost/io/quoted.hpp>
:toc:
:toc-title:
:idprefix:
## Introduction
C++ Standard library stream I/O for strings that contain embedded spaces can
produce unexpected results. For example,
```
std::stringstream ss;
std::string original = "fooled you";
std::string roundtrip;
ss << original;
ss >> roundtrip;
std::cout << original; // outputs: fooled you
std::cout << roundtrip; // outputs: fooled
assert(original == roundtrip); // assert will fire
```
The Boost quoted stream I/O manipulator places delimiters, defaulted to the
double-quote ("), around strings on output, and strips off the delimiters on
input. This ensures strings with embedded spaces round-trip as desired. For
example,
```
std::stringstream ss;
std::string original = "fooled you";
std::string roundtrip;
ss << quoted(original);
ss >> quoted(roundtrip);
std::cout << quoted(original); // outputs: "fooled you"
std::cout << roundtrip; // outputs: fooled you
assert(original == roundtrip); // assert will not fire
```
If the string contains the delimiter character, on output that character will
be preceded by an escape character, as will the escape character itself:
```
std::cout << quoted("'Jack & Jill'", '&', '\''); // outputs: '&'Jack && Jill&''
```
## Header synopsis
[subs=+quotes]
```
namespace boost {
namespace io {
template<class Char, class Traits, class Alloc>
`unspecified-type1`
quoted(const std::basic_string<Char, Traits, Alloc>& string,
Char escape='\\', Char delim='\"');
template<class Char>
`unspecified-type2`
quoted(const Char* string, Char escape='\\', Char delim='\"');
template<class Char, class Traits, class Alloc>
`unspecified-type3`
quoted(std::basic_string<Char, Traits, Alloc>& string,
Char escape='\\', Char delim='\"');
} // io
} // boost
```
*unspecified-type1*, *unspecified-type2*, and *unspecified-type3* are
implementation supplied types with implementation supplied `operator<<`:
[subs=+quotes]
```
template<class Char, class Traits>
std::basic_ostream<Char, Traits>&
operator<<(std::basic_ostream<Char, Traits>& os,
const `unspecified-typeN`& proxy);
```
Effects:: Inserts characters into `os`:
* `delim`
* Each character in `string`. If the character to be output is equal to
`escape` or `delim`, as determined by `operator==`, first output `escape`.
* `delim`
Remarks:: `string`, `escape`, and `delim` have the type and value of the
corresponding arguments of the call to the `quoted` function that constructed
`proxy`.
Returns:: `os`.
*unspecified-type3* is an implementation supplied type with an implementation
supplied `operator>>`:
[subs=+quotes]
```
template<class Char, class Traits>
std::basic_istream<Char, Traits>&
operator>>(std::basic_istream<Char, Traits>& is,
const `unspecified-type3`& proxy);
```
Effects:: Extracts characters from `os`:
* If the first character extracted is equal to `delim`, as determined by
`operator==`, then:
** Turn off the `skipws` flag.
** `string.clear()`
** Until an unescaped `delim` character is reached or `is.not_good()`, extract
characters from `os` and append them to string, except that if an escape is
reached, ignore it and append the next character to string.
** Discard the final `delim` character.
** Restore the `skipws` flag to its original value.
* Otherwise, `os >> string`.
Remarks:: `string`, `escape`, and `delim` have the type and value of the
corresponding arguments of the call to the `quoted` function that constructed
`proxy`.
Returns:: `is`.
## Acknowledgements
The `quoted()` stream manipulator emerged from discussions on the Boost
developers mailing list. Participants included Beman Dawes, Rob Stewart,
Alexander Lamaison, Eric Niebler, Vicente Botet, Andrey Semashev,
Phil Richards, and Rob Murray. Eric Niebler's suggestions provided the basis
for the name and form of the templates.

View File

@ -1,164 +0,0 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=iso-8859-1" />
<title>Boost &quot;quoted&quot; I/O manipulator</title>
<meta name="generator" content="Microsoft FrontPage 5.0" />
<link rel="stylesheet" type="text/css" href="../../../doc/src/minimal.css" />
</head>
<body>
<table border="0" cellpadding="5" cellspacing="0"
style="border-collapse: collapse">
<tbody>
<tr>
<td width="277"><a href="../../../index.htm"><img
src="../../../boost.png" alt="boost.png (6897 bytes)" align="middle"
width="300" height="86" border="0" /></a></td>
<td>
<h1 align="center">&quot;Quoted&quot;
I/O Manipulators<br>
for Strings</h1>
</td>
</tr>
</tbody>
</table>
<table border="1" cellpadding="5" cellspacing="1" style="border-collapse: collapse" bordercolor="#111111">
<tr>
<td>
<p align="center"><b>&quot;Quoted&quot;
I/O Manipulators
for Strings are not yet accepted into Boost as public components. Thus the
header file is currently located in &lt;boost/io/detail/quoted_manip.hpp&gt;</b></td>
</tr>
</table>
<h2>Introduction</h2>
<p>C++ Standard library stream I/O for strings that contain embedded spaces
can produce unexpected results. For example,</p>
<blockquote>
<pre>std::stringstream ss;
std::string original = &quot;fooled you&quot;;
std::string round_trip;
ss &lt;&lt; original;
ss &gt;&gt; round_trip;
std::cout &lt;&lt; original; // outputs: fooled you
std::cout &lt;&lt; round_trip; // outputs: fooled
assert(original == round_trip); // assert will fire</pre>
</blockquote>
<p>The Boost <code>quoted</code> stream I/O manipulator places delimiters, defaulted
to the double-quote (<code>&quot;</code>), around strings on output, and strips off
the delimiters on input. This ensures strings with embedded spaces round-trip as
desired. For example,</p>
<blockquote>
<pre>std::stringstream ss;
std::string original = &quot;fooled you&quot;;
std::string round_trip;
ss &lt;&lt; quoted(original);
ss &gt;&gt; quoted(round_trip);
std::cout &lt;&lt; quoted(original); // outputs: &quot;fooled you&quot;
std::cout &lt;&lt; round_trip; // outputs: fooled you
assert(original == round_trip); // assert will not fire</pre>
</blockquote>
<p>If the string contains the delimiter character, on output that character will
be preceded by an escape character, as will the escape character itself:</p>
<blockquote>
<pre>std::cout &lt;&lt; quoted(&quot;'Jack &amp; Jill'&quot;, '&amp;', '\''); // outputs: '&amp;'Jack &amp;&amp; Jill&amp;''</pre>
</blockquote>
<h2>Header <a href="../../../boost/io/detail/quoted_manip.hpp">&lt;boost/io/quoted_manip.hpp&gt;</a> synopsis</h2>
<pre>namespace boost
{
namespace io
{
// manipulator for const std::basic_string&amp;
template &lt;class Char, class Traits, class Alloc&gt;
<b><i>unspecified-type1</i></b> quoted(const std::basic_string&lt;Char, Traits, Alloc&gt;&amp; string,
Char escape='\\', Char delim='\&quot;');
// manipulator for const C-string*
template &lt;class Char&gt;
<b><i>unspecified-type2</i></b> quoted(const Char* string,
Char escape='\\', Char delim='\&quot;');
// manipulator for non-const std::basic_string&amp;
template &lt;class Char, class Traits, class Alloc&gt;
<b><i>unspecified-type3</i></b> quoted(std::basic_string&lt;Char, Traits, Alloc&gt;&amp; string,
Char escape='\\', Char delim='\&quot;');
}
}</pre>
<p><i><b><code>unspecified_type1</code></b></i>, <i><b><code>unspecified_type2</code></b></i>,
and <i><b><code>unspecified_type3</code></b></i> are implementation supplied
types with implementation supplied <code>operator&lt;&lt;</code>:</p>
<blockquote>
<pre>template &lt;class Char, class Traits&gt;
std::basic_ostream&lt;Char, Traits&gt;&amp;
operator&lt;&lt;(std::basic_ostream&lt;Char, Traits&gt;&amp; os, const <i><b><code>unspecified_typeN</code></b></i>&amp; proxy);</pre>
<p><i>Effects:</i> Inserts characters into <code>os</code>:</p>
<ul>
<li><code>delim</code>.</li>
<li>Each character in <code>string</code>. If the character to be output is
equal to <code>escape</code> or <code>delim</code>, as determined by <code>
operator==</code>, first output <code>escape</code>. </li>
<li><code>delim</code>.</li>
</ul>
<p><i>Remarks:</i> <code>string</code>, <code>escape</code>, and <code>delim</code>
have the type and value of the corresponding arguments of the call to the <code>
quoted</code> function that constructed <code>proxy</code>.</p>
<p><i>Returns:</i> <code>os</code>. </p>
</blockquote>
<p><i><b><code>unspecified_type3</code></b></i> is an implementation supplied
type with an implementation supplied <code>operator&gt;&gt;</code>:</p>
<blockquote>
<pre>template &lt;class Char, class Traits&gt;
std::basic_istream&lt;Char, Traits&gt;&amp;
operator&gt;&gt;(std::basic_istream&lt;Char, Traits&gt;&amp; is, const <i><b><code>unspecified_type3</code></b></i>&amp; proxy);</pre>
<p><i>Effects:</i> Extracts characters from <code>os</code>:</p>
<ul>
<li>If the first character extracted is equal to delim, as determined by
<code>operator==</code>, then:<ul>
<li>Turn off the <code>skipws</code> flag.</li>
<li><code>string.clear()</code></li>
<li>Until an unescaped <code>delim</code> character is reached or <code>
is.not_good()</code>, extract
characters from <code>os</code> and append them to <code>string</code>,
except that if an <code>escape</code> is reached, ignore it and append the
next character to <code>string</code>.</li>
<li>Discard the final <code>delim</code> character.</li>
<li>Restore the <code>skipws</code> flag to its original value.</li>
</ul>
</li>
<li>Otherwise, <code>os &gt;&gt; string</code>.</li>
</ul>
<p><i>Remarks:</i> <code>string</code>, <code>escape</code>, and <code>delim</code>
have the type and value of the corresponding arguments of the call to the <code>
quoted</code> function that constructed <code>proxy</code>.</p>
<p><i>Returns:</i> <code>is</code>. </p>
</blockquote>
<h2>Acknowledgements</h2>
<p>The <code>quoted()</code> stream manipulator emerged from discussions on the
Boost developers mailing list. Participants included Beman Dawes, Rob Stewart,
Alexander Lamaison, Eric Niebler, Vicente Botet, Andrey Semashev, Phil Richards,
and Rob Murray. Eric Niebler's suggestions provided the basis for the name and
form of the templates. </p>
<hr>
<p><EFBFBD> Copyright Beman Dawes, 2002, 2006, 2007, 2009, 2010</p>
<p>Distributed under the Boost Software License, Version 1.0. See
<a href="http://www.boost.org/LICENSE_1_0.txt">www.boost.org/LICENSE_1_0.txt</a></p>
<p>Revised
<!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%d %B %Y" startspan -->08 March 2013<!--webbot bot="Timestamp" endspan i-checksum="27284" --></p>
</body>
</html>

View File

@ -1,14 +1,17 @@
<!DOCTYPE html>
<!--
Copyright Beman Dawes, 2001
Distributed under the Boost Software License, Version 1.0.
(http://www.boost.org/LICENSE_1_0.txt)
-->
<html>
<head>
<meta http-equiv="refresh" content="0; URL=doc/index.html">
<meta charset="utf-8">
<meta http-equiv="refresh" content="0; url=doc/html/io.html">
<title>Span</title>
</head>
<body>
Automatic redirection failed, please go to
<a href="doc/index.html">doc/index.html</a>.&nbsp;<hr>
<p><EFBFBD> Copyright Beman Dawes, 2001</p>
<p>Distributed under the Boost Software License, Version 1.0. (See accompanying
file <a href="../../LICENSE_1_0.txt">LICENSE_1_0.txt</a> or copy
at <a href="http://www.boost.org/LICENSE_1_0.txt">www.boost.org/LICENSE_1_0.txt</a>)
</p>
Redirecting you to <a href="doc/html/io.html">IO</a>.
</body>
</html>
</html>

View File

@ -2,10 +2,10 @@
"key": "io",
"name": "IO State Savers",
"authors": [
"Daryle Walker"
"Daryle Walker",
"Beman Dawes"
],
"description": "The I/O sub-library of Boost helps segregate the large number of Boost headers. This sub-library should contain various items to use with/for the standard I/O library.",
"documentation": "doc/ios_state.html",
"description": "Utilities for using the standard I/O library.",
"category": [
"IO"
],

View File

@ -1,26 +1,13 @@
# Boost.IO Library test Jamfile
# Copyright 2003 Daryle Walker
#
# Copyright 2003 Daryle Walker. Use, modification, and distribution
# are subject to the Boost Software License, Version 1.0. (See
# accompanying file LICENSE_1_0.txt or a copy at
# <http://www.boost.org/LICENSE_1_0.txt>.)
# Copyright 2019 Glen Joseph Fernandes
# (glenjofe@gmail.com)
#
# See <http://www.boost.org/libs/io/> for the library's home page.
# Distributed under the Boost Software License, Version 1.0.
# (http://www.boost.org/LICENSE_1_0.txt)
test-suite "io"
: [ run ios_state_unit_test.cpp
../../../libs/test/build//boost_unit_test_framework/<link>static
: # args
: # input files
# : std::locale-support
]
import testing ;
[ run ios_state_test.cpp
../../../libs/test/build//boost_test_exec_monitor/<link>static
: # args
: # input files
# : std::locale-support
]
[ run quoted_manip_test.cpp ]
;
run ios_state_unit_test.cpp ;
run ios_state_test.cpp ;
run quoted_manip_test.cpp ;

View File

@ -4,6 +4,9 @@
// subject to the Boost Software License, Version 1.0. (See accompanying file
// LICENSE_1_0.txt or a copy at <http://www.boost.org/LICENSE_1_0.txt>.)
// Copyright 2019 Glen Joseph Fernandes
// (glenjofe@gmail.com)
// See <http://www.boost.org/libs/io/> for the library's home page.
// Revision History
@ -11,9 +14,8 @@
// 26 Feb 2002 Initial version (Daryle Walker)
#include <boost/config.hpp>
#include <boost/test/minimal.hpp> // main, BOOST_CHECK, etc.
#include <boost/core/lightweight_test.hpp>
#include <boost/cstdlib.hpp> // for boost::exit_success
#include <boost/io/ios_state.hpp> // for boost::io::ios_flags_saver, etc.
#include <cstddef> // for std::size_t
@ -68,12 +70,7 @@ void saver_tests_2( std::istream &input, std::ostream &output,
// Test program
int
test_main
(
int , // "argc" is unused
char * [] // "argv" is unused
)
int main()
{
using std::cout;
using std::ios_base;
@ -104,35 +101,35 @@ test_main
saver_tests_1( cin, cout, std::cerr );
// Check if states are back to normal
BOOST_CHECK( &cin == cout.pword(my_index) );
BOOST_CHECK( 42L == cout.iword(my_index) );
BOOST_CHECK( cout_locale == cout.getloc() );
BOOST_CHECK( cout_fill == cout.fill() );
BOOST_CHECK( cout_sb == cout.rdbuf() );
BOOST_CHECK( cin_tie == cin.tie() );
BOOST_CHECK( cout_exceptions == cout.exceptions() );
BOOST_CHECK( cout_iostate == cout.rdstate() );
BOOST_CHECK( cout_width == cout.width() );
BOOST_CHECK( cout_precision == cout.precision() );
BOOST_CHECK( cout_flags == cout.flags() );
BOOST_TEST( &cin == cout.pword(my_index) );
BOOST_TEST( 42L == cout.iword(my_index) );
BOOST_TEST( cout_locale == cout.getloc() );
BOOST_TEST( cout_fill == cout.fill() );
BOOST_TEST( cout_sb == cout.rdbuf() );
BOOST_TEST( cin_tie == cin.tie() );
BOOST_TEST( cout_exceptions == cout.exceptions() );
BOOST_TEST( cout_iostate == cout.rdstate() );
BOOST_TEST( cout_width == cout.width() );
BOOST_TEST( cout_precision == cout.precision() );
BOOST_TEST( cout_flags == cout.flags() );
// Run saver tests with combined saving and changing
saver_tests_2( cin, cout, std::cerr );
// Check if states are back to normal
BOOST_CHECK( &cin == cout.pword(my_index) );
BOOST_CHECK( 42L == cout.iword(my_index) );
BOOST_CHECK( cout_locale == cout.getloc() );
BOOST_CHECK( cout_fill == cout.fill() );
BOOST_CHECK( cout_sb == cout.rdbuf() );
BOOST_CHECK( cin_tie == cin.tie() );
BOOST_CHECK( cout_exceptions == cout.exceptions() );
BOOST_CHECK( cout_iostate == cout.rdstate() );
BOOST_CHECK( cout_width == cout.width() );
BOOST_CHECK( cout_precision == cout.precision() );
BOOST_CHECK( cout_flags == cout.flags() );
BOOST_TEST( &cin == cout.pword(my_index) );
BOOST_TEST( 42L == cout.iword(my_index) );
BOOST_TEST( cout_locale == cout.getloc() );
BOOST_TEST( cout_fill == cout.fill() );
BOOST_TEST( cout_sb == cout.rdbuf() );
BOOST_TEST( cin_tie == cin.tie() );
BOOST_TEST( cout_exceptions == cout.exceptions() );
BOOST_TEST( cout_iostate == cout.rdstate() );
BOOST_TEST( cout_width == cout.width() );
BOOST_TEST( cout_precision == cout.precision() );
BOOST_TEST( cout_flags == cout.flags() );
return boost::exit_success;
return boost::report_errors();
}
// Save, change, and restore stream properties
@ -176,8 +173,8 @@ saver_tests_1
output.imbue( loc );
output << '\t' << test_bool << '\n';
BOOST_CHECK( &err == output.pword(my_index) );
BOOST_CHECK( 69L == output.iword(my_index) );
BOOST_TEST( &err == output.pword(my_index) );
BOOST_TEST( 69L == output.iword(my_index) );
try
{
@ -195,7 +192,7 @@ saver_tests_1
#endif
{
err << "Got the expected I/O failure: \"" << f.what() << "\".\n";
BOOST_CHECK( output.exceptions() == ios_base::goodbit );
BOOST_TEST( output.exceptions() == ios_base::goodbit );
}
catch ( ... )
{
@ -239,8 +236,8 @@ saver_tests_2
boost::io::ios_locale_saver const ils( output, loc );
output << '\t' << test_bool << '\n';
BOOST_CHECK( &err == output.pword(my_index) );
BOOST_CHECK( 69L == output.iword(my_index) );
BOOST_TEST( &err == output.pword(my_index) );
BOOST_TEST( 69L == output.iword(my_index) );
try
{
@ -257,7 +254,7 @@ saver_tests_2
#endif
{
err << "Got the expected I/O failure: \"" << f.what() << "\".\n";
BOOST_CHECK( output.exceptions() == ios_base::goodbit );
BOOST_TEST( output.exceptions() == ios_base::goodbit );
}
catch ( ... )
{

View File

@ -4,6 +4,9 @@
// subject to the Boost Software License, Version 1.0. (See accompanying file
// LICENSE_1_0.txt or a copy at <http://www.boost.org/LICENSE_1_0.txt>.)
// Copyright 2019 Glen Joseph Fernandes
// (glenjofe@gmail.com)
// See <http://www.boost.org/libs/io/> for the library's home page.
// Revision History
@ -11,7 +14,7 @@
#include <boost/config.hpp>
#include <boost/io/ios_state.hpp> // for boost::io::ios_flags_saver, etc.
#include <boost/test/unit_test.hpp> // for main, BOOST_CHECK, etc.
#include <boost/core/lightweight_test.hpp>
#include <cstddef> // for NULL
#include <iomanip> // for std::setiosflags, etc.
@ -60,33 +63,33 @@ ios_flags_saver_unit_test
stringstream ss;
BOOST_CHECK_EQUAL( (ios_base::skipws | ios_base::dec), ss.flags() );
BOOST_TEST_EQ( (ios_base::skipws | ios_base::dec), ss.flags() );
{
boost::io::ios_flags_saver ifs( ss );
BOOST_CHECK_EQUAL( (ios_base::skipws | ios_base::dec), ss.flags() );
BOOST_TEST_EQ( (ios_base::skipws | ios_base::dec), ss.flags() );
ss << noskipws << fixed << boolalpha;
BOOST_CHECK_EQUAL( (ios_base::boolalpha | ios_base::dec
BOOST_TEST_EQ( (ios_base::boolalpha | ios_base::dec
| ios_base::fixed), ss.flags() );
}
BOOST_CHECK_EQUAL( (ios_base::skipws | ios_base::dec), ss.flags() );
BOOST_TEST_EQ( (ios_base::skipws | ios_base::dec), ss.flags() );
{
boost::io::ios_flags_saver ifs( ss, (ios_base::showbase
| ios_base::internal) );
BOOST_CHECK_EQUAL( (ios_base::showbase | ios_base::internal),
BOOST_TEST_EQ( (ios_base::showbase | ios_base::internal),
ss.flags() );
ss << setiosflags( ios_base::unitbuf );
BOOST_CHECK_EQUAL( (ios_base::showbase | ios_base::internal
BOOST_TEST_EQ( (ios_base::showbase | ios_base::internal
| ios_base::unitbuf), ss.flags() );
}
BOOST_CHECK_EQUAL( (ios_base::skipws | ios_base::dec), ss.flags() );
BOOST_TEST_EQ( (ios_base::skipws | ios_base::dec), ss.flags() );
}
// Unit test for precision saving
@ -99,29 +102,29 @@ ios_precision_saver_unit_test
stringstream ss;
BOOST_CHECK_EQUAL( 6, ss.precision() );
BOOST_TEST_EQ( 6, ss.precision() );
{
boost::io::ios_precision_saver ips( ss );
BOOST_CHECK_EQUAL( 6, ss.precision() );
BOOST_TEST_EQ( 6, ss.precision() );
ss << setprecision( 4 );
BOOST_CHECK_EQUAL( 4, ss.precision() );
BOOST_TEST_EQ( 4, ss.precision() );
}
BOOST_CHECK_EQUAL( 6, ss.precision() );
BOOST_TEST_EQ( 6, ss.precision() );
{
boost::io::ios_precision_saver ips( ss, 8 );
BOOST_CHECK_EQUAL( 8, ss.precision() );
BOOST_TEST_EQ( 8, ss.precision() );
ss << setprecision( 10 );
BOOST_CHECK_EQUAL( 10, ss.precision() );
BOOST_TEST_EQ( 10, ss.precision() );
}
BOOST_CHECK_EQUAL( 6, ss.precision() );
BOOST_TEST_EQ( 6, ss.precision() );
}
// Unit test for width saving
@ -134,29 +137,29 @@ ios_width_saver_unit_test
stringstream ss;
BOOST_CHECK_EQUAL( 0, ss.width() );
BOOST_TEST_EQ( 0, ss.width() );
{
boost::io::ios_width_saver iws( ss );
BOOST_CHECK_EQUAL( 0, ss.width() );
BOOST_TEST_EQ( 0, ss.width() );
ss << setw( 4 );
BOOST_CHECK_EQUAL( 4, ss.width() );
BOOST_TEST_EQ( 4, ss.width() );
}
BOOST_CHECK_EQUAL( 0, ss.width() );
BOOST_TEST_EQ( 0, ss.width() );
{
boost::io::ios_width_saver iws( ss, 8 );
BOOST_CHECK_EQUAL( 8, ss.width() );
BOOST_TEST_EQ( 8, ss.width() );
ss << setw( 10 );
BOOST_CHECK_EQUAL( 10, ss.width() );
BOOST_TEST_EQ( 10, ss.width() );
}
BOOST_CHECK_EQUAL( 0, ss.width() );
BOOST_TEST_EQ( 0, ss.width() );
}
// Unit test for I/O-state saving
@ -169,43 +172,43 @@ ios_iostate_saver_unit_test
stringstream ss;
BOOST_CHECK_EQUAL( ios_base::goodbit, ss.rdstate() );
BOOST_CHECK( ss.good() );
BOOST_TEST_EQ( ios_base::goodbit, ss.rdstate() );
BOOST_TEST( ss.good() );
{
boost::io::ios_iostate_saver iis( ss );
char c;
BOOST_CHECK_EQUAL( ios_base::goodbit, ss.rdstate() );
BOOST_CHECK( ss.good() );
BOOST_TEST_EQ( ios_base::goodbit, ss.rdstate() );
BOOST_TEST( ss.good() );
ss >> c;
BOOST_CHECK_EQUAL( (ios_base::eofbit | ios_base::failbit),
BOOST_TEST_EQ( (ios_base::eofbit | ios_base::failbit),
ss.rdstate() );
BOOST_CHECK( ss.eof() );
BOOST_CHECK( ss.fail() );
BOOST_CHECK( !ss.bad() );
BOOST_TEST( ss.eof() );
BOOST_TEST( ss.fail() );
BOOST_TEST( !ss.bad() );
}
BOOST_CHECK_EQUAL( ios_base::goodbit, ss.rdstate() );
BOOST_CHECK( ss.good() );
BOOST_TEST_EQ( ios_base::goodbit, ss.rdstate() );
BOOST_TEST( ss.good() );
{
boost::io::ios_iostate_saver iis( ss, ios_base::eofbit );
BOOST_CHECK_EQUAL( ios_base::eofbit, ss.rdstate() );
BOOST_CHECK( ss.eof() );
BOOST_TEST_EQ( ios_base::eofbit, ss.rdstate() );
BOOST_TEST( ss.eof() );
ss.setstate( ios_base::badbit );
BOOST_CHECK_EQUAL( (ios_base::eofbit | ios_base::badbit),
BOOST_TEST_EQ( (ios_base::eofbit | ios_base::badbit),
ss.rdstate() );
BOOST_CHECK( ss.eof() );
BOOST_CHECK( ss.fail() );
BOOST_CHECK( ss.bad() );
BOOST_TEST( ss.eof() );
BOOST_TEST( ss.fail() );
BOOST_TEST( ss.bad() );
}
BOOST_CHECK_EQUAL( ios_base::goodbit, ss.rdstate() );
BOOST_CHECK( ss.good() );
BOOST_TEST_EQ( ios_base::goodbit, ss.rdstate() );
BOOST_TEST( ss.good() );
}
// Unit test for exception-flag saving
@ -218,15 +221,15 @@ ios_exception_saver_unit_test
stringstream ss;
BOOST_CHECK_EQUAL( ios_base::goodbit, ss.exceptions() );
BOOST_TEST_EQ( ios_base::goodbit, ss.exceptions() );
{
boost::io::ios_exception_saver ies( ss );
BOOST_CHECK_EQUAL( ios_base::goodbit, ss.exceptions() );
BOOST_TEST_EQ( ios_base::goodbit, ss.exceptions() );
ss.exceptions( ios_base::failbit );
BOOST_CHECK_EQUAL( ios_base::failbit, ss.exceptions() );
BOOST_TEST_EQ( ios_base::failbit, ss.exceptions() );
{
boost::io::ios_iostate_saver iis( ss );
@ -234,32 +237,32 @@ ios_exception_saver_unit_test
char c;
#if defined(BOOST_GCC) || (defined(BOOST_CLANG) && defined(BOOST_GNU_STDLIB))
BOOST_CHECK_THROW( ss >> c, std::exception );
BOOST_TEST_THROWS( ss >> c, std::exception );
#else
BOOST_CHECK_THROW( ss >> c, std::ios_base::failure );
BOOST_TEST_THROWS( ss >> c, std::ios_base::failure );
#endif
}
}
BOOST_CHECK_EQUAL( ios_base::goodbit, ss.exceptions() );
BOOST_TEST_EQ( ios_base::goodbit, ss.exceptions() );
{
boost::io::ios_exception_saver ies( ss, ios_base::eofbit );
BOOST_CHECK_EQUAL( ios_base::eofbit, ss.exceptions() );
BOOST_TEST_EQ( ios_base::eofbit, ss.exceptions() );
ss.exceptions( ios_base::badbit );
BOOST_CHECK_EQUAL( ios_base::badbit, ss.exceptions() );
BOOST_TEST_EQ( ios_base::badbit, ss.exceptions() );
{
boost::io::ios_iostate_saver iis( ss );
char c;
BOOST_CHECK_NO_THROW( ss >> c );
BOOST_TEST_NOT( ss >> c );
}
}
BOOST_CHECK_EQUAL( ios_base::goodbit, ss.exceptions() );
BOOST_TEST_EQ( ios_base::goodbit, ss.exceptions() );
}
// Unit test for tied-stream saving
@ -270,29 +273,29 @@ ios_tie_saver_unit_test
{
using namespace std;
BOOST_CHECK( NULL == cout.tie() );
BOOST_TEST( NULL == cout.tie() );
{
boost::io::ios_tie_saver its( cout );
BOOST_CHECK( NULL == cout.tie() );
BOOST_TEST( NULL == cout.tie() );
cout.tie( &clog );
BOOST_CHECK_EQUAL( &clog, cout.tie() );
BOOST_TEST_EQ( &clog, cout.tie() );
}
BOOST_CHECK( NULL == cout.tie() );
BOOST_TEST( NULL == cout.tie() );
{
boost::io::ios_tie_saver its( cout, &clog );
BOOST_CHECK_EQUAL( &clog, cout.tie() );
BOOST_TEST_EQ( &clog, cout.tie() );
cout.tie( &cerr );
BOOST_CHECK_EQUAL( &cerr, cout.tie() );
BOOST_TEST_EQ( &cerr, cout.tie() );
}
BOOST_CHECK( NULL == cout.tie() );
BOOST_TEST( NULL == cout.tie() );
}
// Unit test for connected-streambuf saving
@ -305,31 +308,31 @@ ios_rdbuf_saver_unit_test
iostream s( NULL );
BOOST_CHECK( NULL == s.rdbuf() );
BOOST_TEST( NULL == s.rdbuf() );
{
stringbuf sb;
boost::io::ios_rdbuf_saver irs( s );
BOOST_CHECK( NULL == s.rdbuf() );
BOOST_TEST( NULL == s.rdbuf() );
s.rdbuf( &sb );
BOOST_CHECK_EQUAL( &sb, s.rdbuf() );
BOOST_TEST_EQ( &sb, s.rdbuf() );
}
BOOST_CHECK( NULL == s.rdbuf() );
BOOST_TEST( NULL == s.rdbuf() );
{
stringbuf sb1, sb2( "Hi there" );
boost::io::ios_rdbuf_saver irs( s, &sb1 );
BOOST_CHECK_EQUAL( &sb1, s.rdbuf() );
BOOST_TEST_EQ( &sb1, s.rdbuf() );
s.rdbuf( &sb2 );
BOOST_CHECK_EQUAL( &sb2, s.rdbuf() );
BOOST_TEST_EQ( &sb2, s.rdbuf() );
}
BOOST_CHECK( NULL == s.rdbuf() );
BOOST_TEST( NULL == s.rdbuf() );
}
// Unit test for fill-character saving
@ -342,29 +345,29 @@ ios_fill_saver_unit_test
stringstream ss;
BOOST_CHECK_EQUAL( ' ', ss.fill() );
BOOST_TEST_EQ( ' ', ss.fill() );
{
boost::io::ios_fill_saver ifs( ss );
BOOST_CHECK_EQUAL( ' ', ss.fill() );
BOOST_TEST_EQ( ' ', ss.fill() );
ss.fill( 'x' );
BOOST_CHECK_EQUAL( 'x', ss.fill() );
BOOST_TEST_EQ( 'x', ss.fill() );
}
BOOST_CHECK_EQUAL( ' ', ss.fill() );
BOOST_TEST_EQ( ' ', ss.fill() );
{
boost::io::ios_fill_saver ifs( ss, '3' );
BOOST_CHECK_EQUAL( '3', ss.fill() );
BOOST_TEST_EQ( '3', ss.fill() );
ss.fill( '+' );
BOOST_CHECK_EQUAL( '+', ss.fill() );
BOOST_TEST_EQ( '+', ss.fill() );
}
BOOST_CHECK_EQUAL( ' ', ss.fill() );
BOOST_TEST_EQ( ' ', ss.fill() );
}
// Unit test for locale saving
@ -379,48 +382,48 @@ ios_locale_saver_unit_test
stringstream ss;
BOOST_CHECK( locale() == ss.getloc() );
// locales are unprintable, so no BOOST_CHECK_EQUAL
BOOST_CHECK( !has_facet<npc_type>(ss.getloc()) || (NULL
BOOST_TEST( locale() == ss.getloc() );
// locales are unprintable, so no BOOST_TEST_EQ
BOOST_TEST( !has_facet<npc_type>(ss.getloc()) || (NULL
== dynamic_cast<backward_bool_names const *>(
&use_facet<npc_type>(ss.getloc()) )) );
// my implementation of has_facet just checks IDs, but doesn't do dynamic
// cast (therefore if a specifc facet type is missing, but its base class
// is available, has_facet will mistakenly[?] match), so I have to do it
// here. I wanted: "BOOST_CHECK( ! has_facet< backward_bool_names >(
// here. I wanted: "BOOST_TEST( ! has_facet< backward_bool_names >(
// ss.getloc() ) )"
{
boost::io::ios_locale_saver ils( ss );
BOOST_CHECK( locale() == ss.getloc() );
BOOST_TEST( locale() == ss.getloc() );
ss.imbue( locale::classic() );
BOOST_CHECK( locale::classic() == ss.getloc() );
BOOST_TEST( locale::classic() == ss.getloc() );
}
BOOST_CHECK( locale() == ss.getloc() );
BOOST_CHECK( !has_facet<npc_type>(ss.getloc()) || (NULL
BOOST_TEST( locale() == ss.getloc() );
BOOST_TEST( !has_facet<npc_type>(ss.getloc()) || (NULL
== dynamic_cast<backward_bool_names const *>(
&use_facet<npc_type>(ss.getloc()) )) );
{
boost::io::ios_locale_saver ils( ss, locale::classic() );
BOOST_CHECK( locale::classic() == ss.getloc() );
BOOST_CHECK( !has_facet<npc_type>(ss.getloc()) || (NULL
BOOST_TEST( locale::classic() == ss.getloc() );
BOOST_TEST( !has_facet<npc_type>(ss.getloc()) || (NULL
== dynamic_cast<backward_bool_names const *>(
&use_facet<npc_type>(ss.getloc()) )) );
ss.imbue( locale(locale::classic(), new backward_bool_names) );
BOOST_CHECK( locale::classic() != ss.getloc() );
BOOST_CHECK( has_facet<npc_type>(ss.getloc()) && (NULL
BOOST_TEST( locale::classic() != ss.getloc() );
BOOST_TEST( has_facet<npc_type>(ss.getloc()) && (NULL
!= dynamic_cast<backward_bool_names const *>(
&use_facet<npc_type>(ss.getloc()) )) );
//BOOST_CHECK( has_facet<backward_bool_names>(ss.getloc()) );
//BOOST_TEST( has_facet<backward_bool_names>(ss.getloc()) );
}
BOOST_CHECK( locale() == ss.getloc() );
BOOST_CHECK( !has_facet<npc_type>(ss.getloc()) || (NULL
BOOST_TEST( locale() == ss.getloc() );
BOOST_TEST( !has_facet<npc_type>(ss.getloc()) || (NULL
== dynamic_cast<backward_bool_names const *>(
&use_facet<npc_type>(ss.getloc()) )) );
}
@ -435,29 +438,29 @@ ios_iword_saver_unit_test
stringstream ss;
BOOST_CHECK_EQUAL( 0, ss.iword(word_index) );
BOOST_TEST_EQ( 0, ss.iword(word_index) );
{
boost::io::ios_iword_saver iis( ss, word_index );
BOOST_CHECK_EQUAL( 0, ss.iword(word_index) );
BOOST_TEST_EQ( 0, ss.iword(word_index) );
ss.iword( word_index ) = 6;
BOOST_CHECK_EQUAL( 6, ss.iword(word_index) );
BOOST_TEST_EQ( 6, ss.iword(word_index) );
}
BOOST_CHECK_EQUAL( 0, ss.iword(word_index) );
BOOST_TEST_EQ( 0, ss.iword(word_index) );
{
boost::io::ios_iword_saver iis( ss, word_index, 100 );
BOOST_CHECK_EQUAL( 100, ss.iword(word_index) );
BOOST_TEST_EQ( 100, ss.iword(word_index) );
ss.iword( word_index ) = -2000;
BOOST_CHECK_EQUAL( -2000, ss.iword(word_index) );
BOOST_TEST_EQ( -2000, ss.iword(word_index) );
}
BOOST_CHECK_EQUAL( 0, ss.iword(word_index) );
BOOST_TEST_EQ( 0, ss.iword(word_index) );
}
// Unit test for user-defined pointer data saving
@ -470,29 +473,29 @@ ios_pword_saver_unit_test
stringstream ss;
BOOST_CHECK( NULL == ss.pword(word_index) );
BOOST_TEST( NULL == ss.pword(word_index) );
{
boost::io::ios_pword_saver ips( ss, word_index );
BOOST_CHECK( NULL == ss.pword(word_index) );
BOOST_TEST( NULL == ss.pword(word_index) );
ss.pword( word_index ) = &ss;
BOOST_CHECK_EQUAL( &ss, ss.pword(word_index) );
BOOST_TEST_EQ( &ss, ss.pword(word_index) );
}
BOOST_CHECK( NULL == ss.pword(word_index) );
BOOST_TEST( NULL == ss.pword(word_index) );
{
boost::io::ios_pword_saver ips( ss, word_index, ss.rdbuf() );
BOOST_CHECK_EQUAL( ss.rdbuf(), ss.pword(word_index) );
BOOST_TEST_EQ( ss.rdbuf(), ss.pword(word_index) );
ss.pword( word_index ) = &ss;
BOOST_CHECK_EQUAL( &ss, ss.pword(word_index) );
BOOST_TEST_EQ( &ss, ss.pword(word_index) );
}
BOOST_CHECK( NULL == ss.pword(word_index) );
BOOST_TEST( NULL == ss.pword(word_index) );
}
// Unit test for all ios_base data saving
@ -505,27 +508,27 @@ ios_base_all_saver_unit_test
stringstream ss;
BOOST_CHECK_EQUAL( (ios_base::skipws | ios_base::dec), ss.flags() );
BOOST_CHECK_EQUAL( 6, ss.precision() );
BOOST_CHECK_EQUAL( 0, ss.width() );
BOOST_TEST_EQ( (ios_base::skipws | ios_base::dec), ss.flags() );
BOOST_TEST_EQ( 6, ss.precision() );
BOOST_TEST_EQ( 0, ss.width() );
{
boost::io::ios_base_all_saver ibas( ss );
BOOST_CHECK_EQUAL( (ios_base::skipws | ios_base::dec), ss.flags() );
BOOST_CHECK_EQUAL( 6, ss.precision() );
BOOST_CHECK_EQUAL( 0, ss.width() );
BOOST_TEST_EQ( (ios_base::skipws | ios_base::dec), ss.flags() );
BOOST_TEST_EQ( 6, ss.precision() );
BOOST_TEST_EQ( 0, ss.width() );
ss << hex << unitbuf << setprecision( 5 ) << setw( 7 );
BOOST_CHECK_EQUAL( (ios_base::unitbuf | ios_base::hex
BOOST_TEST_EQ( (ios_base::unitbuf | ios_base::hex
| ios_base::skipws), ss.flags() );
BOOST_CHECK_EQUAL( 5, ss.precision() );
BOOST_CHECK_EQUAL( 7, ss.width() );
BOOST_TEST_EQ( 5, ss.precision() );
BOOST_TEST_EQ( 7, ss.width() );
}
BOOST_CHECK_EQUAL( (ios_base::skipws | ios_base::dec), ss.flags() );
BOOST_CHECK_EQUAL( 6, ss.precision() );
BOOST_CHECK_EQUAL( 0, ss.width() );
BOOST_TEST_EQ( (ios_base::skipws | ios_base::dec), ss.flags() );
BOOST_TEST_EQ( 6, ss.precision() );
BOOST_TEST_EQ( 0, ss.width() );
}
// Unit test for all basic_ios data saving
@ -541,46 +544,46 @@ ios_all_saver_unit_test
stringbuf sb;
iostream ss( &sb );
BOOST_CHECK_EQUAL( (ios_base::skipws | ios_base::dec), ss.flags() );
BOOST_CHECK_EQUAL( 6, ss.precision() );
BOOST_CHECK_EQUAL( 0, ss.width() );
BOOST_CHECK_EQUAL( ios_base::goodbit, ss.rdstate() );
BOOST_CHECK( ss.good() );
BOOST_CHECK_EQUAL( ios_base::goodbit, ss.exceptions() );
BOOST_CHECK( NULL == ss.tie() );
BOOST_CHECK( &sb == ss.rdbuf() );
BOOST_CHECK_EQUAL( ' ', ss.fill() );
BOOST_CHECK( locale() == ss.getloc() );
BOOST_TEST_EQ( (ios_base::skipws | ios_base::dec), ss.flags() );
BOOST_TEST_EQ( 6, ss.precision() );
BOOST_TEST_EQ( 0, ss.width() );
BOOST_TEST_EQ( ios_base::goodbit, ss.rdstate() );
BOOST_TEST( ss.good() );
BOOST_TEST_EQ( ios_base::goodbit, ss.exceptions() );
BOOST_TEST( NULL == ss.tie() );
BOOST_TEST( &sb == ss.rdbuf() );
BOOST_TEST_EQ( ' ', ss.fill() );
BOOST_TEST( locale() == ss.getloc() );
{
boost::io::ios_all_saver ias( ss );
BOOST_CHECK_EQUAL( (ios_base::skipws | ios_base::dec), ss.flags() );
BOOST_CHECK_EQUAL( 6, ss.precision() );
BOOST_CHECK_EQUAL( 0, ss.width() );
BOOST_CHECK_EQUAL( ios_base::goodbit, ss.rdstate() );
BOOST_CHECK( ss.good() );
BOOST_CHECK_EQUAL( ios_base::goodbit, ss.exceptions() );
BOOST_CHECK( NULL == ss.tie() );
BOOST_CHECK( &sb == ss.rdbuf() );
BOOST_CHECK_EQUAL( ' ', ss.fill() );
BOOST_CHECK( locale() == ss.getloc() );
BOOST_TEST_EQ( (ios_base::skipws | ios_base::dec), ss.flags() );
BOOST_TEST_EQ( 6, ss.precision() );
BOOST_TEST_EQ( 0, ss.width() );
BOOST_TEST_EQ( ios_base::goodbit, ss.rdstate() );
BOOST_TEST( ss.good() );
BOOST_TEST_EQ( ios_base::goodbit, ss.exceptions() );
BOOST_TEST( NULL == ss.tie() );
BOOST_TEST( &sb == ss.rdbuf() );
BOOST_TEST_EQ( ' ', ss.fill() );
BOOST_TEST( locale() == ss.getloc() );
ss << oct << showpos << noskipws;
BOOST_CHECK_EQUAL( (ios_base::showpos | ios_base::oct), ss.flags() );
BOOST_TEST_EQ( (ios_base::showpos | ios_base::oct), ss.flags() );
ss << setprecision( 3 );
BOOST_CHECK_EQUAL( 3, ss.precision() );
BOOST_TEST_EQ( 3, ss.precision() );
ss << setw( 9 );
BOOST_CHECK_EQUAL( 9, ss.width() );
BOOST_TEST_EQ( 9, ss.width() );
ss.setstate( ios_base::eofbit );
BOOST_CHECK_EQUAL( ios_base::eofbit, ss.rdstate() );
BOOST_CHECK( ss.eof() );
BOOST_TEST_EQ( ios_base::eofbit, ss.rdstate() );
BOOST_TEST( ss.eof() );
ss.exceptions( ios_base::failbit );
BOOST_CHECK_EQUAL( ios_base::failbit, ss.exceptions() );
BOOST_TEST_EQ( ios_base::failbit, ss.exceptions() );
{
boost::io::ios_iostate_saver iis( ss );
@ -588,38 +591,38 @@ ios_all_saver_unit_test
char c;
#if defined(BOOST_GCC) || (defined(BOOST_CLANG) && defined(BOOST_GNU_STDLIB))
BOOST_CHECK_THROW( ss >> c, std::exception );
BOOST_TEST_THROWS( ss >> c, std::exception );
#else
BOOST_CHECK_THROW( ss >> c, std::ios_base::failure );
BOOST_TEST_THROWS( ss >> c, std::ios_base::failure );
#endif
}
ss.tie( &clog );
BOOST_CHECK_EQUAL( &clog, ss.tie() );
BOOST_TEST_EQ( &clog, ss.tie() );
ss.rdbuf( cerr.rdbuf() );
BOOST_CHECK_EQUAL( cerr.rdbuf(), ss.rdbuf() );
BOOST_TEST_EQ( cerr.rdbuf(), ss.rdbuf() );
ss << setfill( 'x' );
BOOST_CHECK_EQUAL( 'x', ss.fill() );
BOOST_TEST_EQ( 'x', ss.fill() );
ss.imbue( locale(locale::classic(), new backward_bool_names) );
BOOST_CHECK( locale() != ss.getloc() );
BOOST_CHECK( has_facet<npc_type>(ss.getloc()) && (NULL
BOOST_TEST( locale() != ss.getloc() );
BOOST_TEST( has_facet<npc_type>(ss.getloc()) && (NULL
!= dynamic_cast<backward_bool_names const *>(
&use_facet<npc_type>(ss.getloc()) )) );
}
BOOST_CHECK_EQUAL( (ios_base::skipws | ios_base::dec), ss.flags() );
BOOST_CHECK_EQUAL( 6, ss.precision() );
BOOST_CHECK_EQUAL( 0, ss.width() );
BOOST_CHECK_EQUAL( ios_base::goodbit, ss.rdstate() );
BOOST_CHECK( ss.good() );
BOOST_CHECK_EQUAL( ios_base::goodbit, ss.exceptions() );
BOOST_CHECK( NULL == ss.tie() );
BOOST_CHECK( &sb == ss.rdbuf() );
BOOST_CHECK_EQUAL( ' ', ss.fill() );
BOOST_CHECK( locale() == ss.getloc() );
BOOST_TEST_EQ( (ios_base::skipws | ios_base::dec), ss.flags() );
BOOST_TEST_EQ( 6, ss.precision() );
BOOST_TEST_EQ( 0, ss.width() );
BOOST_TEST_EQ( ios_base::goodbit, ss.rdstate() );
BOOST_TEST( ss.good() );
BOOST_TEST_EQ( ios_base::goodbit, ss.exceptions() );
BOOST_TEST( NULL == ss.tie() );
BOOST_TEST( &sb == ss.rdbuf() );
BOOST_TEST_EQ( ' ', ss.fill() );
BOOST_TEST( locale() == ss.getloc() );
}
// Unit test for user-defined data saving
@ -632,54 +635,46 @@ ios_word_saver_unit_test
stringstream ss;
BOOST_CHECK_EQUAL( 0, ss.iword(word_index) );
BOOST_CHECK( NULL == ss.pword(word_index) );
BOOST_TEST_EQ( 0, ss.iword(word_index) );
BOOST_TEST( NULL == ss.pword(word_index) );
{
boost::io::ios_all_word_saver iaws( ss, word_index );
BOOST_CHECK_EQUAL( 0, ss.iword(word_index) );
BOOST_CHECK( NULL == ss.pword(word_index) );
BOOST_TEST_EQ( 0, ss.iword(word_index) );
BOOST_TEST( NULL == ss.pword(word_index) );
ss.iword( word_index ) = -11;
ss.pword( word_index ) = ss.rdbuf();
BOOST_CHECK_EQUAL( -11, ss.iword(word_index) );
BOOST_CHECK_EQUAL( ss.rdbuf(), ss.pword(word_index) );
BOOST_TEST_EQ( -11, ss.iword(word_index) );
BOOST_TEST_EQ( ss.rdbuf(), ss.pword(word_index) );
}
BOOST_CHECK_EQUAL( 0, ss.iword(word_index) );
BOOST_CHECK( NULL == ss.pword(word_index) );
BOOST_TEST_EQ( 0, ss.iword(word_index) );
BOOST_TEST( NULL == ss.pword(word_index) );
}
// Unit test program
boost::unit_test::test_suite *
init_unit_test_suite
(
int , // "argc" is unused
char * [] // "argv" is unused
)
int main()
{
boost::unit_test::test_suite * test
= BOOST_TEST_SUITE( "I/O state saver test" );
ios_flags_saver_unit_test();
ios_precision_saver_unit_test();
ios_width_saver_unit_test();
test->add( BOOST_TEST_CASE(ios_flags_saver_unit_test) );
test->add( BOOST_TEST_CASE(ios_precision_saver_unit_test) );
test->add( BOOST_TEST_CASE(ios_width_saver_unit_test) );
ios_iostate_saver_unit_test();
ios_exception_saver_unit_test();
ios_tie_saver_unit_test();
ios_rdbuf_saver_unit_test();
ios_fill_saver_unit_test();
ios_locale_saver_unit_test();
test->add( BOOST_TEST_CASE(ios_iostate_saver_unit_test) );
test->add( BOOST_TEST_CASE(ios_exception_saver_unit_test) );
test->add( BOOST_TEST_CASE(ios_tie_saver_unit_test) );
test->add( BOOST_TEST_CASE(ios_rdbuf_saver_unit_test) );
test->add( BOOST_TEST_CASE(ios_fill_saver_unit_test) );
test->add( BOOST_TEST_CASE(ios_locale_saver_unit_test) );
ios_iword_saver_unit_test();
ios_pword_saver_unit_test();
test->add( BOOST_TEST_CASE(ios_iword_saver_unit_test) );
test->add( BOOST_TEST_CASE(ios_pword_saver_unit_test) );
ios_base_all_saver_unit_test();
ios_all_saver_unit_test();
ios_word_saver_unit_test();
test->add( BOOST_TEST_CASE(ios_base_all_saver_unit_test) );
test->add( BOOST_TEST_CASE(ios_all_saver_unit_test) );
test->add( BOOST_TEST_CASE(ios_word_saver_unit_test) );
return test;
return boost::report_errors();
}

View File

@ -10,7 +10,7 @@
// ---------------------------------------------------------------------------------- //
#include <boost/io/detail/quoted_manip.hpp>
#include <boost/detail/lightweight_test.hpp>
#include <boost/core/lightweight_test.hpp>
#include <iostream>
#include <sstream>

View File

@ -0,0 +1,17 @@
# Copyright 2018 Mike Dev
# Distributed under the Boost Software License, Version 1.0.
# See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt
#
# NOTE: This does NOT run the unit tests for Boost.IO.
# It only tests, if the CMakeLists.txt file in the
# Boost.IO root directory works as expected.
cmake_minimum_required( VERSION 3.5 )
project( BoostIoCMakeSelfTest )
add_subdirectory( ../../../config ${CMAKE_CURRENT_BINARY_DIR}/libs/config )
add_subdirectory( ../.. ${CMAKE_CURRENT_BINARY_DIR}/libs/io )
add_executable( boost_io_cmake_self_test main.cpp )
target_link_libraries( boost_io_cmake_self_test Boost::io )

5
test/test_cmake/main.cpp Normal file
View File

@ -0,0 +1,5 @@
#include <boost/io/ios_state.hpp>
#include <boost/io_fwd.hpp>
int main() {
}