mirror of
https://github.com/boostorg/tuple.git
synced 2025-07-04 08:16:38 +02:00
Compare commits
2 Commits
boost-1.80
...
svn-branch
| Author | SHA1 | Date | |
|---|---|---|---|
| 588a6eeb1b | |||
| 0b8d721265 |
287
.github/workflows/ci.yml
vendored
287
.github/workflows/ci.yml
vendored
@ -1,287 +0,0 @@
|
||||
name: GitHub Actions CI
|
||||
|
||||
on:
|
||||
pull_request:
|
||||
push:
|
||||
branches:
|
||||
- master
|
||||
- develop
|
||||
- githubactions*
|
||||
- feature/**
|
||||
- fix/**
|
||||
- pr/**
|
||||
|
||||
jobs:
|
||||
posix:
|
||||
strategy:
|
||||
fail-fast: false
|
||||
matrix:
|
||||
include:
|
||||
- name: "TOOLSET=gcc COMPILER=g++ CXXSTD=03,11 Job 0"
|
||||
buildtype: "boost"
|
||||
packages: ""
|
||||
packages_to_remove: ""
|
||||
os: "ubuntu-20.04"
|
||||
container: "ubuntu:16.04"
|
||||
cxx: "g++"
|
||||
sources: ""
|
||||
llvm_os: ""
|
||||
llvm_ver: ""
|
||||
toolset: "gcc"
|
||||
compiler: "g++"
|
||||
cxxstd: "03,11"
|
||||
- name: "TOOLSET=gcc COMPILER=g++-5 CXXSTD=03,11,14,1z Job 1"
|
||||
buildtype: "boost"
|
||||
packages: "g++-5"
|
||||
packages_to_remove: ""
|
||||
os: "ubuntu-20.04"
|
||||
container: "ubuntu:16.04"
|
||||
cxx: "g++-5"
|
||||
sources: ""
|
||||
llvm_os: ""
|
||||
llvm_ver: ""
|
||||
toolset: "gcc"
|
||||
compiler: "g++-5"
|
||||
cxxstd: "03,11,14,1z"
|
||||
- name: "TOOLSET=gcc COMPILER=g++-6 CXXSTD=03,11,14,1z Job 2"
|
||||
buildtype: "boost"
|
||||
packages: "g++-6"
|
||||
packages_to_remove: ""
|
||||
os: "ubuntu-20.04"
|
||||
container: "ubuntu:16.04"
|
||||
cxx: "g++-6"
|
||||
sources: ""
|
||||
llvm_os: ""
|
||||
llvm_ver: ""
|
||||
toolset: "gcc"
|
||||
compiler: "g++-6"
|
||||
cxxstd: "03,11,14,1z"
|
||||
- name: "TOOLSET=gcc COMPILER=g++-7 CXXSTD=03,11,14,17 Job 3"
|
||||
buildtype: "boost"
|
||||
packages: "g++-7"
|
||||
packages_to_remove: ""
|
||||
os: "ubuntu-20.04"
|
||||
container: "ubuntu:16.04"
|
||||
cxx: "g++-7"
|
||||
sources: ""
|
||||
llvm_os: ""
|
||||
llvm_ver: ""
|
||||
toolset: "gcc"
|
||||
compiler: "g++-7"
|
||||
cxxstd: "03,11,14,17"
|
||||
- name: "TOOLSET=clang COMPILER=clang++ CXXSTD=03,11 Job 4"
|
||||
buildtype: "boost"
|
||||
packages: ""
|
||||
packages_to_remove: ""
|
||||
os: "ubuntu-18.04"
|
||||
cxx: "clang++"
|
||||
sources: ""
|
||||
llvm_os: ""
|
||||
llvm_ver: ""
|
||||
toolset: "clang"
|
||||
compiler: "clang++"
|
||||
cxxstd: "03,11"
|
||||
- name: "TOOLSET=clang COMPILER=clang++-4.0 CXXSTD=03, Job 5"
|
||||
buildtype: "boost"
|
||||
packages: "clang-4.0"
|
||||
packages_to_remove: ""
|
||||
os: "ubuntu-20.04"
|
||||
container: "ubuntu:16.04"
|
||||
cxx: "clang++-4.0"
|
||||
sources: ""
|
||||
llvm_os: "xenial"
|
||||
llvm_ver: "4.0"
|
||||
toolset: "clang"
|
||||
compiler: "clang++-4.0"
|
||||
cxxstd: "03,11,14"
|
||||
- name: "TOOLSET=clang COMPILER=clang++-5.0 CXXSTD=03, Job 6"
|
||||
buildtype: "boost"
|
||||
packages: "clang-5.0"
|
||||
packages_to_remove: ""
|
||||
os: "ubuntu-20.04"
|
||||
container: "ubuntu:16.04"
|
||||
cxx: "clang++-5.0"
|
||||
sources: ""
|
||||
llvm_os: "xenial"
|
||||
llvm_ver: "5.0"
|
||||
toolset: "clang"
|
||||
compiler: "clang++-5.0"
|
||||
cxxstd: "03,11,14,1z"
|
||||
|
||||
runs-on: ${{ matrix.os }}
|
||||
container: ${{ matrix.container }}
|
||||
|
||||
steps:
|
||||
- name: Check if running in container
|
||||
if: matrix.container != ''
|
||||
run: echo "GHA_CONTAINER=${{ matrix.container }}" >> $GITHUB_ENV
|
||||
- name: If running in container, upgrade packages
|
||||
if: matrix.container != ''
|
||||
run: |
|
||||
apt-get -o Acquire::Retries=3 update && DEBIAN_FRONTEND=noninteractive apt-get -y install tzdata && apt-get -o Acquire::Retries=3 install -y sudo software-properties-common wget curl apt-transport-https make apt-file sudo unzip libssl-dev build-essential autotools-dev autoconf automake g++ libc++-helpers python ruby cpio gcc-multilib g++-multilib pkgconf python3 ccache libpython-dev
|
||||
sudo apt-add-repository ppa:git-core/ppa
|
||||
sudo apt-get -o Acquire::Retries=3 update && apt-get -o Acquire::Retries=3 -y install git
|
||||
python_version=$(python3 -c 'import sys; print("{0.major}.{0.minor}".format(sys.version_info))')
|
||||
sudo wget https://bootstrap.pypa.io/pip/$python_version/get-pip.py
|
||||
sudo python3 get-pip.py
|
||||
sudo /usr/local/bin/pip install cmake
|
||||
|
||||
- uses: actions/checkout@v2
|
||||
|
||||
- name: linux
|
||||
shell: bash
|
||||
env:
|
||||
CXX: ${{ matrix.cxx }}
|
||||
SOURCES: ${{ matrix.sources }}
|
||||
LLVM_OS: ${{ matrix.llvm_os }}
|
||||
LLVM_VER: ${{ matrix.llvm_ver }}
|
||||
PACKAGES: ${{ matrix.packages }}
|
||||
PACKAGES_TO_REMOVE: ${{ matrix.packages_to_remove }}
|
||||
JOB_BUILDTYPE: ${{ matrix.buildtype }}
|
||||
TOOLSET: ${{ matrix.toolset }}
|
||||
COMPILER: ${{ matrix.compiler }}
|
||||
CXXSTD: ${{ matrix.cxxstd }}
|
||||
TRAVIS_BRANCH: ${{ github.base_ref }}
|
||||
TRAVIS_OS_NAME: "linux"
|
||||
run: |
|
||||
echo '==================================> SETUP'
|
||||
echo '==================================> PACKAGES'
|
||||
set -e
|
||||
if [ -n "$PACKAGES_TO_REMOVE" ]; then sudo apt-get purge -y $PACKAGES_TO_REMOVE; fi
|
||||
echo ">>>>> APT: REPO.."
|
||||
for i in {1..3}; do sudo -E apt-add-repository -y "ppa:ubuntu-toolchain-r/test" && break || sleep 2; done
|
||||
|
||||
if test -n "${LLVM_OS}" ; then
|
||||
wget -O - https://apt.llvm.org/llvm-snapshot.gpg.key | sudo apt-key add -
|
||||
if test -n "${LLVM_VER}" ; then
|
||||
sudo -E apt-add-repository "deb http://apt.llvm.org/${LLVM_OS}/ llvm-toolchain-${LLVM_OS}-${LLVM_VER} main"
|
||||
else
|
||||
# Snapshot (i.e. trunk) build of clang
|
||||
sudo -E apt-add-repository "deb http://apt.llvm.org/${LLVM_OS}/ llvm-toolchain-${LLVM_OS} main"
|
||||
fi
|
||||
fi
|
||||
echo ">>>>> APT: UPDATE.."
|
||||
sudo -E apt-get -o Acquire::Retries=3 update
|
||||
if test -n "${SOURCES}" ; then
|
||||
echo ">>>>> APT: INSTALL SOURCES.."
|
||||
for SOURCE in $SOURCES; do
|
||||
sudo -E apt-add-repository ppa:$SOURCE
|
||||
done
|
||||
fi
|
||||
echo ">>>>> APT: INSTALL ${PACKAGES}.."
|
||||
sudo -E DEBIAN_FRONTEND=noninteractive apt-get -o Acquire::Retries=3 -y --no-install-suggests --no-install-recommends install ${PACKAGES}
|
||||
|
||||
echo '==================================> INSTALL AND COMPILE'
|
||||
set -e
|
||||
export TRAVIS_BUILD_DIR=$(pwd)
|
||||
export TRAVIS_BRANCH=${TRAVIS_BRANCH:-$(echo $GITHUB_REF | awk 'BEGIN { FS = "/" } ; { print $3 }')}
|
||||
export VCS_COMMIT_ID=$GITHUB_SHA
|
||||
export GIT_COMMIT=$GITHUB_SHA
|
||||
export REPO_NAME=$(basename $GITHUB_REPOSITORY)
|
||||
export USER=$(whoami)
|
||||
export CC=${CC:-gcc}
|
||||
export PATH=~/.local/bin:/usr/local/bin:$PATH
|
||||
|
||||
if [ "$JOB_BUILDTYPE" == "boost" ]; then
|
||||
|
||||
echo '==================================> INSTALL'
|
||||
|
||||
BOOST_BRANCH=develop && [ "$TRAVIS_BRANCH" == "master" ] && BOOST_BRANCH=master || true
|
||||
cd ..
|
||||
git clone -b $BOOST_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
|
||||
cp -r $TRAVIS_BUILD_DIR/* libs/tuple
|
||||
python tools/boostdep/depinst/depinst.py tuple
|
||||
./bootstrap.sh
|
||||
./b2 headers
|
||||
|
||||
echo '==================================> SCRIPT'
|
||||
|
||||
echo "using $TOOLSET : : $COMPILER ;" > ~/user-config.jam
|
||||
./b2 -j 3 libs/tuple/test toolset=$TOOLSET cxxstd=$CXXSTD
|
||||
|
||||
fi
|
||||
osx:
|
||||
strategy:
|
||||
fail-fast: false
|
||||
matrix:
|
||||
include:
|
||||
- name: "TOOLSET=clang COMPILER=clang++ CXXSTD=03,11,1 Job 7"
|
||||
buildtype: "boost"
|
||||
packages: ""
|
||||
os: "macos-10.15"
|
||||
cxx: "clang++"
|
||||
sources: ""
|
||||
llvm_os: ""
|
||||
llvm_ver: ""
|
||||
xcode_version: 11.7
|
||||
toolset: "clang"
|
||||
compiler: "clang++"
|
||||
cxxstd: "03,11,14,1z"
|
||||
|
||||
runs-on: ${{ matrix.os }}
|
||||
|
||||
steps:
|
||||
- uses: actions/checkout@v2
|
||||
|
||||
- name: Set DEVELOPER_DIR
|
||||
if: matrix.xcode_version != ''
|
||||
run: echo "DEVELOPER_DIR=/Applications/Xcode_${{ matrix.xcode_version }}.app/Contents/Developer" >> $GITHUB_ENV
|
||||
- name: Test DEVELOPER_DIR
|
||||
run: echo $DEVELOPER_DIR
|
||||
|
||||
- name: "osx"
|
||||
shell: bash
|
||||
env:
|
||||
CXX: ${{ matrix.cxx }}
|
||||
SOURCES: ${{ matrix.sources }}
|
||||
LLVM_OS: ${{ matrix.llvm_os }}
|
||||
LLVM_VER: ${{ matrix.llvm_ver }}
|
||||
PACKAGES: ${{ matrix.packages }}
|
||||
JOB_BUILDTYPE: ${{ matrix.buildtype }}
|
||||
TOOLSET: ${{ matrix.toolset }}
|
||||
COMPILER: ${{ matrix.compiler }}
|
||||
CXXSTD: ${{ matrix.cxxstd }}
|
||||
TRAVIS_BRANCH: ${{ github.base_ref }}
|
||||
TRAVIS_OS_NAME: "osx"
|
||||
run: |
|
||||
echo '==================================> SETUP'
|
||||
set -e
|
||||
sudo mv /Library/Developer/CommandLineTools /Library/Developer/CommandLineTools.bck
|
||||
echo '==================================> PACKAGES'
|
||||
echo '==================================> INSTALL AND COMPILE'
|
||||
set -e
|
||||
export TRAVIS_BUILD_DIR=$(pwd)
|
||||
export TRAVIS_BRANCH=${TRAVIS_BRANCH:-$(echo $GITHUB_REF | awk 'BEGIN { FS = "/" } ; { print $3 }')}
|
||||
export VCS_COMMIT_ID=$GITHUB_SHA
|
||||
export GIT_COMMIT=$GITHUB_SHA
|
||||
export REPO_NAME=$(basename $GITHUB_REPOSITORY)
|
||||
export USER=$(whoami)
|
||||
export CC=${CC:-gcc}
|
||||
export PATH=~/.local/bin:/usr/local/bin:$PATH
|
||||
|
||||
if [ "$JOB_BUILDTYPE" == "boost" ]; then
|
||||
|
||||
echo '==================================> INSTALL'
|
||||
|
||||
BOOST_BRANCH=develop && [ "$TRAVIS_BRANCH" == "master" ] && BOOST_BRANCH=master || true
|
||||
cd ..
|
||||
git clone -b $BOOST_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
|
||||
cp -r $TRAVIS_BUILD_DIR/* libs/tuple
|
||||
python tools/boostdep/depinst/depinst.py tuple
|
||||
./bootstrap.sh
|
||||
./b2 headers
|
||||
|
||||
echo '==================================> SCRIPT'
|
||||
|
||||
echo "using $TOOLSET : : $COMPILER ;" > ~/user-config.jam
|
||||
./b2 -j 3 libs/tuple/test toolset=$TOOLSET cxxstd=$CXXSTD
|
||||
|
||||
fi
|
||||
111
.travis.yml
111
.travis.yml
@ -1,111 +0,0 @@
|
||||
# Copyright 2016, 2017 Peter Dimov
|
||||
# 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"
|
||||
|
||||
branches:
|
||||
only:
|
||||
- master
|
||||
- develop
|
||||
- /feature\/.*/
|
||||
|
||||
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++-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: clang++
|
||||
env: TOOLSET=clang COMPILER=clang++ CXXSTD=03,11
|
||||
|
||||
- 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: 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 $BOOST_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
|
||||
- cp -r $TRAVIS_BUILD_DIR/* libs/tuple
|
||||
- python tools/boostdep/depinst/depinst.py tuple
|
||||
- ./bootstrap.sh
|
||||
- ./b2 headers
|
||||
|
||||
script:
|
||||
- |-
|
||||
echo "using $TOOLSET : : $COMPILER ;" > ~/user-config.jam
|
||||
- ./b2 -j 3 libs/tuple/test toolset=$TOOLSET cxxstd=$CXXSTD
|
||||
|
||||
notifications:
|
||||
email:
|
||||
on_success: always
|
||||
@ -1,19 +0,0 @@
|
||||
# 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...3.20)
|
||||
project(boost_tuple VERSION "${BOOST_SUPERPROJECT_VERSION}" LANGUAGES CXX)
|
||||
|
||||
add_library(boost_tuple INTERFACE)
|
||||
add_library(Boost::tuple ALIAS boost_tuple)
|
||||
|
||||
target_include_directories(boost_tuple INTERFACE include)
|
||||
|
||||
target_link_libraries(boost_tuple
|
||||
INTERFACE
|
||||
Boost::config
|
||||
Boost::core
|
||||
Boost::static_assert
|
||||
Boost::type_traits
|
||||
)
|
||||
@ -1,37 +0,0 @@
|
||||
# Copyright (c) 2001 Jaakko J<>rvi
|
||||
|
||||
# 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)
|
||||
|
||||
project doc/tuple ;
|
||||
|
||||
import boostbook ;
|
||||
import quickbook ;
|
||||
|
||||
xml tuple : tuple_users_guide.qbk ;
|
||||
|
||||
boostbook standalone_tuple
|
||||
:
|
||||
tuple
|
||||
:
|
||||
<xsl:param>boost.root=../../../..
|
||||
# File name of HTML output:
|
||||
<xsl:param>root.filename=tuple_users_guide
|
||||
# How far down we chunk nested sections, basically all of them:
|
||||
<xsl:param>chunk.section.depth=0
|
||||
# Don't put the first section on the same page as the TOC:
|
||||
<xsl:param>chunk.first.sections=0
|
||||
# How far down sections get TOC's
|
||||
<xsl:param>toc.section.depth=1
|
||||
# Max depth in each TOC:
|
||||
<xsl:param>toc.max.depth=1
|
||||
# How far down we go with TOC's
|
||||
<xsl:param>generate.section.toc.level=0
|
||||
;
|
||||
|
||||
###############################################################################
|
||||
alias boostdoc ;
|
||||
explicit boostdoc ;
|
||||
alias boostrelease : standalone_tuple ;
|
||||
explicit boostrelease ;
|
||||
@ -1,190 +0,0 @@
|
||||
[/
|
||||
/ Copyright (c) 2001 Jaakko J<>rvi
|
||||
/
|
||||
/ 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)
|
||||
/]
|
||||
|
||||
[article Design decisions rationale
|
||||
[quickbook 1.6]
|
||||
[id design_decisions_rationale]
|
||||
[copyright 2001 Jaakko J\u00E4rvi]
|
||||
[license Distributed under the
|
||||
[@http://boost.org/LICENSE_1_0.txt Boost Software License,
|
||||
Version 1.0].
|
||||
]
|
||||
]
|
||||
|
||||
[template simplesect[title]
|
||||
[block '''<simplesect><title>'''[title]'''</title>''']]
|
||||
|
||||
[template endsimplesect[]
|
||||
[block '''</simplesect>''']]
|
||||
|
||||
[section About namespaces]
|
||||
|
||||
There was a discussion about whether tuples should be in a separate namespace
|
||||
or directly in the `boost` namespace. The common principle is that domain
|
||||
libraries (like /graph/, /python/) should be on a separate subnamespace, while
|
||||
utility like libraries directly in the boost namespace. Tuples are somewhere
|
||||
in between, as the tuple template is clearly a general utility, but the
|
||||
library introduces quite a lot of names in addition to just the tuple template.
|
||||
Tuples were originally under a subnamespace. As a result of the discussion,
|
||||
tuple definitions were moved directly under the `boost` namespace. As a result
|
||||
of a continued discussion, the subnamespace was reintroduced. The final (I
|
||||
truly hope so) solution is now to have all definitions in namespace
|
||||
`::boost::tuples`, and the most common names in the `::boost` namespace as well.
|
||||
This is accomplished with using declarations (suggested by Dave Abrahams):
|
||||
|
||||
namespace boost {
|
||||
namespace tuples {
|
||||
...
|
||||
// All library code
|
||||
...
|
||||
}
|
||||
using tuples::tuple;
|
||||
using tuples::make_tuple;
|
||||
using tuples::tie;
|
||||
using tuples::get;
|
||||
}
|
||||
|
||||
With this arrangement, tuple creation with direct constructor calls,
|
||||
`make_tuple` or `tie` functions do not need the namespace qualifier. Further,
|
||||
all functions that manipulate tuples are found with Koenig-lookup. The only
|
||||
exceptions are the `get<N>` functions, which are always called with an
|
||||
explicitly qualified template argument, and thus Koenig-lookup does not apply.
|
||||
Therefore, `get` is lifted to `::boost` namespace with a using declaration.
|
||||
Hence, the interface for an application programmer is in practice under the
|
||||
namespace `::boost`.
|
||||
|
||||
The other names, forming an interface for library writers (cons lists,
|
||||
metafunctions manipulating cons lists, ...) remain in the subnamespace
|
||||
`::boost::tuples`. Note, that the names `ignore`, `set_open`, `set_close` and
|
||||
`set_delimiter` are considered to be part of the application programmer's
|
||||
interface, but are still not under `boost` namespace. The reason being the
|
||||
danger for name clashes for these common names. Further, the usage of these
|
||||
features is probably not very frequent.
|
||||
|
||||
[section For those who are really interested in namespaces]
|
||||
|
||||
The subnamespace name /tuples/ raised some discussion. The rationale for not
|
||||
using the most natural name 'tuple' is to avoid having an identical name with
|
||||
the tuple template. Namespace names are, however, not generally in plural form
|
||||
in Boost libraries. First, no real trouble was reported for using the same
|
||||
name for a namespace and a class and we considered changing the name 'tuples'
|
||||
to 'tuple'. But we found some trouble after all. Both gcc and edg compilers
|
||||
reject using declarations where the namespace and class names are identical:
|
||||
|
||||
namespace boost {
|
||||
namespace tuple {
|
||||
... tie(...);
|
||||
class tuple;
|
||||
...
|
||||
}
|
||||
using tuple::tie; // ok
|
||||
using tuple::tuple; // error
|
||||
...
|
||||
}
|
||||
|
||||
Note, however, that a corresponding using declaration in the global namespace
|
||||
seems to be ok:
|
||||
|
||||
using boost::tuple::tuple; // ok;
|
||||
|
||||
[endsect]
|
||||
|
||||
[endsect]
|
||||
|
||||
[section The end mark of the cons list (`nil`, `null_type`, ...)]
|
||||
|
||||
Tuples are internally represented as cons lists:
|
||||
|
||||
tuple<int, int>
|
||||
|
||||
inherits from
|
||||
|
||||
cons<int, cons<int, null_type> >
|
||||
|
||||
`null_type` is the end mark of the list. Original proposition was `nil`, but
|
||||
the name is used in MacOS, and might have caused problems, so `null_type` was
|
||||
chosen instead. Other names considered were /null_t/ and /unit/ (the empty
|
||||
tuple type in SML).
|
||||
|
||||
Note that `null_type` is the internal representation of an empty tuple:
|
||||
`tuple<>` inherits from `null_type`.
|
||||
|
||||
[endsect]
|
||||
|
||||
[section Element indexing]
|
||||
|
||||
Whether to use `0`- or `1`-based indexing was discussed more than thoroughly,
|
||||
and the following observations were made:
|
||||
|
||||
* `0`-based indexing is 'the C++ way' and used with arrays etc.
|
||||
|
||||
* `1`-based 'name like' indexing exists as well, eg. `bind1st`, `bind2nd`,
|
||||
`pair::first`, etc.
|
||||
|
||||
Tuple access with the syntax `get<N>(a)`, or `a.get<N>()` (where `a` is a
|
||||
tuple and `N` an index), was considered to be of the first category, hence,
|
||||
the index of the first element in a tuple is `0`.
|
||||
|
||||
A suggestion to provide `1`-based 'name like' indexing with constants like
|
||||
`_1st`, `_2nd`, `_3rd`, ... was made. By suitably chosen constant types, this
|
||||
would allow alternative syntaxes:
|
||||
|
||||
a.get<0>() == a.get(_1st) == a[_1st] == a(_1st);
|
||||
|
||||
We chose not to provide more than one indexing method for the following
|
||||
reasons:
|
||||
|
||||
* `0`-based indexing might not please everyone, but once its fixed, it is less
|
||||
confusing than having two different methods (would anyone want such
|
||||
constants for arrays?).
|
||||
|
||||
* Adding the other indexing scheme doesn't really provide anything new (like a
|
||||
new feature) to the user of the library.
|
||||
|
||||
* C++ variable and constant naming rules don't give many possibilities for
|
||||
defining short and nice index constants (like `_1st`, ...). Let the binding
|
||||
and lambda libraries use these for a better purpose.
|
||||
|
||||
* The access syntax a[_1st] (or a(_1st)) is appealing, and almost made us add
|
||||
the index constants after all. However, `0`-based subscripting is so deep in
|
||||
C++, that we had a fear for confusion.
|
||||
|
||||
* Such constants are easy to add.
|
||||
|
||||
[endsect]
|
||||
|
||||
[section Tuple comparison]
|
||||
|
||||
The comparison operator implements lexicographical order. Other orderings were
|
||||
considered, mainly dominance /(a < b iff for each i a(i) < b(i))/. Our belief
|
||||
is, that lexicographical ordering, though not mathematically the most natural
|
||||
one, is the most frequently needed ordering in everyday programming.
|
||||
|
||||
[endsect]
|
||||
|
||||
[section Streaming]
|
||||
|
||||
The characters specified with tuple stream manipulators are stored within the
|
||||
space allocated by `ios_base::xalloc`, which allocates storage for `long` type
|
||||
objects. `static_cast` is used in casting between `long` and the stream's
|
||||
character type. Streams that have character types not convertible back and
|
||||
forth to long thus fail to compile.
|
||||
|
||||
This may be revisited at some point. The two possible solutions are:
|
||||
|
||||
* Allow only plain `char` types as the tuple delimiters and use `widen` and
|
||||
`narrow` to convert between the real character type of the stream. This
|
||||
would always compile, but some calls to set manipulators might result in a
|
||||
different character than expected (some default character).
|
||||
|
||||
* Allocate enough space to hold the real character type of the stream. This
|
||||
means memory for holding the delimiter characters must be allocated
|
||||
separately, and that pointers to this memory are stored in the space
|
||||
allocated with `ios_base::xalloc`. Any volunteers?
|
||||
|
||||
[endsect]
|
||||
@ -1,159 +0,0 @@
|
||||
[/
|
||||
/ Copyright (c) 2001 Jaakko J<>rvi
|
||||
/
|
||||
/ 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)
|
||||
/]
|
||||
|
||||
[article Tuple library advanced features
|
||||
[quickbook 1.6]
|
||||
[id tuple_advanced_interface]
|
||||
[copyright 2001 Jaakko J\u00E4rvi]
|
||||
[license Distributed under the
|
||||
[@http://boost.org/LICENSE_1_0.txt Boost Software License,
|
||||
Version 1.0].
|
||||
]
|
||||
]
|
||||
|
||||
[template simplesect[title]
|
||||
[block '''<simplesect><title>'''[title]'''</title>''']]
|
||||
|
||||
[template endsimplesect[]
|
||||
[block '''</simplesect>''']]
|
||||
|
||||
The advanced features described in this document are all under namespace
|
||||
`::boost::tuples`
|
||||
|
||||
[section Metafunctions for tuple types]
|
||||
|
||||
Suppose `T` is a tuple type, and `N` is a constant integral expression.
|
||||
|
||||
element<N, T>::type
|
||||
|
||||
gives the type of the `N`-th element in the tuple type `T`. If `T` is `const`,
|
||||
the resulting type is `const` qualified as well. Note that the constness of `T`
|
||||
does not affect reference type elements.
|
||||
|
||||
length<T>::value
|
||||
|
||||
gives the length of the tuple type `T`.
|
||||
|
||||
[endsect]
|
||||
|
||||
[section Cons lists]
|
||||
|
||||
Tuples are internally represented as /cons lists/. For example, the tuple
|
||||
|
||||
tuple<A, B, C, D>
|
||||
|
||||
inherits from the type
|
||||
|
||||
cons<A, cons<B, cons<C, cons<D, null_type> > > >
|
||||
|
||||
The tuple template provides the typedef inherited to access the cons list
|
||||
representation. E.g.: `tuple<A>::inherited` is the type `cons<A, null_type>`.
|
||||
|
||||
[section Empty tuple]
|
||||
|
||||
The internal representation of the empty tuple `tuple<>` is `null_type`.
|
||||
|
||||
[endsect]
|
||||
|
||||
[section Head and tail]
|
||||
|
||||
Both tuple template and the cons templates provide the typedefs `head_type`
|
||||
and `tail_type`. The `head_type` typedef gives the type of the first element
|
||||
of the tuple (or the cons list). The `tail_type` typedef gives the remaining
|
||||
cons list after removing the first element. The head element is stored in the
|
||||
member variable `head` and the tail list in the member variable `tail`. Cons
|
||||
lists provide the member function `get_head()` for getting a reference to the
|
||||
head of a cons list, and `get_tail()` for getting a reference to the tail.
|
||||
There are const and non-const versions of both functions.
|
||||
|
||||
Note that in a one element tuple, `tail_type` equals `null_type` and the
|
||||
`get_tail()` function returns an object of type `null_type`.
|
||||
|
||||
The empty tuple (`null_type`) has no head or tail, hence the `get_head` and
|
||||
`get_tail` functions are not provided.
|
||||
|
||||
Treating tuples as cons lists gives a convenient means to define generic
|
||||
functions to manipulate tuples. For example, the following pair of function
|
||||
templates assign `0` to each element of a tuple (obviously, the assignments
|
||||
must be valid operations for the element types):
|
||||
|
||||
inline void set_to_zero(const null_type&) {};
|
||||
|
||||
template <class H, class T>
|
||||
inline void set_to_zero(cons<H, T>& x) { x.get_head() = 0; set_to_zero(x.get_tail()); }
|
||||
|
||||
[endsect]
|
||||
|
||||
[section Constructing cons lists]
|
||||
|
||||
A cons list can be default constructed provided that all its elements can be
|
||||
default constructed.
|
||||
|
||||
A cons list can be constructed from its head and tail. The prototype of the
|
||||
constructor is:
|
||||
|
||||
cons(typename access_traits<head_type>::parameter_type h, const tail_type& t)
|
||||
|
||||
The traits template for the head parameter selects correct parameter types for
|
||||
different kinds of element types (for reference elements the parameter type
|
||||
equals the element type, for non-reference types the parameter type is a
|
||||
reference to const non-volatile element type).
|
||||
|
||||
For a one-element cons list the tail argument (`null_type`) can be omitted.
|
||||
|
||||
[endsect]
|
||||
|
||||
[endsect]
|
||||
|
||||
[section Traits classes for tuple element types]
|
||||
|
||||
[section access_traits]
|
||||
|
||||
The template `access_traits` defines three type functions. Let `T` be a type
|
||||
of an element in a tuple:
|
||||
|
||||
* `access_traits<T>::non_const_type` maps `T` to the return type of the no
|
||||
n-const access functions (nonmember and member `get` functions, and the
|
||||
`get_head` function).
|
||||
|
||||
* `access_traits<T>::const_type` maps `T` to the return type of the const
|
||||
access functions.
|
||||
|
||||
* `access_traits<T>::parameter_type` maps `T` to the parameter type of the
|
||||
tuple constructor.
|
||||
|
||||
[endsect]
|
||||
|
||||
[section make_tuple_traits]
|
||||
|
||||
The element types of the tuples that are created with the `make_tuple`
|
||||
functions are computed with the type function `make_tuple_traits`. The type
|
||||
function call `make_tuple_traits<T>::type` implements the following type
|
||||
mapping:
|
||||
|
||||
* /any reference type/ -> /compile time error/
|
||||
|
||||
* /any array type/ -> /constant reference to the array type/
|
||||
|
||||
* `reference_wrapper<T>` -> `T&`
|
||||
|
||||
* `T` -> `T`
|
||||
|
||||
Objects of type `reference_wrapper` are created with the `ref` and `cref`
|
||||
functions (see [link tuple.constructing_tuples.make_tuple The `make_tuple`
|
||||
function]).
|
||||
|
||||
Reference wrappers were originally part of the tuple library, but they are now
|
||||
a general utility of boost. The `reference_wrapper` template and the `ref` and
|
||||
`cref` functions are defined in a separate file
|
||||
[@boost:/libs/core/doc/html/core/ref.html `ref.hpp`] in the main boost include
|
||||
directory; and directly in the `boost` namespace.
|
||||
|
||||
[endsect]
|
||||
|
||||
[endsect]
|
||||
@ -1,525 +0,0 @@
|
||||
[/
|
||||
/ Copyright (c) 2001 Jaakko J<>rvi
|
||||
/
|
||||
/ 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)
|
||||
/]
|
||||
|
||||
[library Boost.Tuple
|
||||
[quickbook 1.6]
|
||||
[id tuple]
|
||||
[copyright 2001 Jaakko J\u00E4rvi]
|
||||
[dirname tuple]
|
||||
[license Distributed under the
|
||||
[@http://boost.org/LICENSE_1_0.txt Boost Software License,
|
||||
Version 1.0].
|
||||
]
|
||||
]
|
||||
|
||||
[include tuple_advanced_interface.qbk]
|
||||
[include design_decisions_rationale.qbk]
|
||||
|
||||
[template simplesect[title]
|
||||
[block '''<simplesect><title>'''[title]'''</title>''']]
|
||||
|
||||
[template endsimplesect[]
|
||||
[block '''</simplesect>''']]
|
||||
|
||||
A tuple (or n-tuple) is a fixed size collection of elements. Pairs, triples,
|
||||
quadruples etc. are tuples. In a programming language, a tuple is a data
|
||||
object containing other objects as elements. These element objects may be of
|
||||
different types.
|
||||
|
||||
Tuples are convenient in many circumstances. For instance, tuples make it easy
|
||||
to define functions that return more than one value.
|
||||
|
||||
Some programming languages, such as ML, Python and Haskell, have built-in
|
||||
tuple constructs. Unfortunately C++ does not. To compensate for this
|
||||
"deficiency", the Boost Tuple Library implements a tuple construct using
|
||||
templates.
|
||||
|
||||
[section:using_library Using the Library]
|
||||
|
||||
To use the library, just include:
|
||||
|
||||
#include "boost/tuple/tuple.hpp"
|
||||
|
||||
Comparison operators can be included with:
|
||||
|
||||
#include "boost/tuple/tuple_comparison.hpp"
|
||||
|
||||
To use tuple input and output operators,
|
||||
|
||||
#include "boost/tuple/tuple_io.hpp"
|
||||
|
||||
Both `tuple_io.hpp` and `tuple_comparison.hpp` include `tuple.hpp`.
|
||||
|
||||
All definitions are in namespace `::boost::tuples`, but the most common names
|
||||
are lifted to namespace `::boost` with using declarations. These names are:
|
||||
`tuple`, `make_tuple`, `tie` and `get`. Further, `ref` and `cref` are defined
|
||||
directly under the `::boost` namespace.
|
||||
|
||||
[endsect]
|
||||
|
||||
[section:tuple_types Tuple Types]
|
||||
|
||||
A tuple type is an instantiation of the `tuple` template. The template
|
||||
parameters specify the types of the tuple elements. The current version
|
||||
supports tuples with 0-10 elements. If necessary, the upper limit can be
|
||||
increased up to, say, a few dozen elements. The data element can be any C++
|
||||
type. Note that `void` and plain function types are valid C++ types, but
|
||||
objects of such types cannot exist. Hence, if a tuple type contains such types
|
||||
as elements, the tuple type can exist, but not an object of that type. There
|
||||
are natural limitations for element types that cannot be copied, or that are
|
||||
not default constructible (see [link tuple.constructing_tuples 'Constructing tuples']
|
||||
below).
|
||||
|
||||
For example, the following definitions are valid tuple instantiations (`A`,
|
||||
`B` and `C` are some user defined classes):
|
||||
|
||||
tuple<int>
|
||||
tuple<double&, const double&, const double, double*, const double*>
|
||||
tuple<A, int(*)(char, int), B(A::*)(C&), C>
|
||||
tuple<std::string, std::pair<A, B> >
|
||||
tuple<A*, tuple<const A*, const B&, C>, bool, void*>
|
||||
|
||||
[endsect]
|
||||
|
||||
[section:constructing_tuples Constructing Tuples]
|
||||
|
||||
The tuple constructor takes the tuple elements as arguments. For an /n/-
|
||||
element tuple, the constructor can be invoked with /k/ arguments, where
|
||||
`0` <= /k/ <= /n/. For example:
|
||||
|
||||
tuple<int, double>()
|
||||
tuple<int, double>(1)
|
||||
tuple<int, double>(1, 3.14)
|
||||
|
||||
If no initial value for an element is provided, it is default initialized
|
||||
(and hence must be default initializable). For example:
|
||||
|
||||
class X {
|
||||
X();
|
||||
public:
|
||||
X(std::string);
|
||||
};
|
||||
|
||||
tuple<X,X,X>() // error: no default constructor for X
|
||||
tuple<X,X,X>(string("Jaba"), string("Daba"), string("Duu")) // ok
|
||||
|
||||
In particular, reference types do not have a default initialization:
|
||||
|
||||
tuple<double&>() // error: reference must be
|
||||
// initialized explicitly
|
||||
|
||||
double d = 5;
|
||||
tuple<double&>(d) // ok
|
||||
|
||||
tuple<double&>(d+3.14) // error: cannot initialize
|
||||
// non-const reference with a temporary
|
||||
|
||||
tuple<const double&>(d+3.14) // ok, but dangerous:
|
||||
// the element becomes a dangling reference
|
||||
|
||||
Using an initial value for an element that cannot be copied, is a compile time
|
||||
error:
|
||||
|
||||
class Y {
|
||||
Y(const Y&);
|
||||
public:
|
||||
Y();
|
||||
};
|
||||
|
||||
char a[10];
|
||||
|
||||
tuple<char[10], Y>(a, Y()); // error, neither arrays nor Y can be copied
|
||||
tuple<char[10], Y>(); // ok
|
||||
|
||||
Note particularly that the following is perfectly ok:
|
||||
|
||||
Y y;
|
||||
tuple<char(&)[10], Y&>(a, y);
|
||||
|
||||
It is possible to come up with a tuple type that cannot be constructed. This
|
||||
occurs if an element that cannot be initialized has a lower index than an
|
||||
element that requires initialization. For example: `tuple<char[10], int&>`.
|
||||
|
||||
In sum, the tuple construction is semantically just a group of individual
|
||||
elementary constructions.
|
||||
|
||||
[section:make_tuple The `make_tuple` function]
|
||||
|
||||
Tuples can also be constructed using the `make_tuple` (cf. `std::make_pair`)
|
||||
helper functions. This makes the construction more convenient, saving the
|
||||
programmer from explicitly specifying the element types:
|
||||
|
||||
tuple<int, int, double> add_multiply_divide(int a, int b) {
|
||||
return make_tuple(a+b, a*b, double(a)/double(b));
|
||||
}
|
||||
|
||||
By default, the element types are deduced to the plain non-reference types.
|
||||
E.g.:
|
||||
|
||||
void foo(const A& a, B& b) {
|
||||
...
|
||||
make_tuple(a, b);
|
||||
|
||||
The `make_tuple` invocation results in a tuple of type `tuple<A, B>`.
|
||||
|
||||
Sometimes the plain non-reference type is not desired, e.g. if the element
|
||||
type cannot be copied. Therefore, the programmer can control the type
|
||||
deduction and state that a reference to const or reference to non-const type
|
||||
should be used as the element type instead. This is accomplished with two
|
||||
helper template functions: [@boost:/libs/core/doc/html/core/ref.html `boost::ref`]
|
||||
and [@boost:/libs/core/doc/html/core/ref.html `boost::cref`]. Any argument can
|
||||
be wrapped with these functions to get the desired type. The mechanism does
|
||||
not compromise const correctness since a const object wrapped with ref results
|
||||
in a tuple element with const reference type (see the fifth example below).
|
||||
For example:
|
||||
|
||||
A a; B b; const A ca = a;
|
||||
make_tuple(cref(a), b); // creates tuple<const A&, B>
|
||||
make_tuple(ref(a), b); // creates tuple<A&, B>
|
||||
make_tuple(ref(a), cref(b)); // creates tuple<A&, const B&>
|
||||
make_tuple(cref(ca)); // creates tuple<const A&>
|
||||
make_tuple(ref(ca)); // creates tuple<const A&>
|
||||
|
||||
Array arguments to `make_tuple` functions are deduced to reference to const
|
||||
types by default; there is no need to wrap them with `cref`. For example:
|
||||
|
||||
make_tuple("Donald", "Daisy");
|
||||
|
||||
This creates an object of type `tuple<const char (&)[7], const char (&)[6]>`
|
||||
(note that the type of a string literal is an array of const characters, not
|
||||
`const char*`). However, to get `make_tuple` to create a tuple with an element
|
||||
of a non-const array type one must use the `ref` wrapper.
|
||||
|
||||
Function pointers are deduced to the plain non-reference type, that is, to
|
||||
plain function pointer. A tuple can also hold a reference to a function, but
|
||||
such a tuple cannot be constructed with `make_tuple` (a const qualified
|
||||
function type would result, which is illegal):
|
||||
|
||||
void f(int i);
|
||||
...
|
||||
make_tuple(&f); // tuple<void (*)(int)>
|
||||
...
|
||||
tuple<tuple<void (&)(int)> > a(f) // ok
|
||||
make_tuple(f); // not ok
|
||||
|
||||
[endsect]
|
||||
|
||||
[endsect]
|
||||
|
||||
[section:accessing_elements Accessing Tuple Elements]
|
||||
|
||||
Tuple elements are accessed with the expression:
|
||||
|
||||
t.get<N>()
|
||||
|
||||
or
|
||||
|
||||
get<N>(t)
|
||||
|
||||
where `t` is a tuple object and `N` is a constant integral expression
|
||||
specifying the index of the element to be accessed. Depending on whether `t`
|
||||
is const or not, `get` returns the `N`-th element as a reference to const or
|
||||
non-const type. The index of the first element is `0` and thus `N` must be
|
||||
between `0` and /k/`-1`, where /k/ is the number of elements in the tuple.
|
||||
Violations of these constraints are detected at compile time. Examples:
|
||||
|
||||
double d = 2.7; A a;
|
||||
tuple<int, double&, const A&> t(1, d, a);
|
||||
const tuple<int, double&, const A&> ct = t;
|
||||
...
|
||||
int i = get<0>(t); i = t.get<0>(); // ok
|
||||
int j = get<0>(ct); // ok
|
||||
get<0>(t) = 5; // ok
|
||||
get<0>(ct) = 5; // error, can't assign to const
|
||||
...
|
||||
double e = get<1>(t); // ok
|
||||
get<1>(t) = 3.14; // ok
|
||||
get<2>(t) = A(); // error, can't assign to const
|
||||
A aa = get<3>(t); // error: index out of bounds
|
||||
...
|
||||
++get<0>(t); // ok, can be used as any variable
|
||||
|
||||
/[Note:/ The member `get` functions are not supported with MS Visual C++
|
||||
compiler. Further, the compiler has trouble with finding the non-member `get`
|
||||
functions without an explicit namespace qualifier. Hence, all `get` calls
|
||||
should be qualified as `tuples::get<N>(a_tuple)` when writing code that should
|
||||
compile with MSVC++ 6.0./]/
|
||||
|
||||
[endsect]
|
||||
|
||||
[section:construction_and_assignment Copy Construction and Tuple Assignment]
|
||||
|
||||
A tuple can be copy constructed from another tuple, provided that the element
|
||||
types are element-wise copy constructible. Analogously, a tuple can be
|
||||
assigned to another tuple, provided that the element types are element-wise
|
||||
assignable. For example:
|
||||
|
||||
class A {};
|
||||
class B : public A {};
|
||||
struct C { C(); C(const B&); };
|
||||
struct D { operator C() const; };
|
||||
tuple<char, B*, B, D> t;
|
||||
...
|
||||
tuple<int, A*, C, C> a(t); // ok
|
||||
a = t; // ok
|
||||
|
||||
In both cases, the conversions performed are:
|
||||
|
||||
* `char -> int`,
|
||||
* `B* -> A*` (derived class pointer to base class pointer),
|
||||
* `B -> C` (a user defined conversion), and
|
||||
* `D -> C` (a user defined conversion).
|
||||
|
||||
Note that assignment is also defined from `std::pair` types:
|
||||
|
||||
tuple<float, int> a = std::make_pair(1, 'a');
|
||||
|
||||
[endsect]
|
||||
|
||||
[section:relational_operators Relational Operators]
|
||||
|
||||
Tuples reduce the operators `==`, `!=`, `<`, `>`, `<=` and `>=` to the
|
||||
corresponding elementary operators. This means, that if any of these operators
|
||||
is defined between all elements of two tuples, then the same operator is
|
||||
defined between the tuples as well. The equality operators for two tuples `a`
|
||||
and `b` are defined as:
|
||||
|
||||
* `a == b` iff for each `i`: `a`'''<subscript>i</subscript>'''` == b`'''<subscript>i</subscript>'''
|
||||
* `a != b` iff exists `i`: `a`'''<subscript>i</subscript>'''` != b`'''<subscript>i</subscript>'''
|
||||
|
||||
The operators `<`, `>`, `<=` and `>=` implement a lexicographical ordering.
|
||||
|
||||
Note that an attempt to compare two tuples of different lengths results in a
|
||||
compile time error. Also, the comparison operators are /"short-circuited"/:
|
||||
elementary comparisons start from the first elements and are performed only
|
||||
until the result is clear.
|
||||
|
||||
Examples:
|
||||
|
||||
tuple<std::string, int, A> t1(std::string("same?"), 2, A());
|
||||
tuple<std::string, long, A> t2(std::string("same?"), 2, A());
|
||||
tuple<std::string, long, A> t3(std::string("different"), 3, A());
|
||||
|
||||
bool operator==(A, A) { std::cout << "All the same to me..."; return true; }
|
||||
|
||||
t1 == t2; // true
|
||||
t1 == t3; // false, does not print "All the..."
|
||||
|
||||
[endsect]
|
||||
|
||||
[section:tiers Tiers]
|
||||
|
||||
/Tiers/ are tuples, where all elements are of non-const reference types. They
|
||||
are constructed with a call to the `tie` function template (cf. `make_tuple`):
|
||||
|
||||
int i; char c; double d;
|
||||
...
|
||||
tie(i, c, a);
|
||||
|
||||
The above `tie` function creates a tuple of type `tuple<int&, char&, double&>`.
|
||||
The same result could be achieved with the call `make_tuple(ref(i), ref(c), ref(a))`.
|
||||
|
||||
A tuple that contains non-const references as elements can be used to 'unpack'
|
||||
another tuple into variables. E.g.:
|
||||
|
||||
int i; char c; double d;
|
||||
tie(i, c, d) = make_tuple(1,'a', 5.5);
|
||||
std::cout << i << " " << c << " " << d;
|
||||
|
||||
This code prints `1 a 5.5` to the standard output stream. A tuple unpacking
|
||||
operation like this is found for example in ML and Python. It is convenient
|
||||
when calling functions which return tuples.
|
||||
|
||||
The tying mechanism works with `std::pair` templates as well:
|
||||
|
||||
int i; char c;
|
||||
tie(i, c) = std::make_pair(1, 'a');
|
||||
|
||||
[section Ignore]
|
||||
|
||||
There is also an object called `ignore` which allows you to ignore an element
|
||||
assigned by a tuple. The idea is that a function may return a tuple, only part
|
||||
of which you are interested in. For example (note, that ignore is under the
|
||||
`tuples` subnamespace):
|
||||
|
||||
char c;
|
||||
tie(tuples::ignore, c) = std::make_pair(1, 'a');
|
||||
|
||||
[endsect]
|
||||
|
||||
[endsect]
|
||||
|
||||
[section:streaming Streaming]
|
||||
|
||||
The global `operator<<` has been overloaded for `std::ostream` such that
|
||||
tuples are output by recursively calling `operator<<` for each element.
|
||||
|
||||
Analogously, the global `operator>>` has been overloaded to extract tuples
|
||||
from `std::istream` by recursively calling `operator>>` for each element.
|
||||
|
||||
The default delimiter between the elements is space, and the tuple is enclosed
|
||||
in parenthesis. For Example:
|
||||
|
||||
tuple<float, int, std::string> a(1.0f, 2, std::string("Howdy folks!");
|
||||
|
||||
cout << a;
|
||||
|
||||
outputs the tuple as: `(1.0 2 Howdy folks!)`
|
||||
|
||||
The library defines three manipulators for changing the default behavior:
|
||||
|
||||
* `set_open(char)` defines the character that is output before the first element.
|
||||
* `set_close(char)` defines the character that is output after the last element.
|
||||
* `set_delimiter(char)` defines the delimiter character between elements.
|
||||
|
||||
Note, that these manipulators are defined in the tuples subnamespace. For
|
||||
example:
|
||||
|
||||
cout << tuples::set_open('[') << tuples::set_close(']') << tuples::set_delimiter(',') << a;
|
||||
|
||||
outputs the same tuple `a` as: `[1.0,2,Howdy folks!]`
|
||||
|
||||
The same manipulators work with `operator>>` and `istream` as well. Suppose
|
||||
the `cin` stream contains the following data:
|
||||
|
||||
(1 2 3) [4:5]
|
||||
|
||||
The code:
|
||||
|
||||
tuple<int, int, int> i;
|
||||
tuple<int, int> j;
|
||||
|
||||
cin >> i;
|
||||
cin >> tuples::set_open('[') >> tuples::set_close(']') >> tuples::set_delimiter(':');
|
||||
cin >> j;
|
||||
|
||||
reads the data into the tuples `i` and `j`.
|
||||
|
||||
Note that extracting tuples with `std::string` or C-style string elements does
|
||||
not generally work, since the streamed tuple representation may not be
|
||||
unambiguously parseable.
|
||||
|
||||
[endsect]
|
||||
|
||||
[section:performance Performance]
|
||||
|
||||
All tuple access and construction functions are small inlined one-liners.
|
||||
Therefore, a decent compiler can eliminate any extra cost of using tuples
|
||||
compared to using hand-written tuple like classes. Particularly, with a decent
|
||||
compiler there is no performance difference between this code:
|
||||
|
||||
class hand_made_tuple {
|
||||
A a; B b; C c;
|
||||
public:
|
||||
hand_made_tuple(const A& aa, const B& bb, const C& cc)
|
||||
: a(aa), b(bb), c(cc) {};
|
||||
A& getA() { return a; };
|
||||
B& getB() { return b; };
|
||||
C& getC() { return c; };
|
||||
};
|
||||
|
||||
hand_made_tuple hmt(A(), B(), C());
|
||||
hmt.getA(); hmt.getB(); hmt.getC();
|
||||
|
||||
and this code:
|
||||
|
||||
tuple<A, B, C> t(A(), B(), C());
|
||||
t.get<0>(); t.get<1>(); t.get<2>();
|
||||
|
||||
Note, that there are widely used compilers (e.g. bcc 5.5.1) which fail to
|
||||
optimize this kind of tuple usage.
|
||||
|
||||
Depending on the optimizing ability of the compiler, the tier mechanism may
|
||||
have a small performance penalty compared to using non-const reference
|
||||
parameters as a mechanism for returning multiple values from a function. For
|
||||
example, suppose that the following functions `f1` and `f2` have equivalent
|
||||
functionalities:
|
||||
|
||||
void f1(int&, double&);
|
||||
tuple<int, double> f2();
|
||||
|
||||
Then, the call #1 may be slightly faster than #2 in the code below:
|
||||
|
||||
int i; double d;
|
||||
...
|
||||
f1(i,d); // #1
|
||||
tie(i,d) = f2(); // #2
|
||||
|
||||
See [[link publ_1 1], [link publ_2 2]] for more in-depth discussions about
|
||||
efficiency.
|
||||
|
||||
[section Effect on Compile Time]
|
||||
|
||||
Compiling tuples can be slow due to the excessive amount of template
|
||||
instantiations. Depending on the compiler and the tuple length, it may be more
|
||||
than 10 times slower to compile a tuple construct, compared to compiling an
|
||||
equivalent explicitly written class, such as the `hand_made_tuple` class above.
|
||||
However, as a realistic program is likely to contain a lot of code in addition
|
||||
to tuple definitions, the difference is probably unnoticeable. Compile time
|
||||
increases between 5 and 10 percent were measured for programs which used tuples
|
||||
very frequently. With the same test programs, memory consumption of compiling
|
||||
increased between 22% to 27%. See [[link publ_1 1], [link publ_2 2]] for
|
||||
details.
|
||||
|
||||
[endsect]
|
||||
|
||||
[endsect]
|
||||
|
||||
[section:portability Portability]
|
||||
|
||||
The library code is(?) standard C++ and thus the library works with a standard
|
||||
conforming compiler. Below is a list of compilers and known problems with each
|
||||
compiler:
|
||||
|
||||
[table
|
||||
[[Compiler] [Problems]]
|
||||
[[gcc 2.95] [-]]
|
||||
[[edg 2.44] [-]]
|
||||
[[Borland 5.5] [Can't use function pointers or member pointers as
|
||||
tuple elements]]
|
||||
[[Metrowerks 6.2] [Can't use `ref` and `cref` wrappers]]
|
||||
[[MS Visual C++] [No reference elements (`tie` still works). Can't use
|
||||
`ref` and `cref` wrappers]]
|
||||
]
|
||||
|
||||
[endsect]
|
||||
|
||||
[section:more_details More Details]
|
||||
|
||||
[link tuple_advanced_interface Advanced features] (describes some metafunctions etc.).
|
||||
|
||||
[link design_decisions_rationale Rationale behind some design/implementation decisions].
|
||||
|
||||
[endsect]
|
||||
|
||||
[section:thanks Acknowledgements]
|
||||
|
||||
Gary Powell has been an indispensable helping hand. In particular, stream
|
||||
manipulators for tuples were his idea. Doug Gregor came up with a working
|
||||
version for MSVC, David Abrahams found a way to get rid of most of the
|
||||
restrictions for compilers not supporting partial specialization. Thanks to
|
||||
Jeremy Siek, William Kempf and Jens Maurer for their help and suggestions. The
|
||||
comments by Vesa Karvonen, John Max Skaller, Ed Brey, Beman Dawes, David
|
||||
Abrahams and Hartmut Kaiser helped to improve the library. The idea for the
|
||||
`tie` mechanism came from an old usenet article by Ian McCulloch, where he
|
||||
proposed something similar for `std::pair`s.
|
||||
|
||||
[endsect]
|
||||
|
||||
[section:references References]
|
||||
|
||||
[#publ_1]
|
||||
[1] J\u00E4rvi J.: /Tuples and multiple return values in C++/, TUCS Technical Report No 249, 1999.
|
||||
|
||||
[#publ_2]
|
||||
[2] J\u00E4rvi J.: /ML-Style Tuple Assignment in Standard C++ - Extending the Multiple Return Value Formalism/, TUCS Technical Report No 267, 1999.
|
||||
|
||||
[#publ_3]
|
||||
[3] J\u00E4rvi J.: /Tuple Types and Multiple Return Values/, C/C++ Users Journal, August 2001.
|
||||
|
||||
[endsect]
|
||||
File diff suppressed because it is too large
Load Diff
@ -1,118 +0,0 @@
|
||||
// tuple.hpp - Boost Tuple Library --------------------------------------
|
||||
|
||||
// Copyright (C) 1999, 2000 Jaakko Jarvi (jaakko.jarvi@cs.utu.fi)
|
||||
//
|
||||
// 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)
|
||||
|
||||
// For more information, see http://www.boost.org
|
||||
|
||||
// -----------------------------------------------------------------
|
||||
|
||||
#ifndef BOOST_TUPLE_HPP
|
||||
#define BOOST_TUPLE_HPP
|
||||
|
||||
#if defined(__sgi) && defined(_COMPILER_VERSION) && _COMPILER_VERSION <= 730
|
||||
// Work around a compiler bug.
|
||||
// boost::python::tuple has to be seen by the compiler before the
|
||||
// boost::tuple class template.
|
||||
namespace boost { namespace python { class tuple; }}
|
||||
#endif
|
||||
|
||||
#include <boost/config.hpp>
|
||||
#include <boost/static_assert.hpp>
|
||||
|
||||
// other compilers
|
||||
#include <boost/ref.hpp>
|
||||
#include <boost/tuple/detail/tuple_basic.hpp>
|
||||
|
||||
|
||||
namespace boost {
|
||||
|
||||
using tuples::tuple;
|
||||
using tuples::make_tuple;
|
||||
using tuples::tie;
|
||||
#if !defined(BOOST_NO_USING_TEMPLATE)
|
||||
using tuples::get;
|
||||
#else
|
||||
//
|
||||
// The "using tuples::get" statement causes the
|
||||
// Borland compiler to ICE, use forwarding
|
||||
// functions instead:
|
||||
//
|
||||
template<int N, class HT, class TT>
|
||||
inline typename tuples::access_traits<
|
||||
typename tuples::element<N, tuples::cons<HT, TT> >::type
|
||||
>::non_const_type
|
||||
get(tuples::cons<HT, TT>& c) {
|
||||
return tuples::get<N,HT,TT>(c);
|
||||
}
|
||||
// get function for const cons-lists, returns a const reference to
|
||||
// the element. If the element is a reference, returns the reference
|
||||
// as such (that is, can return a non-const reference)
|
||||
template<int N, class HT, class TT>
|
||||
inline typename tuples::access_traits<
|
||||
typename tuples::element<N, tuples::cons<HT, TT> >::type
|
||||
>::const_type
|
||||
get(const tuples::cons<HT, TT>& c) {
|
||||
return tuples::get<N,HT,TT>(c);
|
||||
}
|
||||
|
||||
#endif // BOOST_NO_USING_TEMPLATE
|
||||
|
||||
} // end namespace boost
|
||||
|
||||
#if !defined(BOOST_NO_CXX11_HDR_TUPLE)
|
||||
|
||||
#include <tuple>
|
||||
#include <cstddef>
|
||||
|
||||
namespace std
|
||||
{
|
||||
|
||||
#if defined(BOOST_CLANG)
|
||||
# pragma clang diagnostic push
|
||||
# pragma clang diagnostic ignored "-Wmismatched-tags"
|
||||
#endif
|
||||
|
||||
// std::tuple_size
|
||||
|
||||
template<class T1, class T2, class T3, class T4, class T5, class T6, class T7, class T8, class T9, class T10>
|
||||
class tuple_size< boost::tuples::tuple<T1, T2, T3, T4, T5, T6, T7, T8, T9, T10> >:
|
||||
public boost::tuples::length< boost::tuples::tuple<T1, T2, T3, T4, T5, T6, T7, T8, T9, T10> >
|
||||
{
|
||||
};
|
||||
|
||||
template<class H, class T> class tuple_size< boost::tuples::cons<H, T> >:
|
||||
public boost::tuples::length< boost::tuples::cons<H, T> >
|
||||
{
|
||||
};
|
||||
|
||||
template<> class tuple_size< boost::tuples::null_type >:
|
||||
public boost::tuples::length< boost::tuples::null_type >
|
||||
{
|
||||
};
|
||||
|
||||
// std::tuple_element
|
||||
|
||||
template<std::size_t I, class T1, class T2, class T3, class T4, class T5, class T6, class T7, class T8, class T9, class T10>
|
||||
class tuple_element< I, boost::tuples::tuple<T1, T2, T3, T4, T5, T6, T7, T8, T9, T10> >:
|
||||
public boost::tuples::element< I, boost::tuples::tuple<T1, T2, T3, T4, T5, T6, T7, T8, T9, T10> >
|
||||
{
|
||||
};
|
||||
|
||||
template<std::size_t I, class H, class T> class tuple_element< I, boost::tuples::cons<H, T> >:
|
||||
public boost::tuples::element< I, boost::tuples::cons<H, T> >
|
||||
{
|
||||
};
|
||||
|
||||
#if defined(BOOST_CLANG)
|
||||
# pragma clang diagnostic pop
|
||||
#endif
|
||||
|
||||
} // namespace std
|
||||
|
||||
#endif // !defined(BOOST_NO_CXX11_HDR_TUPLE)
|
||||
|
||||
#endif // BOOST_TUPLE_HPP
|
||||
@ -1,175 +0,0 @@
|
||||
// tuple_comparison.hpp -----------------------------------------------------
|
||||
//
|
||||
// Copyright (C) 2001 Jaakko Jarvi (jaakko.jarvi@cs.utu.fi)
|
||||
// Copyright (C) 2001 Gary Powell (gary.powell@sierra.com)
|
||||
//
|
||||
// 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)
|
||||
//
|
||||
// For more information, see http://www.boost.org
|
||||
//
|
||||
// (The idea and first impl. of comparison operators was from Doug Gregor)
|
||||
|
||||
// -----------------------------------------------------------------
|
||||
|
||||
#ifndef BOOST_TUPLE_COMPARISON_HPP
|
||||
#define BOOST_TUPLE_COMPARISON_HPP
|
||||
|
||||
#include <boost/tuple/tuple.hpp>
|
||||
|
||||
// -------------------------------------------------------------
|
||||
// equality and comparison operators
|
||||
//
|
||||
// == and != compare tuples elementwise
|
||||
// <, >, <= and >= use lexicographical ordering
|
||||
//
|
||||
// Any operator between tuples of different length fails at compile time
|
||||
// No dependencies between operators are assumed
|
||||
// (i.e. !(a<b) does not imply a>=b, a!=b does not imply a==b etc.
|
||||
// so any weirdnesses of elementary operators are respected).
|
||||
//
|
||||
// -------------------------------------------------------------
|
||||
|
||||
|
||||
namespace boost {
|
||||
namespace tuples {
|
||||
|
||||
inline bool operator==(const null_type&, const null_type&) { return true; }
|
||||
inline bool operator>=(const null_type&, const null_type&) { return true; }
|
||||
inline bool operator<=(const null_type&, const null_type&) { return true; }
|
||||
inline bool operator!=(const null_type&, const null_type&) { return false; }
|
||||
inline bool operator<(const null_type&, const null_type&) { return false; }
|
||||
inline bool operator>(const null_type&, const null_type&) { return false; }
|
||||
|
||||
|
||||
namespace detail {
|
||||
// comparison operators check statically the length of its operands and
|
||||
// delegate the comparing task to the following functions. Hence
|
||||
// the static check is only made once (should help the compiler).
|
||||
// These functions assume tuples to be of the same length.
|
||||
|
||||
|
||||
template<class T1, class T2>
|
||||
inline bool eq(const T1& lhs, const T2& rhs) {
|
||||
return lhs.get_head() == rhs.get_head() &&
|
||||
eq(lhs.get_tail(), rhs.get_tail());
|
||||
}
|
||||
template<>
|
||||
inline bool eq<null_type,null_type>(const null_type&, const null_type&) { return true; }
|
||||
|
||||
template<class T1, class T2>
|
||||
inline bool neq(const T1& lhs, const T2& rhs) {
|
||||
return lhs.get_head() != rhs.get_head() ||
|
||||
neq(lhs.get_tail(), rhs.get_tail());
|
||||
}
|
||||
template<>
|
||||
inline bool neq<null_type,null_type>(const null_type&, const null_type&) { return false; }
|
||||
|
||||
template<class T1, class T2>
|
||||
inline bool lt(const T1& lhs, const T2& rhs) {
|
||||
return lhs.get_head() < rhs.get_head() ||
|
||||
( !(rhs.get_head() < lhs.get_head()) &&
|
||||
lt(lhs.get_tail(), rhs.get_tail()));
|
||||
}
|
||||
template<>
|
||||
inline bool lt<null_type,null_type>(const null_type&, const null_type&) { return false; }
|
||||
|
||||
template<class T1, class T2>
|
||||
inline bool gt(const T1& lhs, const T2& rhs) {
|
||||
return lhs.get_head() > rhs.get_head() ||
|
||||
( !(rhs.get_head() > lhs.get_head()) &&
|
||||
gt(lhs.get_tail(), rhs.get_tail()));
|
||||
}
|
||||
template<>
|
||||
inline bool gt<null_type,null_type>(const null_type&, const null_type&) { return false; }
|
||||
|
||||
template<class T1, class T2>
|
||||
inline bool lte(const T1& lhs, const T2& rhs) {
|
||||
return lhs.get_head() <= rhs.get_head() &&
|
||||
( !(rhs.get_head() <= lhs.get_head()) ||
|
||||
lte(lhs.get_tail(), rhs.get_tail()));
|
||||
}
|
||||
template<>
|
||||
inline bool lte<null_type,null_type>(const null_type&, const null_type&) { return true; }
|
||||
|
||||
template<class T1, class T2>
|
||||
inline bool gte(const T1& lhs, const T2& rhs) {
|
||||
return lhs.get_head() >= rhs.get_head() &&
|
||||
( !(rhs.get_head() >= lhs.get_head()) ||
|
||||
gte(lhs.get_tail(), rhs.get_tail()));
|
||||
}
|
||||
template<>
|
||||
inline bool gte<null_type,null_type>(const null_type&, const null_type&) { return true; }
|
||||
|
||||
} // end of namespace detail
|
||||
|
||||
|
||||
// equal ----
|
||||
|
||||
template<class T1, class T2, class S1, class S2>
|
||||
inline bool operator==(const cons<T1, T2>& lhs, const cons<S1, S2>& rhs)
|
||||
{
|
||||
// check that tuple lengths are equal
|
||||
BOOST_STATIC_ASSERT(length<T2>::value == length<S2>::value);
|
||||
|
||||
return detail::eq(lhs, rhs);
|
||||
}
|
||||
|
||||
// not equal -----
|
||||
|
||||
template<class T1, class T2, class S1, class S2>
|
||||
inline bool operator!=(const cons<T1, T2>& lhs, const cons<S1, S2>& rhs)
|
||||
{
|
||||
|
||||
// check that tuple lengths are equal
|
||||
BOOST_STATIC_ASSERT(length<T2>::value == length<S2>::value);
|
||||
|
||||
return detail::neq(lhs, rhs);
|
||||
}
|
||||
|
||||
// <
|
||||
template<class T1, class T2, class S1, class S2>
|
||||
inline bool operator<(const cons<T1, T2>& lhs, const cons<S1, S2>& rhs)
|
||||
{
|
||||
// check that tuple lengths are equal
|
||||
BOOST_STATIC_ASSERT(length<T2>::value == length<S2>::value);
|
||||
|
||||
return detail::lt(lhs, rhs);
|
||||
}
|
||||
|
||||
// >
|
||||
template<class T1, class T2, class S1, class S2>
|
||||
inline bool operator>(const cons<T1, T2>& lhs, const cons<S1, S2>& rhs)
|
||||
{
|
||||
// check that tuple lengths are equal
|
||||
BOOST_STATIC_ASSERT(length<T2>::value == length<S2>::value);
|
||||
|
||||
return detail::gt(lhs, rhs);
|
||||
}
|
||||
|
||||
// <=
|
||||
template<class T1, class T2, class S1, class S2>
|
||||
inline bool operator<=(const cons<T1, T2>& lhs, const cons<S1, S2>& rhs)
|
||||
{
|
||||
// check that tuple lengths are equal
|
||||
BOOST_STATIC_ASSERT(length<T2>::value == length<S2>::value);
|
||||
|
||||
return detail::lte(lhs, rhs);
|
||||
}
|
||||
|
||||
// >=
|
||||
template<class T1, class T2, class S1, class S2>
|
||||
inline bool operator>=(const cons<T1, T2>& lhs, const cons<S1, S2>& rhs)
|
||||
{
|
||||
// check that tuple lengths are equal
|
||||
BOOST_STATIC_ASSERT(length<T2>::value == length<S2>::value);
|
||||
|
||||
return detail::gte(lhs, rhs);
|
||||
}
|
||||
|
||||
} // end of namespace tuples
|
||||
} // end of namespace boost
|
||||
|
||||
|
||||
#endif // BOOST_TUPLE_COMPARISON_HPP
|
||||
@ -1,339 +0,0 @@
|
||||
// tuple_io.hpp --------------------------------------------------------------
|
||||
|
||||
// Copyright (C) 2001 Jaakko Jarvi (jaakko.jarvi@cs.utu.fi)
|
||||
// 2001 Gary Powell (gary.powell@sierra.com)
|
||||
//
|
||||
// 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)
|
||||
// For more information, see http://www.boost.org
|
||||
|
||||
// ----------------------------------------------------------------------------
|
||||
|
||||
#ifndef BOOST_TUPLE_IO_HPP
|
||||
#define BOOST_TUPLE_IO_HPP
|
||||
|
||||
#include <istream>
|
||||
#include <ostream>
|
||||
|
||||
#include <sstream>
|
||||
|
||||
#include <boost/tuple/tuple.hpp>
|
||||
|
||||
// This is ugly: one should be using twoargument isspace since whitspace can
|
||||
// be locale dependent, in theory at least.
|
||||
// not all libraries implement have the two-arg version, so we need to
|
||||
// use the one-arg one, which one should get with <cctype> but there seem
|
||||
// to be exceptions to this.
|
||||
|
||||
#if !defined (BOOST_NO_STD_LOCALE)
|
||||
|
||||
#include <locale> // for two-arg isspace
|
||||
|
||||
#else
|
||||
|
||||
#include <cctype> // for one-arg (old) isspace
|
||||
#include <ctype.h> // Metrowerks does not find one-arg isspace from cctype
|
||||
|
||||
#endif
|
||||
|
||||
namespace boost {
|
||||
namespace tuples {
|
||||
|
||||
namespace detail {
|
||||
|
||||
class format_info {
|
||||
public:
|
||||
|
||||
enum manipulator_type { open, close, delimiter };
|
||||
BOOST_STATIC_CONSTANT(int, number_of_manipulators = delimiter + 1);
|
||||
private:
|
||||
|
||||
static int get_stream_index (int m)
|
||||
{
|
||||
static const int stream_index[number_of_manipulators]
|
||||
= { std::ios::xalloc(), std::ios::xalloc(), std::ios::xalloc() };
|
||||
|
||||
return stream_index[m];
|
||||
}
|
||||
|
||||
format_info(const format_info&);
|
||||
format_info();
|
||||
|
||||
|
||||
public:
|
||||
|
||||
template<class CharType, class CharTrait>
|
||||
static CharType get_manipulator(std::basic_ios<CharType, CharTrait>& i,
|
||||
manipulator_type m) {
|
||||
// The manipulators are stored as long.
|
||||
// A valid instanitation of basic_stream allows CharType to be any POD,
|
||||
// hence, the static_cast may fail (it fails if long is not convertible
|
||||
// to CharType
|
||||
CharType c = static_cast<CharType>(i.iword(get_stream_index(m)) );
|
||||
// parentheses and space are the default manipulators
|
||||
if (!c) {
|
||||
switch(m) {
|
||||
case detail::format_info::open : c = i.widen('('); break;
|
||||
case detail::format_info::close : c = i.widen(')'); break;
|
||||
case detail::format_info::delimiter : c = i.widen(' '); break;
|
||||
}
|
||||
}
|
||||
return c;
|
||||
}
|
||||
|
||||
|
||||
template<class CharType, class CharTrait>
|
||||
static void set_manipulator(std::basic_ios<CharType, CharTrait>& i,
|
||||
manipulator_type m, CharType c) {
|
||||
// The manipulators are stored as long.
|
||||
// A valid instanitation of basic_stream allows CharType to be any POD,
|
||||
// hence, the static_cast may fail (it fails if CharType is not
|
||||
// convertible long.
|
||||
i.iword(get_stream_index(m)) = static_cast<long>(c);
|
||||
}
|
||||
};
|
||||
|
||||
} // end of namespace detail
|
||||
|
||||
template<class CharType>
|
||||
class tuple_manipulator {
|
||||
const detail::format_info::manipulator_type mt;
|
||||
CharType f_c;
|
||||
public:
|
||||
explicit tuple_manipulator(detail::format_info::manipulator_type m,
|
||||
CharType c = CharType())
|
||||
: mt(m), f_c(c) {}
|
||||
|
||||
template<class CharTrait>
|
||||
void set(std::basic_ios<CharType, CharTrait> &io) const {
|
||||
detail::format_info::set_manipulator(io, mt, f_c);
|
||||
}
|
||||
};
|
||||
|
||||
|
||||
template<class CharType, class CharTrait>
|
||||
inline std::basic_ostream<CharType, CharTrait>&
|
||||
operator<<(std::basic_ostream<CharType, CharTrait>& o, const tuple_manipulator<CharType>& m) {
|
||||
m.set(o);
|
||||
return o;
|
||||
}
|
||||
|
||||
template<class CharType, class CharTrait>
|
||||
inline std::basic_istream<CharType, CharTrait>&
|
||||
operator>>(std::basic_istream<CharType, CharTrait>& i, const tuple_manipulator<CharType>& m) {
|
||||
m.set(i);
|
||||
return i;
|
||||
}
|
||||
|
||||
|
||||
template<class CharType>
|
||||
inline tuple_manipulator<CharType> set_open(const CharType c) {
|
||||
return tuple_manipulator<CharType>(detail::format_info::open, c);
|
||||
}
|
||||
|
||||
template<class CharType>
|
||||
inline tuple_manipulator<CharType> set_close(const CharType c) {
|
||||
return tuple_manipulator<CharType>(detail::format_info::close, c);
|
||||
}
|
||||
|
||||
template<class CharType>
|
||||
inline tuple_manipulator<CharType> set_delimiter(const CharType c) {
|
||||
return tuple_manipulator<CharType>(detail::format_info::delimiter, c);
|
||||
}
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
// -------------------------------------------------------------
|
||||
// printing tuples to ostream in format (a b c)
|
||||
// parentheses and space are defaults, but can be overriden with manipulators
|
||||
// set_open, set_close and set_delimiter
|
||||
|
||||
namespace detail {
|
||||
|
||||
// Note: The order of the print functions is critical
|
||||
// to let a conforming compiler find and select the correct one.
|
||||
|
||||
|
||||
template<class CharType, class CharTrait, class T1>
|
||||
inline std::basic_ostream<CharType, CharTrait>&
|
||||
print(std::basic_ostream<CharType, CharTrait>& o, const cons<T1, null_type>& t) {
|
||||
return o << t.head;
|
||||
}
|
||||
|
||||
|
||||
template<class CharType, class CharTrait>
|
||||
inline std::basic_ostream<CharType, CharTrait>&
|
||||
print(std::basic_ostream<CharType, CharTrait>& o, const null_type&) {
|
||||
return o;
|
||||
}
|
||||
|
||||
template<class CharType, class CharTrait, class T1, class T2>
|
||||
inline std::basic_ostream<CharType, CharTrait>&
|
||||
print(std::basic_ostream<CharType, CharTrait>& o, const cons<T1, T2>& t) {
|
||||
|
||||
const CharType d = format_info::get_manipulator(o, format_info::delimiter);
|
||||
|
||||
o << t.head;
|
||||
|
||||
o << d;
|
||||
|
||||
return print(o, t.tail);
|
||||
}
|
||||
|
||||
template<class CharT, class Traits, class T>
|
||||
inline bool handle_width(std::basic_ostream<CharT, Traits>& o, const T& t) {
|
||||
std::streamsize width = o.width();
|
||||
if(width == 0) return false;
|
||||
|
||||
std::basic_ostringstream<CharT, Traits> ss;
|
||||
|
||||
ss.copyfmt(o);
|
||||
ss.tie(0);
|
||||
ss.width(0);
|
||||
|
||||
ss << t;
|
||||
o << ss.str();
|
||||
|
||||
return true;
|
||||
}
|
||||
|
||||
|
||||
} // namespace detail
|
||||
|
||||
|
||||
template<class CharType, class CharTrait>
|
||||
inline std::basic_ostream<CharType, CharTrait>&
|
||||
operator<<(std::basic_ostream<CharType, CharTrait>& o,
|
||||
const null_type& t) {
|
||||
if (!o.good() ) return o;
|
||||
if (detail::handle_width(o, t)) return o;
|
||||
|
||||
const CharType l =
|
||||
detail::format_info::get_manipulator(o, detail::format_info::open);
|
||||
const CharType r =
|
||||
detail::format_info::get_manipulator(o, detail::format_info::close);
|
||||
|
||||
o << l;
|
||||
o << r;
|
||||
|
||||
return o;
|
||||
}
|
||||
|
||||
template<class CharType, class CharTrait, class T1, class T2>
|
||||
inline std::basic_ostream<CharType, CharTrait>&
|
||||
operator<<(std::basic_ostream<CharType, CharTrait>& o,
|
||||
const cons<T1, T2>& t) {
|
||||
if (!o.good() ) return o;
|
||||
if (detail::handle_width(o, t)) return o;
|
||||
|
||||
const CharType l =
|
||||
detail::format_info::get_manipulator(o, detail::format_info::open);
|
||||
const CharType r =
|
||||
detail::format_info::get_manipulator(o, detail::format_info::close);
|
||||
|
||||
o << l;
|
||||
|
||||
detail::print(o, t);
|
||||
|
||||
o << r;
|
||||
|
||||
return o;
|
||||
}
|
||||
|
||||
|
||||
// -------------------------------------------------------------
|
||||
// input stream operators
|
||||
|
||||
namespace detail {
|
||||
|
||||
|
||||
template<class CharType, class CharTrait>
|
||||
inline std::basic_istream<CharType, CharTrait>&
|
||||
extract_and_check_delimiter(
|
||||
std::basic_istream<CharType, CharTrait> &is, format_info::manipulator_type del)
|
||||
{
|
||||
const CharType d = format_info::get_manipulator(is, del);
|
||||
|
||||
#if defined (BOOST_NO_STD_LOCALE)
|
||||
const bool is_delimiter = !isspace(d);
|
||||
#elif defined ( BOOST_BORLANDC )
|
||||
const bool is_delimiter = !std::use_facet< std::ctype< CharType > >
|
||||
(is.getloc() ).is( std::ctype_base::space, d);
|
||||
#else
|
||||
const bool is_delimiter = (!std::isspace(d, is.getloc()) );
|
||||
#endif
|
||||
|
||||
CharType c;
|
||||
if (is_delimiter) {
|
||||
is >> c;
|
||||
if (is.good() && c!=d) {
|
||||
is.setstate(std::ios::failbit);
|
||||
}
|
||||
} else {
|
||||
is >> std::ws;
|
||||
}
|
||||
return is;
|
||||
}
|
||||
|
||||
|
||||
template<class CharType, class CharTrait, class T1>
|
||||
inline std::basic_istream<CharType, CharTrait> &
|
||||
read (std::basic_istream<CharType, CharTrait> &is, cons<T1, null_type>& t1) {
|
||||
|
||||
if (!is.good()) return is;
|
||||
|
||||
return is >> t1.head;
|
||||
}
|
||||
|
||||
template<class CharType, class CharTrait, class T1, class T2>
|
||||
inline std::basic_istream<CharType, CharTrait>&
|
||||
read(std::basic_istream<CharType, CharTrait> &is, cons<T1, T2>& t1) {
|
||||
|
||||
if (!is.good()) return is;
|
||||
|
||||
is >> t1.head;
|
||||
|
||||
|
||||
extract_and_check_delimiter(is, format_info::delimiter);
|
||||
|
||||
return read(is, t1.tail);
|
||||
}
|
||||
|
||||
} // end namespace detail
|
||||
|
||||
|
||||
template<class CharType, class CharTrait>
|
||||
inline std::basic_istream<CharType, CharTrait>&
|
||||
operator>>(std::basic_istream<CharType, CharTrait> &is, null_type&) {
|
||||
|
||||
if (!is.good() ) return is;
|
||||
|
||||
detail::extract_and_check_delimiter(is, detail::format_info::open);
|
||||
detail::extract_and_check_delimiter(is, detail::format_info::close);
|
||||
|
||||
return is;
|
||||
}
|
||||
|
||||
template<class CharType, class CharTrait, class T1, class T2>
|
||||
inline std::basic_istream<CharType, CharTrait>&
|
||||
operator>>(std::basic_istream<CharType, CharTrait>& is, cons<T1, T2>& t1) {
|
||||
|
||||
if (!is.good() ) return is;
|
||||
|
||||
detail::extract_and_check_delimiter(is, detail::format_info::open);
|
||||
|
||||
detail::read(is, t1);
|
||||
|
||||
detail::extract_and_check_delimiter(is, detail::format_info::close);
|
||||
|
||||
return is;
|
||||
}
|
||||
|
||||
|
||||
} // end of namespace tuples
|
||||
} // end of namespace boost
|
||||
|
||||
#endif // BOOST_TUPLE_IO_HPP
|
||||
13
index.html
13
index.html
@ -1,13 +0,0 @@
|
||||
<html>
|
||||
<head>
|
||||
<meta http-equiv="refresh" content="0; URL=doc/html/tuple_users_guide.html">
|
||||
</head>
|
||||
<body>
|
||||
Automatic redirection failed, please go to <a href="doc/html/tuple_users_guide.html">doc/html/tuple_users_guide.html</a>
|
||||
<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>
|
||||
</body>
|
||||
</html>
|
||||
@ -1,18 +0,0 @@
|
||||
{
|
||||
"key": "tuple",
|
||||
"name": "Tuple",
|
||||
"authors": [
|
||||
"Jaakko Järvi"
|
||||
],
|
||||
"description": "Ease definition of functions returning multiple values, and more.",
|
||||
"std": [
|
||||
"tr1"
|
||||
],
|
||||
"category": [
|
||||
"Data"
|
||||
],
|
||||
"maintainers": [
|
||||
"Jaakko Jarvi <jarvi -at- cs.tamu.edu>"
|
||||
],
|
||||
"cxxstd": "03"
|
||||
}
|
||||
11
test/Jamfile
11
test/Jamfile
@ -1,11 +0,0 @@
|
||||
# Copyright (C) 1999, 2000 Jaakko Jarvi (jaakko.jarvi@cs.utu.fi)
|
||||
# Distributed under the Boost Software License, Version 1.0.
|
||||
|
||||
test-suite tuple :
|
||||
[ run tuple_test_bench.cpp ]
|
||||
[ run io_test.cpp ]
|
||||
[ run another_tuple_test_bench.cpp ]
|
||||
[ run std_tuple_size.cpp ]
|
||||
[ run std_tuple_element.cpp ]
|
||||
[ run structured_bindings.cpp ]
|
||||
;
|
||||
16
test/README
16
test/README
@ -1,16 +0,0 @@
|
||||
To compile the
|
||||
|
||||
libs/tuple/test/*.cpp
|
||||
|
||||
files, you need to set include paths
|
||||
for boost.
|
||||
For example, in libs/tuple/test directory you would type (using g++):
|
||||
|
||||
g++ -I../../.. tuple_test_bench.cpp
|
||||
|
||||
The following is not true anymore:
|
||||
|
||||
If you want to use tuple_io, you need to compile and link src/tuple.cpp:
|
||||
g++ -I../../.. ../src/tuple.cpp io_test.cpp
|
||||
|
||||
Thanks to Hartmut Kaiser's suggestion, the tuple.cpp is not needed anymore.
|
||||
@ -1,162 +0,0 @@
|
||||
// Copyright (C) 1999, 2000 Jaakko Jarvi (jaakko.jarvi@cs.utu.fi)
|
||||
//
|
||||
// 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)
|
||||
|
||||
// For more information, see http://www.boost.org
|
||||
|
||||
|
||||
// another_test_bench.cpp --------------------------------
|
||||
|
||||
// This file has various tests to see that things that shouldn't
|
||||
// compile, don't compile.
|
||||
|
||||
// Defining any of E1 to E5 or E7 to E11 opens some illegal code that
|
||||
// should cause the compliation to fail.
|
||||
|
||||
#include "boost/tuple/tuple.hpp"
|
||||
|
||||
#include "boost/core/lightweight_test.hpp"
|
||||
|
||||
#include <string>
|
||||
#include <utility>
|
||||
|
||||
using namespace boost;
|
||||
using namespace boost::tuples;
|
||||
|
||||
|
||||
template<class T> void dummy(const T&) {}
|
||||
|
||||
class A {}; class B {}; class C {};
|
||||
|
||||
// A non-copyable class
|
||||
class no_copy {
|
||||
no_copy(const no_copy&) {}
|
||||
public:
|
||||
no_copy() {};
|
||||
};
|
||||
|
||||
no_copy y;
|
||||
|
||||
#ifdef E1
|
||||
tuple<no_copy> v1; // should faild
|
||||
#endif
|
||||
|
||||
|
||||
#ifdef E2
|
||||
char cs[10];
|
||||
tuple<char[10]> v3; // should fail, arrays must be stored as references
|
||||
#endif
|
||||
|
||||
// a class without a public default constructor
|
||||
class no_def_constructor {
|
||||
no_def_constructor() {}
|
||||
public:
|
||||
no_def_constructor(std::string) {} // can be constructed with a string
|
||||
};
|
||||
|
||||
void foo1() {
|
||||
|
||||
#ifdef E3
|
||||
dummy(tuple<no_def_constructor, no_def_constructor, no_def_constructor>());
|
||||
// should fail
|
||||
|
||||
#endif
|
||||
}
|
||||
|
||||
void foo2() {
|
||||
// testing default values
|
||||
#ifdef E4
|
||||
dummy(tuple<double&>()); // should fail, not defaults for references
|
||||
dummy(tuple<const double&>()); // likewise
|
||||
#endif
|
||||
|
||||
#ifdef E5
|
||||
double dd = 5;
|
||||
dummy(tuple<double&>(dd+3.14)); // should fail, temporary to non-const reference
|
||||
#endif
|
||||
}
|
||||
|
||||
|
||||
|
||||
// make_tuple ------------------------------------------
|
||||
|
||||
|
||||
void foo3() {
|
||||
#ifdef E7
|
||||
std::make_pair("Doesn't","Work"); // fails
|
||||
#endif
|
||||
// make_tuple("Does", "Work"); // this should work
|
||||
}
|
||||
|
||||
|
||||
|
||||
// - testing element access
|
||||
|
||||
void foo4()
|
||||
{
|
||||
double d = 2.7;
|
||||
A a;
|
||||
tuple<int, double&, const A&> t(1, d, a);
|
||||
const tuple<int, double&, const A> ct = t;
|
||||
(void)ct;
|
||||
#ifdef E8
|
||||
get<0>(ct) = 5; // can't assign to const
|
||||
#endif
|
||||
|
||||
#ifdef E9
|
||||
get<4>(t) = A(); // can't assign to const
|
||||
#endif
|
||||
#ifdef E10
|
||||
dummy(get<5>(ct)); // illegal index
|
||||
#endif
|
||||
}
|
||||
|
||||
// testing copy and assignment with implicit conversions between elements
|
||||
// testing tie
|
||||
|
||||
class AA {};
|
||||
class BB : public AA {};
|
||||
struct CC { CC() {} CC(const BB& b) {} };
|
||||
struct DD { operator CC() const { return CC(); }; };
|
||||
|
||||
void foo5() {
|
||||
tuple<char, BB*, BB, DD> t;
|
||||
(void)t;
|
||||
tuple<char, char> aaa;
|
||||
tuple<int, int> bbb(aaa);
|
||||
(void)bbb;
|
||||
// tuple<int, AA*, CC, CC> a = t;
|
||||
// a = t;
|
||||
}
|
||||
|
||||
|
||||
// testing tie
|
||||
// testing assignment from std::pair
|
||||
void foo7() {
|
||||
|
||||
tuple<int, int, float> a;
|
||||
#ifdef E11
|
||||
a = std::make_pair(1, 2); // should fail, tuple is of length 3, not 2
|
||||
#endif
|
||||
|
||||
dummy(a);
|
||||
}
|
||||
|
||||
|
||||
|
||||
// --------------------------------
|
||||
// ----------------------------
|
||||
int main() {
|
||||
|
||||
foo1();
|
||||
foo2();
|
||||
foo3();
|
||||
foo4();
|
||||
foo5();
|
||||
|
||||
foo7();
|
||||
|
||||
return boost::report_errors();
|
||||
}
|
||||
141
test/io_test.cpp
141
test/io_test.cpp
@ -1,141 +0,0 @@
|
||||
// Copyright (C) 1999, 2000 Jaakko Jarvi (jaakko.jarvi@cs.utu.fi)
|
||||
//
|
||||
// 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)
|
||||
|
||||
// For more information, see http://www.boost.org
|
||||
|
||||
// -- io_test.cpp -----------------------------------------------
|
||||
//
|
||||
// Testing the I/O facilities of tuples
|
||||
|
||||
#include "boost/tuple/tuple_io.hpp"
|
||||
#include "boost/tuple/tuple_comparison.hpp"
|
||||
|
||||
#include "boost/core/lightweight_test.hpp"
|
||||
|
||||
#include <fstream>
|
||||
#include <iterator>
|
||||
#include <algorithm>
|
||||
#include <string>
|
||||
#include <iomanip>
|
||||
|
||||
#if defined BOOST_NO_STRINGSTREAM
|
||||
#include <strstream>
|
||||
#else
|
||||
#include <sstream>
|
||||
#endif
|
||||
|
||||
#define BOOST_CHECK BOOST_TEST
|
||||
|
||||
using namespace boost;
|
||||
|
||||
#if defined BOOST_NO_STRINGSTREAM
|
||||
typedef std::ostrstream useThisOStringStream;
|
||||
typedef std::istrstream useThisIStringStream;
|
||||
#else
|
||||
typedef std::ostringstream useThisOStringStream;
|
||||
typedef std::istringstream useThisIStringStream;
|
||||
#endif
|
||||
|
||||
int main() {
|
||||
using boost::tuples::set_close;
|
||||
using boost::tuples::set_open;
|
||||
using boost::tuples::set_delimiter;
|
||||
|
||||
useThisOStringStream os1;
|
||||
|
||||
// Set format [a, b, c] for os1
|
||||
os1 << set_open('[');
|
||||
os1 << set_close(']');
|
||||
os1 << set_delimiter(',');
|
||||
os1 << make_tuple(1, 2, 3);
|
||||
BOOST_CHECK (os1.str() == std::string("[1,2,3]") );
|
||||
|
||||
{
|
||||
useThisOStringStream os2;
|
||||
// Set format (a:b:c) for os2;
|
||||
os2 << set_open('(');
|
||||
os2 << set_close(')');
|
||||
os2 << set_delimiter(':');
|
||||
#if !defined (BOOST_NO_TEMPLATE_PARTIAL_SPECIALIZATION)
|
||||
os2 << make_tuple("TUPU", "HUPU", "LUPU", 4.5);
|
||||
BOOST_CHECK (os2.str() == std::string("(TUPU:HUPU:LUPU:4.5)") );
|
||||
#endif
|
||||
}
|
||||
|
||||
// The format is still [a, b, c] for os1
|
||||
os1 << make_tuple(1, 2, 3);
|
||||
BOOST_CHECK (os1.str() == std::string("[1,2,3][1,2,3]") );
|
||||
|
||||
// check empty tuple.
|
||||
useThisOStringStream os3;
|
||||
os3 << make_tuple();
|
||||
BOOST_CHECK (os3.str() == std::string("()") );
|
||||
os3 << set_open('[');
|
||||
os3 << set_close(']');
|
||||
os3 << make_tuple();
|
||||
BOOST_CHECK (os3.str() == std::string("()[]") );
|
||||
|
||||
// check width
|
||||
useThisOStringStream os4;
|
||||
os4 << std::setw(10) << make_tuple(1, 2, 3);
|
||||
BOOST_CHECK (os4.str() == std::string(" (1 2 3)") );
|
||||
|
||||
std::ofstream tmp("temp.tmp");
|
||||
|
||||
#if !defined (BOOST_NO_TEMPLATE_PARTIAL_SPECIALIZATION)
|
||||
tmp << make_tuple("One", "Two", 3);
|
||||
#endif
|
||||
tmp << set_delimiter(':');
|
||||
tmp << make_tuple(1000, 2000, 3000) << std::endl;
|
||||
|
||||
tmp.close();
|
||||
|
||||
// When teading tuples from a stream, manipulators must be set correctly:
|
||||
std::ifstream tmp3("temp.tmp");
|
||||
tuple<std::string, std::string, int> j;
|
||||
|
||||
#if !defined (BOOST_NO_TEMPLATE_PARTIAL_SPECIALIZATION)
|
||||
tmp3 >> j;
|
||||
BOOST_CHECK (tmp3.good() );
|
||||
#endif
|
||||
|
||||
tmp3 >> set_delimiter(':');
|
||||
tuple<int, int, int> i;
|
||||
tmp3 >> i;
|
||||
BOOST_CHECK (tmp3.good() );
|
||||
|
||||
tmp3.close();
|
||||
|
||||
|
||||
// reading tuple<int, int, int> in format (a b c);
|
||||
useThisIStringStream is1("(100 200 300)");
|
||||
|
||||
tuple<int, int, int> ti1;
|
||||
BOOST_CHECK(bool(is1 >> ti1));
|
||||
BOOST_CHECK(ti1 == make_tuple(100, 200, 300));
|
||||
|
||||
useThisIStringStream is2("()");
|
||||
tuple<> ti2;
|
||||
BOOST_CHECK(bool(is2 >> ti2));
|
||||
useThisIStringStream is3("[]");
|
||||
is3 >> set_open('[');
|
||||
is3 >> set_close(']');
|
||||
BOOST_CHECK(bool(is3 >> ti2));
|
||||
|
||||
// Make sure that whitespace between elements
|
||||
// is skipped.
|
||||
useThisIStringStream is4("(100 200 300)");
|
||||
|
||||
BOOST_CHECK(bool(is4 >> std::noskipws >> ti1));
|
||||
BOOST_CHECK(ti1 == make_tuple(100, 200, 300));
|
||||
|
||||
// Note that strings are problematic:
|
||||
// writing a tuple on a stream and reading it back doesn't work in
|
||||
// general. If this is wanted, some kind of a parseable string class
|
||||
// should be used.
|
||||
|
||||
return boost::report_errors();
|
||||
}
|
||||
@ -1,56 +0,0 @@
|
||||
// Copyright 2017 Peter Dimov.
|
||||
// Distributed under the Boost Software License, Version 1.0.
|
||||
|
||||
#include <boost/tuple/tuple.hpp>
|
||||
#include <boost/core/lightweight_test_trait.hpp>
|
||||
#include <boost/type_traits/is_same.hpp>
|
||||
#include <boost/config.hpp>
|
||||
#include <boost/config/pragma_message.hpp>
|
||||
|
||||
#if defined(BOOST_NO_CXX11_HDR_TUPLE)
|
||||
|
||||
BOOST_PRAGMA_MESSAGE("Skipping std::tuple_element tests for lack of <tuple>")
|
||||
int main() {}
|
||||
|
||||
#else
|
||||
|
||||
#include <tuple>
|
||||
|
||||
template<class Tp, std::size_t I, class E> void test()
|
||||
{
|
||||
BOOST_TEST_TRAIT_TRUE((boost::is_same<typename std::tuple_element<I, Tp>::type, E>));
|
||||
|
||||
typedef typename Tp::inherited Tp2;
|
||||
BOOST_TEST_TRAIT_TRUE((boost::is_same<typename std::tuple_element<I, Tp2>::type, E>));
|
||||
}
|
||||
|
||||
template<int> struct X
|
||||
{
|
||||
};
|
||||
|
||||
int main()
|
||||
{
|
||||
test<boost::tuple<X<0> const>, 0, X<0> const>();
|
||||
|
||||
test<boost::tuple<X<0> const, X<1> const>, 0, X<0> const>();
|
||||
test<boost::tuple<X<0> const, X<1> const>, 1, X<1> const>();
|
||||
|
||||
test<boost::tuple<X<0> const, X<1> const, X<2> const>, 0, X<0> const>();
|
||||
test<boost::tuple<X<0> const, X<1> const, X<2> const>, 1, X<1> const>();
|
||||
test<boost::tuple<X<0> const, X<1> const, X<2> const>, 2, X<2> const>();
|
||||
|
||||
test<boost::tuple<X<0> const, X<1> const, X<2> const, X<3> const>, 0, X<0> const>();
|
||||
test<boost::tuple<X<0> const, X<1> const, X<2> const, X<3> const>, 1, X<1> const>();
|
||||
test<boost::tuple<X<0> const, X<1> const, X<2> const, X<3> const>, 2, X<2> const>();
|
||||
test<boost::tuple<X<0> const, X<1> const, X<2> const, X<3> const>, 3, X<3> const>();
|
||||
|
||||
test<boost::tuple<X<0> const, X<1> const, X<2> const, X<3> const, X<4> const>, 0, X<0> const>();
|
||||
test<boost::tuple<X<0> const, X<1> const, X<2> const, X<3> const, X<4> const>, 1, X<1> const>();
|
||||
test<boost::tuple<X<0> const, X<1> const, X<2> const, X<3> const, X<4> const>, 2, X<2> const>();
|
||||
test<boost::tuple<X<0> const, X<1> const, X<2> const, X<3> const, X<4> const>, 3, X<3> const>();
|
||||
test<boost::tuple<X<0> const, X<1> const, X<2> const, X<3> const, X<4> const>, 4, X<4> const>();
|
||||
|
||||
return boost::report_errors();
|
||||
}
|
||||
|
||||
#endif
|
||||
@ -1,61 +0,0 @@
|
||||
// Copyright 2017 Peter Dimov.
|
||||
// Distributed under the Boost Software License, Version 1.0.
|
||||
|
||||
#include <boost/tuple/tuple.hpp>
|
||||
#include <boost/core/lightweight_test.hpp>
|
||||
#include <boost/config.hpp>
|
||||
#include <boost/config/pragma_message.hpp>
|
||||
|
||||
#if defined(BOOST_NO_CXX11_HDR_TUPLE)
|
||||
|
||||
BOOST_PRAGMA_MESSAGE("Skipping std::tuple_size tests for lack of <tuple>")
|
||||
int main() {}
|
||||
|
||||
#else
|
||||
|
||||
#include <tuple>
|
||||
|
||||
template<class Tp> void test( std::size_t x )
|
||||
{
|
||||
BOOST_TEST_EQ( std::tuple_size< Tp >::value, x );
|
||||
BOOST_TEST_EQ( std::tuple_size< typename Tp::inherited >::value, x );
|
||||
}
|
||||
|
||||
struct V
|
||||
{
|
||||
};
|
||||
|
||||
int main()
|
||||
{
|
||||
test< boost::tuple<> >( 0 );
|
||||
test< boost::tuple<V> >( 1 );
|
||||
test< boost::tuple<V, V> >( 2 );
|
||||
test< boost::tuple<V, V, V> >( 3 );
|
||||
test< boost::tuple<V, V, V, V> >( 4 );
|
||||
test< boost::tuple<V, V, V, V, V> >( 5 );
|
||||
test< boost::tuple<V, V, V, V, V, V> >( 6 );
|
||||
test< boost::tuple<V, V, V, V, V, V, V> >( 7 );
|
||||
test< boost::tuple<V, V, V, V, V, V, V, V> >( 8 );
|
||||
test< boost::tuple<V, V, V, V, V, V, V, V, V> >( 9 );
|
||||
test< boost::tuple<V, V, V, V, V, V, V, V, V, V> >( 10 );
|
||||
|
||||
#if !defined(BOOST_NO_CXX11_DECLTYPE)
|
||||
|
||||
BOOST_TEST_EQ( std::tuple_size<decltype(boost::make_tuple())>::value, 0 );
|
||||
BOOST_TEST_EQ( std::tuple_size<decltype(boost::make_tuple(1))>::value, 1 );
|
||||
BOOST_TEST_EQ( std::tuple_size<decltype(boost::make_tuple(1, 2))>::value, 2 );
|
||||
BOOST_TEST_EQ( std::tuple_size<decltype(boost::make_tuple(1, 2, 3))>::value, 3 );
|
||||
BOOST_TEST_EQ( std::tuple_size<decltype(boost::make_tuple(1, 2, 3, 4))>::value, 4 );
|
||||
BOOST_TEST_EQ( std::tuple_size<decltype(boost::make_tuple(1, 2, 3, 4, 5))>::value, 5 );
|
||||
BOOST_TEST_EQ( std::tuple_size<decltype(boost::make_tuple(1, 2, 3, 4, 5, 6))>::value, 6 );
|
||||
BOOST_TEST_EQ( std::tuple_size<decltype(boost::make_tuple(1, 2, 3, 4, 5, 6, 7))>::value, 7 );
|
||||
BOOST_TEST_EQ( std::tuple_size<decltype(boost::make_tuple(1, 2, 3, 4, 5, 6, 7, 8))>::value, 8 );
|
||||
BOOST_TEST_EQ( std::tuple_size<decltype(boost::make_tuple(1, 2, 3, 4, 5, 6, 7, 8, 9))>::value, 9 );
|
||||
BOOST_TEST_EQ( std::tuple_size<decltype(boost::make_tuple(1, 2, 3, 4, 5, 6, 7, 8, 9, 10))>::value, 10 );
|
||||
|
||||
#endif
|
||||
|
||||
return boost::report_errors();
|
||||
}
|
||||
|
||||
#endif
|
||||
@ -1,77 +0,0 @@
|
||||
// Copyright 2017 Peter Dimov.
|
||||
// Distributed under the Boost Software License, Version 1.0.
|
||||
|
||||
#include <boost/tuple/tuple.hpp>
|
||||
#include <boost/core/lightweight_test.hpp>
|
||||
#include <boost/config.hpp>
|
||||
#include <boost/config/pragma_message.hpp>
|
||||
|
||||
#if defined(BOOST_NO_CXX17_STRUCTURED_BINDINGS)
|
||||
|
||||
BOOST_PRAGMA_MESSAGE("Skipping structured bindings test, not supported")
|
||||
int main() {}
|
||||
|
||||
#else
|
||||
|
||||
int main()
|
||||
{
|
||||
// make_tuple
|
||||
|
||||
{
|
||||
auto [x1] = boost::make_tuple( 1 );
|
||||
BOOST_TEST_EQ( x1, 1 );
|
||||
}
|
||||
|
||||
{
|
||||
auto [x1, x2] = boost::make_tuple( 1, 2 );
|
||||
BOOST_TEST_EQ( x1, 1 );
|
||||
BOOST_TEST_EQ( x2, 2 );
|
||||
}
|
||||
|
||||
{
|
||||
auto [x1, x2, x3] = boost::make_tuple( 1, 2, 3 );
|
||||
BOOST_TEST_EQ( x1, 1 );
|
||||
BOOST_TEST_EQ( x2, 2 );
|
||||
BOOST_TEST_EQ( x3, 3 );
|
||||
}
|
||||
|
||||
{
|
||||
auto [x1, x2, x3, x4] = boost::make_tuple( 1, 2, 3, 4 );
|
||||
BOOST_TEST_EQ( x1, 1 );
|
||||
BOOST_TEST_EQ( x2, 2 );
|
||||
BOOST_TEST_EQ( x3, 3 );
|
||||
BOOST_TEST_EQ( x4, 4 );
|
||||
}
|
||||
|
||||
// tuple
|
||||
|
||||
{
|
||||
auto [x1] = boost::tuple<int>( 1 );
|
||||
BOOST_TEST_EQ( x1, 1 );
|
||||
}
|
||||
|
||||
{
|
||||
auto [x1, x2] = boost::tuple<int, int>( 1, 2 );
|
||||
BOOST_TEST_EQ( x1, 1 );
|
||||
BOOST_TEST_EQ( x2, 2 );
|
||||
}
|
||||
|
||||
{
|
||||
auto [x1, x2, x3] = boost::tuple<int, int, int>( 1, 2, 3 );
|
||||
BOOST_TEST_EQ( x1, 1 );
|
||||
BOOST_TEST_EQ( x2, 2 );
|
||||
BOOST_TEST_EQ( x3, 3 );
|
||||
}
|
||||
|
||||
{
|
||||
auto [x1, x2, x3, x4] = boost::tuple<int, int, int, int>( 1, 2, 3, 4 );
|
||||
BOOST_TEST_EQ( x1, 1 );
|
||||
BOOST_TEST_EQ( x2, 2 );
|
||||
BOOST_TEST_EQ( x3, 3 );
|
||||
BOOST_TEST_EQ( x4, 4 );
|
||||
}
|
||||
|
||||
return boost::report_errors();
|
||||
}
|
||||
|
||||
#endif
|
||||
@ -1,490 +0,0 @@
|
||||
// Copyright (C) 1999, 2000 Jaakko Jarvi (jaakko.jarvi@cs.utu.fi)
|
||||
//
|
||||
// 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)
|
||||
|
||||
// For more information, see http://www.boost.org
|
||||
|
||||
// tuple_test_bench.cpp --------------------------------
|
||||
|
||||
#include "boost/tuple/tuple.hpp"
|
||||
#include "boost/tuple/tuple_comparison.hpp"
|
||||
|
||||
#include "boost/type_traits/is_const.hpp"
|
||||
#include "boost/ref.hpp"
|
||||
#include "boost/core/lightweight_test.hpp"
|
||||
|
||||
#include <string>
|
||||
#include <utility>
|
||||
|
||||
#define BOOST_CHECK BOOST_TEST
|
||||
|
||||
using namespace boost;
|
||||
|
||||
// ----------------------------------------------------------------------------
|
||||
// helpers
|
||||
// ----------------------------------------------------------------------------
|
||||
|
||||
class A {};
|
||||
class B {};
|
||||
class C {};
|
||||
|
||||
// classes with different kinds of conversions
|
||||
class AA {};
|
||||
class BB : public AA {};
|
||||
struct CC { CC() {} CC(const BB&) {} };
|
||||
struct DD { operator CC() const { return CC(); }; };
|
||||
|
||||
// something to prevent warnings for unused variables
|
||||
template<class T> void dummy(const T&) {}
|
||||
|
||||
// no public default constructor
|
||||
class foo {
|
||||
public:
|
||||
explicit foo(int v) : val(v) {}
|
||||
|
||||
bool operator==(const foo& other) const {
|
||||
return val == other.val;
|
||||
}
|
||||
|
||||
private:
|
||||
foo() {}
|
||||
int val;
|
||||
};
|
||||
|
||||
// another class without a public default constructor
|
||||
class no_def_constructor {
|
||||
no_def_constructor() {}
|
||||
public:
|
||||
no_def_constructor(std::string) {}
|
||||
};
|
||||
|
||||
// A non-copyable class
|
||||
class no_copy {
|
||||
no_copy(const no_copy&) {}
|
||||
public:
|
||||
no_copy() {};
|
||||
};
|
||||
|
||||
|
||||
// ----------------------------------------------------------------------------
|
||||
// Testing different element types --------------------------------------------
|
||||
// ----------------------------------------------------------------------------
|
||||
|
||||
|
||||
typedef tuple<int> t1;
|
||||
|
||||
typedef tuple<double&, const double&, const double, double*, const double*> t2;
|
||||
typedef tuple<A, int(*)(char, int), C> t3;
|
||||
typedef tuple<std::string, std::pair<A, B> > t4;
|
||||
typedef tuple<A*, tuple<const A*, const B&, C>, bool, void*> t5;
|
||||
typedef tuple<volatile int, const volatile char&, int(&)(float) > t6;
|
||||
|
||||
# if !defined(BOOST_BORLANDC) || BOOST_BORLANDC > 0x0551
|
||||
typedef tuple<B(A::*)(C&), A&> t7;
|
||||
#endif
|
||||
|
||||
// -----------------------------------------------------------------------
|
||||
// -tuple construction tests ---------------------------------------------
|
||||
// -----------------------------------------------------------------------
|
||||
|
||||
|
||||
no_copy y;
|
||||
tuple<no_copy&> x = tuple<no_copy&>(y); // ok
|
||||
|
||||
char cs[10];
|
||||
tuple<char(&)[10]> v2(cs); // ok
|
||||
|
||||
void
|
||||
construction_test()
|
||||
{
|
||||
|
||||
// Note, the get function can be called without the tuples:: qualifier,
|
||||
// as it is lifted to namespace boost with a "using tuples::get" but
|
||||
// MSVC 6.0 just cannot find get without the namespace qualifier
|
||||
|
||||
tuple<int> t1;
|
||||
BOOST_CHECK(get<0>(t1) == int());
|
||||
|
||||
tuple<float> t2(5.5f);
|
||||
BOOST_CHECK(get<0>(t2) > 5.4f && get<0>(t2) < 5.6f);
|
||||
|
||||
tuple<foo> t3(foo(12));
|
||||
BOOST_CHECK(get<0>(t3) == foo(12));
|
||||
|
||||
tuple<double> t4(t2);
|
||||
BOOST_CHECK(get<0>(t4) > 5.4 && get<0>(t4) < 5.6);
|
||||
|
||||
tuple<int, float> t5;
|
||||
BOOST_CHECK(get<0>(t5) == int());
|
||||
BOOST_CHECK(get<1>(t5) == float());
|
||||
|
||||
tuple<int, float> t6(12, 5.5f);
|
||||
BOOST_CHECK(get<0>(t6) == 12);
|
||||
BOOST_CHECK(get<1>(t6) > 5.4f && get<1>(t6) < 5.6f);
|
||||
|
||||
tuple<int, float> t7(t6);
|
||||
BOOST_CHECK(get<0>(t7) == 12);
|
||||
BOOST_CHECK(get<1>(t7) > 5.4f && get<1>(t7) < 5.6f);
|
||||
|
||||
tuple<long, double> t8(t6);
|
||||
BOOST_CHECK(get<0>(t8) == 12);
|
||||
BOOST_CHECK(get<1>(t8) > 5.4f && get<1>(t8) < 5.6f);
|
||||
|
||||
dummy(
|
||||
tuple<no_def_constructor, no_def_constructor, no_def_constructor>(
|
||||
std::string("Jaba"), // ok, since the default
|
||||
std::string("Daba"), // constructor is not used
|
||||
std::string("Doo")
|
||||
)
|
||||
);
|
||||
|
||||
// testing default values
|
||||
dummy(tuple<int, double>());
|
||||
dummy(tuple<int, double>(1));
|
||||
dummy(tuple<int, double>(1,3.14));
|
||||
|
||||
|
||||
// dummy(tuple<double&>()); // should fail, not defaults for references
|
||||
// dummy(tuple<const double&>()); // likewise
|
||||
|
||||
double dd = 5;
|
||||
dummy(tuple<double&>(dd)); // ok
|
||||
|
||||
dummy(tuple<const double&>(dd+3.14)); // ok, but dangerous
|
||||
|
||||
// dummy(tuple<double&>(dd+3.14)); // should fail,
|
||||
// // temporary to non-const reference
|
||||
}
|
||||
|
||||
|
||||
// ----------------------------------------------------------------------------
|
||||
// - testing element access ---------------------------------------------------
|
||||
// ----------------------------------------------------------------------------
|
||||
|
||||
void element_access_test()
|
||||
{
|
||||
double d = 2.7;
|
||||
A a;
|
||||
tuple<int, double&, const A&, int> t(1, d, a, 2);
|
||||
const tuple<int, double&, const A, int> ct = t;
|
||||
|
||||
int i = get<0>(t);
|
||||
int i2 = get<3>(t);
|
||||
|
||||
BOOST_CHECK(i == 1 && i2 == 2);
|
||||
|
||||
int j = get<0>(ct);
|
||||
BOOST_CHECK(j == 1);
|
||||
|
||||
get<0>(t) = 5;
|
||||
BOOST_CHECK(t.head == 5);
|
||||
|
||||
// get<0>(ct) = 5; // can't assign to const
|
||||
|
||||
double e = get<1>(t);
|
||||
BOOST_CHECK(e > 2.69 && e < 2.71);
|
||||
|
||||
get<1>(t) = 3.14+i;
|
||||
BOOST_CHECK(get<1>(t) > 4.13 && get<1>(t) < 4.15);
|
||||
|
||||
// get<4>(t) = A(); // can't assign to const
|
||||
// dummy(get<5>(ct)); // illegal index
|
||||
|
||||
++get<0>(t);
|
||||
BOOST_CHECK(get<0>(t) == 6);
|
||||
|
||||
BOOST_STATIC_ASSERT((boost::is_const<boost::tuples::element<0, tuple<int, float> >::type>::value != true));
|
||||
#ifndef BOOST_NO_TEMPLATE_PARTIAL_SPECIALIZATION
|
||||
BOOST_STATIC_ASSERT((boost::is_const<boost::tuples::element<0, const tuple<int, float> >::type>::value));
|
||||
#endif
|
||||
|
||||
BOOST_STATIC_ASSERT((boost::is_const<boost::tuples::element<1, tuple<int, float> >::type>::value != true));
|
||||
#ifndef BOOST_NO_TEMPLATE_PARTIAL_SPECIALIZATION
|
||||
BOOST_STATIC_ASSERT((boost::is_const<boost::tuples::element<1, const tuple<int, float> >::type>::value));
|
||||
#endif
|
||||
|
||||
|
||||
dummy(i); dummy(i2); dummy(j); dummy(e); // avoid warns for unused variables
|
||||
}
|
||||
|
||||
|
||||
// ----------------------------------------------------------------------------
|
||||
// - copying tuples -----------------------------------------------------------
|
||||
// ----------------------------------------------------------------------------
|
||||
|
||||
|
||||
|
||||
void
|
||||
copy_test()
|
||||
{
|
||||
tuple<int, char> t1(4, 'a');
|
||||
tuple<int, char> t2(5, 'b');
|
||||
t2 = t1;
|
||||
BOOST_CHECK(get<0>(t1) == get<0>(t2));
|
||||
BOOST_CHECK(get<1>(t1) == get<1>(t2));
|
||||
|
||||
tuple<long, std::string> t3(2, "a");
|
||||
t3 = t1;
|
||||
BOOST_CHECK((double)get<0>(t1) == get<0>(t3));
|
||||
BOOST_CHECK(get<1>(t1) == get<1>(t3)[0]);
|
||||
|
||||
// testing copy and assignment with implicit conversions between elements
|
||||
// testing tie
|
||||
|
||||
tuple<char, BB*, BB, DD> t;
|
||||
tuple<int, AA*, CC, CC> a(t);
|
||||
a = t;
|
||||
|
||||
int i; char c; double d;
|
||||
tie(i, c, d) = make_tuple(1, 'a', 5.5);
|
||||
|
||||
BOOST_CHECK(i==1);
|
||||
BOOST_CHECK(c=='a');
|
||||
BOOST_CHECK(d>5.4 && d<5.6);
|
||||
}
|
||||
|
||||
void
|
||||
mutate_test()
|
||||
{
|
||||
tuple<int, float, bool, foo> t1(5, 12.2f, true, foo(4));
|
||||
get<0>(t1) = 6;
|
||||
get<1>(t1) = 2.2f;
|
||||
get<2>(t1) = false;
|
||||
get<3>(t1) = foo(5);
|
||||
|
||||
BOOST_CHECK(get<0>(t1) == 6);
|
||||
BOOST_CHECK(get<1>(t1) > 2.1f && get<1>(t1) < 2.3f);
|
||||
BOOST_CHECK(get<2>(t1) == false);
|
||||
BOOST_CHECK(get<3>(t1) == foo(5));
|
||||
}
|
||||
|
||||
// ----------------------------------------------------------------------------
|
||||
// make_tuple tests -----------------------------------------------------------
|
||||
// ----------------------------------------------------------------------------
|
||||
|
||||
void
|
||||
make_tuple_test()
|
||||
{
|
||||
tuple<int, char> t1 = make_tuple(5, 'a');
|
||||
BOOST_CHECK(get<0>(t1) == 5);
|
||||
BOOST_CHECK(get<1>(t1) == 'a');
|
||||
|
||||
tuple<int, std::string> t2;
|
||||
t2 = boost::make_tuple((short int)2, std::string("Hi"));
|
||||
BOOST_CHECK(get<0>(t2) == 2);
|
||||
BOOST_CHECK(get<1>(t2) == "Hi");
|
||||
|
||||
|
||||
A a = A(); B b;
|
||||
const A ca = a;
|
||||
make_tuple(boost::cref(a), b);
|
||||
make_tuple(boost::ref(a), b);
|
||||
make_tuple(boost::ref(a), boost::cref(b));
|
||||
|
||||
make_tuple(boost::ref(ca));
|
||||
|
||||
// the result of make_tuple is assignable:
|
||||
BOOST_CHECK(make_tuple(2, 4, 6) ==
|
||||
(make_tuple(1, 2, 3) = make_tuple(2, 4, 6)));
|
||||
|
||||
#ifndef BOOST_NO_TEMPLATE_PARTIAL_SPECIALIZATION
|
||||
make_tuple("Donald", "Daisy"); // should work;
|
||||
#endif
|
||||
// std::make_pair("Doesn't","Work"); // fails
|
||||
|
||||
// You can store a reference to a function in a tuple
|
||||
tuple<void(&)()> adf(make_tuple_test);
|
||||
|
||||
dummy(adf); // avoid warning for unused variable
|
||||
|
||||
// But make_tuple doesn't work
|
||||
// with function references, since it creates a const qualified function type
|
||||
|
||||
// make_tuple(make_tuple_test);
|
||||
|
||||
// With function pointers, make_tuple works just fine
|
||||
|
||||
#if !defined(BOOST_BORLANDC) || BOOST_BORLANDC > 0x0551
|
||||
make_tuple(&make_tuple_test);
|
||||
#endif
|
||||
|
||||
// NOTE:
|
||||
//
|
||||
// wrapping it the function reference with ref helps on gcc 2.95.2.
|
||||
// on edg 2.43. it results in a catastrophic error?
|
||||
|
||||
// make_tuple(ref(foo3));
|
||||
|
||||
// It seems that edg can't use implicitly the ref's conversion operator, e.g.:
|
||||
// typedef void (&func_t) (void);
|
||||
// func_t fref = static_cast<func_t>(ref(make_tuple_test)); // works fine
|
||||
// func_t fref = ref(make_tuple_test); // error
|
||||
|
||||
// This is probably not a very common situation, so currently
|
||||
// I don't know how which compiler is right (JJ)
|
||||
}
|
||||
|
||||
void
|
||||
tie_test()
|
||||
{
|
||||
int a;
|
||||
char b;
|
||||
foo c(5);
|
||||
|
||||
tie(a, b, c) = make_tuple(2, 'a', foo(3));
|
||||
BOOST_CHECK(a == 2);
|
||||
BOOST_CHECK(b == 'a');
|
||||
BOOST_CHECK(c == foo(3));
|
||||
|
||||
tie(a, tuples::ignore, c) = make_tuple((short int)5, false, foo(5));
|
||||
BOOST_CHECK(a == 5);
|
||||
BOOST_CHECK(b == 'a');
|
||||
BOOST_CHECK(c == foo(5));
|
||||
|
||||
// testing assignment from std::pair
|
||||
int i, j;
|
||||
tie (i, j) = std::make_pair(1, 2);
|
||||
BOOST_CHECK(i == 1 && j == 2);
|
||||
|
||||
tuple<int, int, float> ta;
|
||||
#ifdef E11
|
||||
ta = std::make_pair(1, 2); // should fail, tuple is of length 3, not 2
|
||||
#endif
|
||||
|
||||
dummy(ta);
|
||||
}
|
||||
|
||||
|
||||
// ----------------------------------------------------------------------------
|
||||
// - testing tuple equality -------------------------------------------------
|
||||
// ----------------------------------------------------------------------------
|
||||
|
||||
void
|
||||
equality_test()
|
||||
{
|
||||
tuple<int, char> t1(5, 'a');
|
||||
tuple<int, char> t2(5, 'a');
|
||||
BOOST_CHECK(t1 == t2);
|
||||
|
||||
tuple<int, char> t3(5, 'b');
|
||||
tuple<int, char> t4(2, 'a');
|
||||
BOOST_CHECK(t1 != t3);
|
||||
BOOST_CHECK(t1 != t4);
|
||||
BOOST_CHECK(!(t1 != t2));
|
||||
}
|
||||
|
||||
|
||||
// ----------------------------------------------------------------------------
|
||||
// - testing tuple comparisons -----------------------------------------------
|
||||
// ----------------------------------------------------------------------------
|
||||
|
||||
void
|
||||
ordering_test()
|
||||
{
|
||||
tuple<int, float> t1(4, 3.3f);
|
||||
tuple<short, float> t2(5, 3.3f);
|
||||
tuple<long, double> t3(5, 4.4);
|
||||
BOOST_CHECK(t1 < t2);
|
||||
BOOST_CHECK(t1 <= t2);
|
||||
BOOST_CHECK(t2 > t1);
|
||||
BOOST_CHECK(t2 >= t1);
|
||||
BOOST_CHECK(t2 < t3);
|
||||
BOOST_CHECK(t2 <= t3);
|
||||
BOOST_CHECK(t3 > t2);
|
||||
BOOST_CHECK(t3 >= t2);
|
||||
|
||||
}
|
||||
|
||||
|
||||
// ----------------------------------------------------------------------------
|
||||
// - testing cons lists -------------------------------------------------------
|
||||
// ----------------------------------------------------------------------------
|
||||
void cons_test()
|
||||
{
|
||||
using tuples::cons;
|
||||
using tuples::null_type;
|
||||
|
||||
cons<volatile float, null_type> a(1, null_type());
|
||||
cons<const int, cons<volatile float, null_type> > b(2,a);
|
||||
int i = 3;
|
||||
cons<int&, cons<const int, cons<volatile float, null_type> > > c(i, b);
|
||||
BOOST_CHECK(make_tuple(3,2,1)==c);
|
||||
|
||||
cons<char, cons<int, cons<float, null_type> > > x;
|
||||
dummy(x);
|
||||
}
|
||||
|
||||
// ----------------------------------------------------------------------------
|
||||
// - testing const tuples -----------------------------------------------------
|
||||
// ----------------------------------------------------------------------------
|
||||
void const_tuple_test()
|
||||
{
|
||||
const tuple<int, float> t1(5, 3.3f);
|
||||
BOOST_CHECK(get<0>(t1) == 5);
|
||||
BOOST_CHECK(get<1>(t1) == 3.3f);
|
||||
}
|
||||
|
||||
// ----------------------------------------------------------------------------
|
||||
// - testing length -----------------------------------------------------------
|
||||
// ----------------------------------------------------------------------------
|
||||
void tuple_length_test()
|
||||
{
|
||||
typedef tuple<int, float, double> t1;
|
||||
using tuples::cons;
|
||||
typedef cons<int, cons< float, cons <double, tuples::null_type> > > t1_cons;
|
||||
typedef tuple<> t2;
|
||||
typedef tuples::null_type t3;
|
||||
|
||||
BOOST_STATIC_ASSERT(tuples::length<t1>::value == 3);
|
||||
BOOST_STATIC_ASSERT(tuples::length<t1_cons>::value == 3);
|
||||
BOOST_STATIC_ASSERT(tuples::length<t2>::value == 0);
|
||||
BOOST_STATIC_ASSERT(tuples::length<t3>::value == 0);
|
||||
|
||||
}
|
||||
|
||||
// ----------------------------------------------------------------------------
|
||||
// - testing swap -----------------------------------------------------------
|
||||
// ----------------------------------------------------------------------------
|
||||
void tuple_swap_test()
|
||||
{
|
||||
tuple<int, float, double> t1(1, 2.0f, 3.0), t2(4, 5.0f, 6.0);
|
||||
swap(t1, t2);
|
||||
BOOST_CHECK(get<0>(t1) == 4);
|
||||
BOOST_CHECK(get<1>(t1) == 5.0f);
|
||||
BOOST_CHECK(get<2>(t1) == 6.0);
|
||||
BOOST_CHECK(get<0>(t2) == 1);
|
||||
BOOST_CHECK(get<1>(t2) == 2.0f);
|
||||
BOOST_CHECK(get<2>(t2) == 3.0);
|
||||
|
||||
int i = 1,j = 2;
|
||||
boost::tuple<int&> t3(i), t4(j);
|
||||
swap(t3, t4);
|
||||
BOOST_CHECK(i == 2);
|
||||
BOOST_CHECK(j == 1);
|
||||
}
|
||||
|
||||
|
||||
|
||||
// ----------------------------------------------------------------------------
|
||||
// - main ---------------------------------------------------------------------
|
||||
// ----------------------------------------------------------------------------
|
||||
|
||||
int main() {
|
||||
|
||||
construction_test();
|
||||
element_access_test();
|
||||
copy_test();
|
||||
mutate_test();
|
||||
make_tuple_test();
|
||||
tie_test();
|
||||
equality_test();
|
||||
ordering_test();
|
||||
cons_test();
|
||||
const_tuple_test();
|
||||
tuple_length_test();
|
||||
tuple_swap_test();
|
||||
|
||||
return boost::report_errors();
|
||||
}
|
||||
Reference in New Issue
Block a user