Update copyright years

Bumps [actions/checkout](https://github.com/actions/checkout) from 2 to 6.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v2...v6)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '6'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

.github/dependabot.yml

@@ -0,0 +1,11 @@
+# To get started with Dependabot version updates, you'll need to specify which
+# package ecosystems to update and where the package manifests are located.
+# Please see the documentation for all configuration options:
+# https://docs.github.com/code-security/dependabot/dependabot-version-updates/configuration-options-for-the-dependabot.yml-file
+
+version: 2
+updates:
+  - package-ecosystem: "github-actions" # See documentation for possible values
+    directory: "/" # Location of package manifests
+    schedule:
+        interval: "weekly"

.github/workflows/ci.yml

@@ -0,0 +1,182 @@
+name: CI
+
+on:
+  pull_request:
+  push:
+    branches:
+      - master
+      - develop
+      - feature/**
+
+env:
+  UBSAN_OPTIONS: print_stacktrace=1
+
+jobs:
+  posix:
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - toolset: gcc-14  # Do not remove! It is the only toolset that tests CMake tests down below
+            cxxstd: "03,11,14,17,20"
+            os: ubuntu-24.04
+          - toolset: gcc-12
+            cxxstd: "03,11,14,17,2a"
+            os: ubuntu-22.04
+            cxxflags: "cxxflags=--coverage -fsanitize=address,leak,undefined -fno-sanitize-recover=undefined"
+            linkflags: "linkflags=--coverage -lasan -lubsan"
+            gcov_tool: "gcov-12"
+          - toolset: clang
+            compiler: clang++-14
+            cxxstd: "03,11,14,17,2a"
+            os: ubuntu-22.04
+
+    runs-on: ${{matrix.os}}
+
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Install packages
+        if: matrix.install
+        run: sudo apt install ${{matrix.install}}
+
+      - name: Setup Boost
+        run: |
+          echo GITHUB_REPOSITORY: $GITHUB_REPOSITORY
+          LIBRARY=${GITHUB_REPOSITORY#*/}
+          echo LIBRARY: $LIBRARY
+          echo "LIBRARY=$LIBRARY" >> $GITHUB_ENV
+          echo GITHUB_BASE_REF: $GITHUB_BASE_REF
+          echo GITHUB_REF: $GITHUB_REF
+          REF=${GITHUB_BASE_REF:-$GITHUB_REF}
+          REF=${REF#refs/heads/}
+          echo REF: $REF
+          BOOST_BRANCH=develop && [ "$REF" == "master" ] && BOOST_BRANCH=master || true
+          echo BOOST_BRANCH: $BOOST_BRANCH
+          cd ..
+          git clone -b $BOOST_BRANCH --depth 10 https://github.com/boostorg/boost.git boost-root
+          cd boost-root
+          git submodule update --init --depth 10 --jobs 2 tools/boostdep tools/inspect libs/filesystem
+          python tools/boostdep/depinst/depinst.py --git_args "--depth 10 --jobs 3" filesystem
+          rm -rf libs/$LIBRARY/*
+          cp -r $GITHUB_WORKSPACE/* libs/$LIBRARY
+          python tools/boostdep/depinst/depinst.py --include benchmark --include example --include examples --include tools --git_args "--depth 10 --jobs 3" $LIBRARY
+          ./bootstrap.sh
+          ./b2 -j4 variant=debug tools/inspect
+
+      - name: Run CMake tests
+        if: ${{matrix.toolset == 'gcc-14'}}
+        run: |
+          cd ../boost-root/
+          mkdir __build
+          cd __build
+          cmake -DBUILD_TESTING=1 -DBOOST_INCLUDE_LIBRARIES=conversion -DCMAKE_CXX_COMPILER=g++-14 -DCMAKE_C_COMPILER=gcc-14 ..
+          cmake --build . --target tests
+          ctest --output-on-failure --no-tests=error
+          cd ..
+          rm -rf __build
+
+      - name: Run tests
+        run: |
+          cd ../boost-root
+          ./b2 -j3 libs/$LIBRARY/test toolset=${{matrix.toolset}} cxxstd=${{matrix.cxxstd}} variant=debug,release "${{matrix.cxxflags}}" "${{matrix.linkflags}}" "${{matrix.launcher}}"
+          dist/bin/inspect libs/$LIBRARY
+
+      - name: Prepare coverage data
+        if: matrix.gcov_tool
+        run: |
+          mkdir -p $GITHUB_WORKSPACE/coveralls
+
+          echo -e "#!/bin/bash\nexec ${{matrix.gcov_tool}} \"\$@\"" > $GITHUB_WORKSPACE/coveralls/gcov_wrapper.sh
+          chmod +x $GITHUB_WORKSPACE/coveralls/gcov_wrapper.sh
+          wget https://github.com/linux-test-project/lcov/archive/v1.16.zip
+          unzip v1.16.zip
+          LCOV="`pwd`/lcov-1.16/bin/lcov --gcov-tool $GITHUB_WORKSPACE/coveralls/gcov_wrapper.sh"
+
+          echo "$LCOV --directory ../boost-root/bin.v2/libs/$LIBRARY/ --base-directory `pwd`/libs/$LIBRARY/test --capture --output-file $GITHUB_WORKSPACE/coveralls/coverage.info"
+          $LCOV --directory ../boost-root/bin.v2/libs/$LIBRARY/ --base-directory ../boost-root/ --capture --output-file $GITHUB_WORKSPACE/coveralls/coverage.info
+          $LCOV --remove $GITHUB_WORKSPACE/coveralls/coverage.info "/usr*" "*/$LIBRARY/test/*" ${{matrix.ignore_coverage}} "*/$LIBRARY/tests/*" "*/$LIBRARY/examples/*" "*/$LIBRARY/example/*" -o $GITHUB_WORKSPACE/coveralls/coverage.info
+
+          cd ../boost-root
+          OTHER_LIBS=`grep "submodule .*" .gitmodules | sed 's/\[submodule\ "\(.*\)"\]/"\*\/boost\/\1\.hpp" "\*\/boost\/\1\/\*"/g'| sed "/\"\*\/boost\/$LIBRARY\/\*\"/d" | sed ':a;N;$!ba;s/\n/ /g'`
+          echo $OTHER_LIBS
+          eval "$LCOV --remove $GITHUB_WORKSPACE/coveralls/coverage.info $OTHER_LIBS -o $GITHUB_WORKSPACE/coveralls/coverage.info"
+
+      - name: Coveralls
+        uses: coverallsapp/github-action@master
+        if: matrix.gcov_tool
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          path-to-lcov: ./coveralls/coverage.info
+          parallel: true
+
+  windows:
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - toolset: msvc-14.3
+            cxxstd: "14,17,latest"
+            addrmd: 32,64
+            os: windows-2025
+          - toolset: gcc
+            cxxstd: "03,11,14,17,2a"
+            addrmd: 64
+            os: windows-2025
+
+    runs-on: ${{matrix.os}}
+
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Setup Boost
+        shell: cmd
+        run: |
+          echo GITHUB_REPOSITORY: %GITHUB_REPOSITORY%
+          for /f %%i in ("%GITHUB_REPOSITORY%") do set LIBRARY=%%~nxi
+          echo LIBRARY: %LIBRARY%
+          echo LIBRARY=%LIBRARY%>>%GITHUB_ENV%
+          echo GITHUB_BASE_REF: %GITHUB_BASE_REF%
+          echo GITHUB_REF: %GITHUB_REF%
+          if "%GITHUB_BASE_REF%" == "" set GITHUB_BASE_REF=%GITHUB_REF%
+          set BOOST_BRANCH=develop
+          for /f %%i in ("%GITHUB_BASE_REF%") do if "%%~nxi" == "master" set BOOST_BRANCH=master
+          echo BOOST_BRANCH: %BOOST_BRANCH%
+          cd ..
+          git clone -b %BOOST_BRANCH% --depth 10 https://github.com/boostorg/boost.git boost-root
+          cd boost-root
+          xcopy /s /e /q %GITHUB_WORKSPACE% libs\%LIBRARY%\
+          git submodule update --init tools/boostdep
+          python tools/boostdep/depinst/depinst.py --include benchmark --include example --include examples --include tools --git_args "--jobs 3" %LIBRARY%
+          cmd /c bootstrap
+
+      - name: Run CMake tests
+        if: ${{matrix.toolset == 'msvc-14.3'}}
+        shell: cmd
+        run: |
+          choco install --no-progress ninja
+          call "C:/Program Files/Microsoft Visual Studio/2022/Enterprise/VC/Auxiliary/Build/vcvarsall.bat" x64
+          cd ../boost-root/
+          mkdir __build
+          cd __build
+          cmake -DBUILD_TESTING=1 -DBOOST_INCLUDE_LIBRARIES=conversion ..
+          cmake --build . --target tests --config Debug
+          ctest --output-on-failure --no-tests=error -C Debug
+          cd ..
+          rm -rf __build
+
+      - name: Run tests
+        shell: cmd
+        run: |
+          cd ../boost-root
+          b2 -j3 libs/%LIBRARY%/test toolset=${{matrix.toolset}} cxxstd=${{matrix.cxxstd}} address-model=${{matrix.addrmd}} variant=debug,release
+
+  finish:
+    needs: posix
+    runs-on: ubuntu-latest
+    steps:
+    - name: Coveralls Finished
+      uses: coverallsapp/github-action@master
+      with:
+        github-token: ${{ secrets.github_token }}
+        parallel-finished: true

.travis.yml

@@ -1,88 +0,0 @@
-# Use, modification, and distribution are
-# subject to 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)
-#
-# Copyright Antony Polukhin 2014-2015.
-
-#
-# See https://svn.boost.org/trac/boost/wiki/TravisCoverals for description of this file
-# and how it can be used with Boost libraries.
-#
-
-language: cpp
-os:
-    - linux
-
-env:
-    - CXX_STANDARD=c++98
-    - CXX_STANDARD=c++0x
-
-before_install:
-    # Set this to the name of your Boost library
-    # Autodetect library name by using the following code: - PROJECT_TO_TEST=$(basename $(pwd))
-    - PROJECT_TO_TEST=$(basename $(pwd))
-
-    # Autodetect Boost branch by using the following code: - BRANCH_TO_TEST=`git rev-parse --abbrev-ref HEAD`
-    # or by - BRANCH_TO_TEST=$TRAVIS_BRANCH or just directly specify it
-    - BRANCH_TO_TEST=$TRAVIS_BRANCH
-
-    # Files, which coverage results must be ignored (files from other projects). Example: - IGNORE_COVERAGE=
-    - IGNORE_COVERAGE=
-
-
-    # From this point and below code is same for all the Boost libs
-    # Cloning Boost libraries (fast nondeep cloning)
-    - PROJECT_DIR=`pwd`
-    - BOOST=$HOME/boost-local
-    - git init $BOOST
-    - cd $BOOST
-    - git remote add --no-tags -t $BRANCH_TO_TEST origin https://github.com/boostorg/boost.git
-    - git fetch --depth=1
-    - git checkout $BRANCH_TO_TEST
-    - git submodule update --init --merge
-    - git remote set-branches --add origin $BRANCH_TO_TEST
-    - git pull --recurse-submodules
-    - git submodule update --init
-    - git checkout $BRANCH_TO_TEST
-    - git submodule foreach "git reset --quiet --hard; git clean -fxd"
-    - git reset --hard; git clean -fxd
-    - git status
-    - rm -rf $BOOST/libs/$PROJECT_TO_TEST
-    - mv $PROJECT_DIR/../$PROJECT_TO_TEST/ $BOOST/libs/$PROJECT_TO_TEST
-    - PROJECT_DIR=$BOOST/libs/$PROJECT_TO_TEST
-    - ./bootstrap.sh
-    - ./b2 headers
-    - sudo apt-get update -qq
-    - sudo apt-get install -qq valgrind
-
-script:
-    - if [ "$CCFLAGS" != "" ]; then FLAGS="cxxflags=\"$CCFLAGS\" linkflags=\"$LINKFLAGS\""; else FLAGS=""; fi
-    - cd $BOOST/libs/$PROJECT_TO_TEST/test/
-    # `--coverage` flags required to generate coverage info for Coveralls
-    - ../../../b2 testing.launcher=valgrind cxxflags="--coverage -std=$CXX_STANDARD" linkflags="--coverage"
-
-after_success:
-    # Copying Coveralls data to a separate folder
-    - mkdir -p $PROJECT_DIR/coverals
-    - find ../../../bin.v2/ -name "*.gcda" -exec cp "{}" $PROJECT_DIR/coverals/ \;
-    - find ../../../bin.v2/ -name "*.gcno" -exec cp "{}" $PROJECT_DIR/coverals/ \;
-
-    # Preparing Coveralls data by
-    # ... installing the tools
-    - sudo apt-get install -qq python-yaml lcov
-    # ... changind data format to a readable one
-    - lcov --directory $PROJECT_DIR/coverals --base-directory ./ --capture --output-file $PROJECT_DIR/coverals/coverage.info
-
-    # ... erasing /test/ /example/ folder data
-    - cd $BOOST
-    - lcov --remove $PROJECT_DIR/coverals/coverage.info "/usr*" "*/$PROJECT_TO_TEST/test/*" $IGNORE_COVERAGE "*/$PROJECT_TO_TEST/tests/*" "*/$PROJECT_TO_TEST/examples/*" "*/$PROJECT_TO_TEST/example/*" -o $PROJECT_DIR/coverals/coverage.info
-
-    # ... erasing data that is not related to this project directly
-    - OTHER_LIBS=`grep "submodule .*" .gitmodules | sed 's/\[submodule\ "\(.*\)"\]/"\*\/boost\/\1\.hpp" "\*\/boost\/\1\/\*"/g'| sed "/\"\*\/boost\/$PROJECT_TO_TEST\/\*\"/d" | sed ':a;N;$!ba;s/\n/ /g'`
-    - echo $OTHER_LIBS
-    - eval "lcov --remove $PROJECT_DIR/coverals/coverage.info $OTHER_LIBS -o $PROJECT_DIR/coverals/coverage.info"
-
-    # Sending data to Coveralls
-    - cd $PROJECT_DIR
-    - gem install coveralls-lcov
-    - coveralls-lcov coverals/coverage.info

CMakeLists.txt

@@ -0,0 +1,22 @@
+# Copyright 2019 Mike Dev
+# Distributed under the Boost Software License, Version 1.0.
+# See accompanying file LICENSE_1_0.txt or copy at https://www.boost.org/LICENSE_1_0.txt
+
+cmake_minimum_required( VERSION 3.5...4.20 )
+project( boost_conversion VERSION "${BOOST_SUPERPROJECT_VERSION}" LANGUAGES CXX )
+
+add_library( boost_conversion INTERFACE )
+add_library( Boost::conversion ALIAS boost_conversion )
+
+target_include_directories( boost_conversion INTERFACE include )
+
+target_link_libraries( boost_conversion
+    INTERFACE
+        Boost::assert
+        Boost::config
+        Boost::throw_exception
+)
+
+if(BUILD_TESTING)
+  add_subdirectory(test)
+endif()

README.md

@@ -1,16 +1,15 @@
-#[Boost.Conversion](http://boost.org/libs/conversion)
-Boost.Conversion is one of the [Boost C++ Libraries](http://github.com/boostorg). This library improves program safety and clarity by performing otherwise messy conversions. 
+# [Boost.Conversion](https://boost.org/libs/conversion)
+Boost.Conversion is one of the [Boost C++ Libraries](https://github.com/boostorg). This library improves program safety and clarity by performing otherwise messy conversions. 
 
 ### Test results
 
 @               | Build         | Tests coverage | More info
 ----------------|-------------- | -------------- |-----------
-Develop branch: | [![Build Status](https://travis-ci.org/apolukhin/conversion.svg?branch=develop)](https://travis-ci.org/apolukhin/conversion)  | [![Coverage Status](https://coveralls.io/repos/apolukhin/conversion/badge.png?branch=develop)](https://coveralls.io/r/apolukhin/conversion?branch=develop) | [details...](http://www.boost.org/development/tests/develop/developer/conversion.html)
-Master branch:  | [![Build Status](https://travis-ci.org/apolukhin/conversion.svg?branch=master)](https://travis-ci.org/apolukhin/conversion)  | [![Coverage Status](https://coveralls.io/repos/apolukhin/conversion/badge.png?branch=master)](https://coveralls.io/r/apolukhin/conversion?branch=master) | [details...](http://www.boost.org/development/tests/master/developer/conversion.html)
+Develop branch: | [![CI](https://github.com/boostorg/conversion/actions/workflows/ci.yml/badge.svg?branch=develop)](https://github.com/boostorg/conversion/actions/workflows/ci.yml) [![Build status](https://ci.appveyor.com/api/projects/status/1cky1hrunfa46bdx/branch/develop?svg=true)](https://ci.appveyor.com/project/apolukhin/conversion/branch/develop) | [![Coverage Status](https://coveralls.io/repos/github/boostorg/conversion/badge.svg?branch=develop)](https://coveralls.io/github/boostorg/conversion?branch=develop) | [details...](https://regression.boost.io/develop/developer/conversion.html)
+Master branch:  | [![CI](https://github.com/boostorg/conversion/actions/workflows/ci.yml/badge.svg?branch=master)](https://github.com/boostorg/conversion/actions/workflows/ci.yml) [![Build status](https://ci.appveyor.com/api/projects/status/1cky1hrunfa46bdx/branch/master?svg=true)](https://ci.appveyor.com/project/apolukhin/conversion/branch/master) | [![Coverage Status](https://coveralls.io/repos/github/boostorg/conversion/badge.svg?branch=master)](https://coveralls.io/github/boostorg/conversion?branch=master) | [details...](https://regression.boost.io/master/developer/conversion.html)
 
-
-[Open Issues](https://svn.boost.org/trac/boost/query?status=!closed&component=conversion&or&status=!closed&component=lexical_cast)
+[Latest developer documentation](https://www.boost.org/doc/libs/develop/doc/html/conversion.html)
 
 ### License
 
-Distributed under the [Boost Software License, Version 1.0](http://boost.org/LICENSE_1_0.txt).
+Distributed under the [Boost Software License, Version 1.0](https://boost.org/LICENSE_1_0.txt).

build.jam

@@ -0,0 +1,25 @@
+# Copyright René Ferdinand Rivera Morell 2023-2024
+# 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)
+
+require-b2 5.2 ;
+
+constant boost_dependencies :
+    /boost/assert//boost_assert
+    /boost/config//boost_config
+    /boost/throw_exception//boost_throw_exception ;
+
+project /boost/conversion
+    : common-requirements
+        <include>include
+    ;
+
+explicit
+    [ alias boost_conversion : : : : <library>$(boost_dependencies) ]
+    [ alias all : boost_conversion test ]
+    ;
+
+call-if : boost-library conversion
+    ;
+

cast.htm

@@ -1,196 +0,0 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
-
-<html>
-  <head>
-    <meta name="generator" content=
-    "Microsoft FrontPage 5.0">
-    <meta http-equiv="Content-Type" content=
-    "text/html; charset=windows-1252">
-    <meta name="GENERATOR" content="Microsoft FrontPage 4.0">
-    <meta name="ProgId" content="FrontPage.Editor.Document">
-
-    <title>Header boost/polymorphic_cast.hpp Documentation</title>
-    <style>
-       .copyright
-        {
-            color: #666666;
-            font-size: small;
-        }
-    </style>
-  </head>
-
-  <body bgcolor="#FFFFFF" text="#000000">
-    <h1><img src="../../boost.png" alt="boost.png (6897 bytes)" align=
-    "middle" width="277" height="86">Header <a href=
-    "../../boost/polymorphic_cast.hpp">boost/polymorphic_cast.hpp</a></h1>
-
-    <h2><a name="Cast Functions">Cast Functions</a></h2>
-
-    <p>The header <a href="../../boost/polymorphic_cast.hpp">boost/polymorphic_cast.hpp</a> provides
-    <code><a href="#Polymorphic_cast">polymorphic_cast</a></code> and
-    <code><a href="#Polymorphic_cast">polymorphic_downcast</a></code>
-    function templates designed to complement the C++ built-in casts.</p> <p>The header <a href="../../boost/polymorphic_pointer_cast.hpp">boost/polymorphic_pointer_cast.hpp</a> provides
-    <code><a href="#Polymorphic_cast">polymorphic_pointer_cast</a></code> and
-    <code><a href="#Polymorphic_cast">polymorphic_pointer_downcast</a></code> function templates.
-
-    <p>The program <a href="test/cast_test.cpp">cast_test.cpp</a> can be used to
-    verify these function templates work as expected.</p>
-
-    <h3><a name="Polymorphic_cast">Polymorphic casts</a></h3>
-
-    <p>Pointers to polymorphic objects (objects of classes which define at
-    least one virtual function) are sometimes downcast or crosscast.
-    Downcasting means casting from a base class to a derived class.
-    Crosscasting means casting across an inheritance hierarchy diagram, such
-    as from one base to the other in a <code>Y</code> diagram hierarchy.</p>
-
-    <p>Such casts can be done with old-style casts, but this approach is
-    never to be recommended. Old-style casts are sorely lacking in type
-    safety, suffer poor readability, and are difficult to locate with search
-    tools.</p>
-
-    <p>The C++ built-in <code>static_cast</code> can be used for efficiently
-    downcasting pointers to polymorphic objects, but provides no error
-    detection for the case where the pointer being cast actually points to
-    the wrong derived class. The <code>polymorphic_downcast</code> template retains
-    the efficiency of <code>static_cast</code> for non-debug compilations, but for
-    debug compilations adds safety via an assert() that a <code>dynamic_cast</code>
-    succeeds.</p>
-
-    <p>The C++ built-in <code>dynamic_cast</code> can be used for downcasts and
-    crosscasts of pointers to polymorphic objects, but error notification in
-    the form of a returned value of 0 is inconvenient to test, or worse yet,
-    easy to forget to test. The throwing form of <code>dynamic_cast</code>, which
-    works on references, can be used on pointers through the ugly expression
-    &amp;<code>dynamic_cast&lt;T&amp;&gt;(*p)</code>, which causes undefined
-    behavior if <code>p</code> is <code>0</code>. The <code>polymorphic_cast</code>
-    template performs a <code>dynamic_cast</code> on a pointer, and throws an
-    exception if the <code>dynamic_cast</code> returns 0.</p>
-
-    <p>A <code>polymorphic_downcast</code> should be used for
-    downcasts that you are certain should succeed.  Error checking is
-    only performed in translation units where <code>NDEBUG</code> is
-    not defined, via
-<pre>  assert( dynamic_cast&lt;Derived&gt;(x) == x )
-</pre> where <code>x</code> is the source pointer.  This approach
-    ensures that not only is a non-zero pointer returned, but also
-    that it is correct in the presence of multiple inheritance.
-    Attempts to crosscast using <code>polymorphic_downcast</code> will
-    fail to compile.
-    <b>Warning:</b> Because <code>polymorphic_downcast</code> uses assert(), it
-    violates the One Definition Rule (ODR) if NDEBUG is inconsistently
-    defined across translation units. [See ISO Std 3.2]
-    <p>
-    For crosscasts, or when the success of a cast can only be known at
-    runtime, or when efficiency is not important,
-    <code>polymorphic_cast</code> is preferred. </p>
-
-    <p>The C++ built-in <code>dynamic_cast</code> must be used to cast references
-    rather than pointers. It is also the only cast that can be used to check
-    whether a given interface is supported; in that case a return of 0 isn't
-    an error condition.</p>
-
-    <p>While <code>polymorphic_downcast</code> and <code>polymorphic_cast</code> work with built-in pointer types only,
-    <code>polymorphic_pointer_downcast</code> and <code>polymorphic_pointer_cast</code> are more generic versions
-    with support for any pointer type for which the following expressions would be valid:<br><br>
-
-    <p> For <code>polymorphic_pointer_downcast</code>:</p>
-    <code>&nbsp;&nbsp;static_pointer_cast&lt;Derived&gt;(p);<br>&nbsp;&nbsp;dynamic_pointer_cast&lt;Derived&gt;(p);</code><br><br>
-
-    <p> For <code>polymorphic_pointer_cast</code>:</p>
-    <code>&nbsp;&nbsp;dynamic_pointer_cast&lt;Derived&gt;(p);<br>&nbsp;&nbsp;!p; // conversion to bool with negation</code><br><br>
-    <p>This includes C++ built-in pointers, <code>std::shared_ptr, boost::shared_ptr, boost::intrusive_ptr</code>, etc.</p>
-
-    <h3>polymorphic_cast, polymorphic_downcast, polymorphic_pointer_cast and polymorphic_pointer_downcast synopsis</h3>
-
-    <blockquote>
-<pre>namespace boost {
-
-template &lt;class Derived, class Base&gt;
-inline Derived polymorphic_cast(Base* x);
-// Throws: std::bad_cast if ( dynamic_cast&lt;Derived&gt;(x) == 0 )
-// Returns: dynamic_cast&lt;Derived&gt;(x)
-
-template &lt;class Derived, class Base&gt;
-inline Derived polymorphic_downcast(Base* x);
-// Effects: assert( dynamic_cast&lt;Derived&gt;(x) == x );
-// Returns: static_cast&lt;Derived&gt;(x)
-
-template &lt;class Derived, class Base&gt;
-inline auto polymorphic_pointer_cast(Base x);
-// Throws: std::bad_cast if ( dynamic_pointer_cast&lt;Derived&gt;(x) == 0 )
-// Returns: dynamic_pointer_cast&lt;Derived&gt;(x)
-
-template &lt;class Derived, class Base&gt;
-inline auto polymorphic_pointer_downcast(Base x);
-// Effects: assert( dynamic_pointer_cast&lt;Derived&gt;(x) == x );
-// Returns: static_pointer_cast&lt;Derived&gt;(x)
-
-}
-</pre>
-    </blockquote>
-
-    <h3>polymorphic_downcast example</h3>
-
-    <blockquote>
-<pre>#include &lt;boost/polymorphic_cast.hpp&gt;
-...
-class Fruit { public: virtual ~Fruit(){}; ... };
-class Banana : public Fruit { ... };
-...
-void f( Fruit * fruit ) {
-// ... logic which leads us to believe it is a Banana
-  Banana * banana = boost::polymorphic_downcast&lt;Banana*&gt;(fruit);
-  ...
-</pre>
-    </blockquote>
-
-    <h3>polymorphic_pointer_downcast example</h3>
-
-    <blockquote>
-<pre>#include &lt;boost/polymorphic_pointer_cast.hpp&gt;
-
-class Fruit { public: virtual ~Fruit(){} };
-class Banana : public Fruit {};
-
-// use one of these:
-
-typedef Fruit* FruitPtr;
-typedef std::shared_ptr&lt;Fruit&gt; FruitPtr;
-typedef boost::shared_ptr&lt;Fruit&gt; FruitPtr;
-typedef boost::intrusive_ptr&lt;Fruit&gt; FruitPtr;
-
-void f(FruitPtr fruit)
-{
-  // ... logic which leads us to believe it is a banana
-  auto banana = boost::polymorphic_pointer_downcast&lt;Banana&gt;(fruit);
-  ...
-}
-</pre>
-    </blockquote>
-
-    <h3>History</h3>
-
-    <p><code>polymorphic_cast</code> was suggested by Bjarne Stroustrup in "The C++
-    Programming Language".<br>
-     <code>polymorphic_downcast</code> was contributed by <a href=
-    "http://www.boost.org/people/dave_abrahams.htm">Dave Abrahams</a>.<br>
-     <code>polymorphic_pointer_downcast</code> was contributed by <a href=
-    "http://www.boost.org/people/boris_rasin.htm">Boris Rasin</a> and
-    <code>polymorphic_pointer_cast</code> by Antony Polukhin.<br>
-     An old
-     <code>numeric_cast</code> that was contributed by <a href=
-    "http://www.boost.org/people/kevlin_henney.htm">Kevlin Henney</a> is now superseeded by the <a href="../numeric/conversion/doc/html/index.html">Boost Numeric Conversion Library</a></p>
-    <hr>
-
-    <p>Revised
-    <!--webbot bot="Timestamp" s-type="EDITED" s-format="%d %B, %Y" startspan
-                    -->June 23, 2005<!--webbot bot="Timestamp" endspan i-checksum="30348"
-                    --></p>
-
-    <p class="copyright">&copy; Copyright boost.org 1999. 
-    Distributed under the Boost Software License, Version 1.0. (See accompanying
-    file LICENSE_1_0.txt or copy at <a href="http://www.boost.org/LICENSE_1_0.txt">http://www.boost.org/LICENSE_1_0.txt</a>)
-    </p>
-  </body>
-</html>

doc/Jamfile.v2

@@ -0,0 +1,38 @@
+#   Copyright (c) 2016 Mikhail Maximov <vigorous.activity -at- gmail.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)
+
+project doc/conversion ;
+
+using quickbook ;
+import boostbook ;
+
+xml conversion : conversion.qbk ;
+boostbook standalone
+    :
+        conversion
+    :
+        <xsl:param>boost.root=../../../..
+        # File name of HTML output:
+        <xsl:param>root.filename=conversion
+        # 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=2
+        # Max depth in each TOC:
+        <xsl:param>toc.max.depth=2
+        # How far down we go with TOC's
+        <xsl:param>generate.section.toc.level=0
+
+        <xsl:param>generate.manifest=0
+     ;
+
+###############################################################################
+alias boostdoc : conversion ;
+explicit boostdoc ;
+alias boostrelease ;
+explicit boostrelease ;

doc/conversion.qbk

@@ -0,0 +1,215 @@
+[/
+    Copyright 2016 Mikhail Maximov.
+    Copyright Antony Polukhin, 2020-2026.
+
+    Distributed under the Boost Software License, Version 1.0. (See accompanying
+    file LICENSE_1_0.txt or copy at <a href="http://www.boost.org/LICENSE_1_0.txt">http://www.boost.org/LICENSE_1_0.txt</a>)
+]
+
+[article The Conversion Library
+    [quickbook 1.6]
+    [compatibility-mode 1.5]
+    [id conversion]
+    [version 1.7]
+    [authors [Stroustrup, Bjarne], [Abrahams, Dave], [Rasin, Boris], [Polukhin, Antony]]
+    [copyright 2001 Beman Dawes, 2014-2026 Antony Polukhin]
+    [license
+        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])
+    ]
+    [source-mode c++]
+]
+
+[/ QuickBook Document version 1.5 ]
+[/ Dec, 2016 ]
+
+[section Description]
+
+The Conversion Library improves program safety and clarity by performing
+otherwise messy conversions. It includes cast-style function templates designed 
+to complement the C++ Standard's built-in casts.
+
+To reduce coupling, the Boost Conversion Library is supplied by several headers:
+
+# The [@boost:boost/polymorphic_cast.hpp boost/polymorphic_cast.hpp] header
+  provides [link polymorphic_cast `polymorphic_cast<>`] and
+  [link polymorphic_downcast `polymorphic_downcast<>`]
+  to perform safe casting between polymorphic types.
+# The [@boost:boost/polymorphic_pointer_cast.hpp boost/polymorphic_pointer_cast.hpp] header
+  provides [link polymorphic_pointer_cast `polymorphic_pointer_cast<>`] and
+  [link polymorphic_pointer_cast `polymorphic_pointer_downcast<>`]
+# The [@boost:boost/implicit_cast.hpp boost/implicit_cast.hpp] header provides `implicit_cast<>` 
+  to perform implicit casts only (no down-cast, no void*->T*, no U->T if T has only explicit constructors for U).
+
+[endsect]
+
+[section Polymorphic casts]
+Pointers to polymorphic objects (objects of classes which define at
+least one virtual function) are sometimes downcast or crosscast.
+Downcasting means casting from a base class to a derived class.
+Crosscasting means casting across an inheritance hierarchy diagram, such
+as from one base to the other in a [^Y] diagram hierarchy.
+
+Such casts can be done with old-style casts, but this approach is
+never to be recommended. Old-style casts are sorely lacking in type
+safety, suffer poor readability, and are difficult to locate with search
+tools.
+
+[#polymorphic_downcast]
+[section polymorphic_downcast]
+
+The C++ built-in `static_cast` can be used for efficiently
+downcasting pointers to polymorphic objects, but provides no error
+detection for the case where the pointer being cast actually points to
+the wrong derived class. The `polymorphic_downcast` template retains
+the efficiency of `static_cast` for non-debug compilations, but for
+debug compilations adds safety via an `assert()` that a `dynamic_cast`
+succeeds.
+
+A `polymorphic_downcast` should be used for
+downcasts that you are certain should succeed. Error checking is
+only performed in translation units where `NDEBUG` is
+not defined, via
+```
+    assert( dynamic_cast<Derived>(x) == x )
+```
+where `x` is the source pointer.  This approach
+ensures that not only is a non-zero pointer returned, but also
+that it is correct in the presence of multiple inheritance.
+Attempts to crosscast using `polymorphic_downcast` will
+fail to compile.
+
+[warning Because `polymorphic_downcast` uses `assert()`, it
+violates the One Definition Rule (ODR) if `NDEBUG` is inconsistently
+defined across translation units. See ISO Std 3.2]
+
+[h4 Example:]
+```
+    #include <boost/polymorphic_cast.hpp>
+    ...
+    class Fruit { public: virtual ~Fruit(){}; ... };
+    class Banana : public Fruit { ... };
+    ...
+    void f( Fruit * fruit ) {
+      // ... logic which leads us to believe it is a Banana
+      Banana * banana = boost::polymorphic_downcast<Banana*>(fruit);
+      ...
+    }
+```
+[endsect]
+
+[#polymorphic_cast]
+[section polymorphic_cast]
+
+The C++ built-in `dynamic_cast` can be used for downcasts and
+crosscasts of pointers to polymorphic objects, but error notification in
+the form of a returned value of 0 is inconvenient to test, or worse yet,
+easy to forget to test. The throwing form of `dynamic_cast`, which
+works on references, can be used on pointers through the ugly expression
+`&dynamic_cast<T&>(*p)`, which causes undefined
+behavior if `p` is `0`. The `polymorphic_cast`
+template performs a `dynamic_cast` on a pointer, and throws an
+exception if the `dynamic_cast` returns 0.
+
+For crosscasts, or when the success of a cast can only be known at runtime, 
+or when efficiency is not important, `polymorphic_cast` is preferred.
+
+The C++ built-in `dynamic_cast` must be used to cast references rather than pointers.
+It is also the only cast that can be used to check whether a given interface is supported; in that case a return of 0 isn't an error condition.
+
+[endsect]
+
+
+[#polymorphic_pointer_cast]
+[section polymorphic_pointer_cast]
+While `polymorphic_downcast` and `polymorphic_cast` work with built-in pointer types only,
+`polymorphic_pointer_downcast` and `polymorphic_pointer_cast` are more generic versions
+with support for any pointer type for which the following expressions would be valid:
+
+For `polymorphic_pointer_downcast`:
+```
+    static_pointer_cast<Derived>(p);
+    dynamic_pointer_cast<Derived>(p);
+```
+For `polymorphic_pointer_cast`:
+```
+    dynamic_pointer_cast<Derived>(p);
+    !p; // conversion to bool with negation
+```
+
+This includes C++ built-in pointers, `std::shared_ptr`,
+`boost::shared_ptr`, `boost::intrusive_ptr`, etc.
+
+
+[h4 Example:]
+```
+    #include <boost/polymorphic_pointer_cast.hpp>
+
+    class Fruit { public: virtual ~Fruit(){} };
+    class Banana : public Fruit {};
+
+    // Use one of these:
+    using FruitPtr = Fruit*;
+    using FruitPtr = std::shared_ptr<Fruit>;
+    using FruitPtr = boost::shared_ptr<Fruit>;
+    using FruitPtr = boost::intrusive_ptr<Fruit>;
+
+    void f(FruitPtr fruit) {
+      // ... logic which leads us to believe it is a banana
+      auto banana = boost::polymorphic_pointer_downcast<Banana>(fruit);
+      ...
+    }
+```
+
+[endsect]
+
+[endsect]
+
+[section Synopsis]
+```
+    namespace boost {
+
+    // Throws: std::bad_cast if ( dynamic_cast<Derived>(x) == 0 )
+    // Returns: dynamic_cast<Derived>(x)
+    template <class Derived, class Base>
+    constexpr Derived polymorphic_cast(Base* x);
+
+    // Effects: assert( dynamic_cast<Derived>(x) == x );
+    // Returns: static_cast<Derived>(x)
+    template <class Derived, class Base>
+    constexpr Derived polymorphic_downcast(Base* x);
+
+    // Effects: assert( dynamic_cast<Derived>(&x) == &x );
+    // Returns: static_cast<Derived>(x)
+    template <class Derived, class Base>
+    constexpr Derived polymorphic_downcast(Base& x);
+
+    // Throws: std::bad_cast if ( dynamic_pointer_cast<Derived>(x) == 0 )
+    // Returns: dynamic_pointer_cast<Derived>(x)
+    template <class Derived, class Base>
+    inline auto polymorphic_pointer_cast(Base x);
+
+    // Effects: assert( dynamic_pointer_cast<Derived>(x) == x );
+    // Returns: static_pointer_cast<Derived>(x)
+    template <class Derived, class Base>
+    inline auto polymorphic_pointer_downcast(Base x);
+
+    }
+```
+[endsect]
+
+
+[section History]
+`polymorphic_cast` was suggested by Bjarne Stroustrup in "The C++ Programming Language".
+
+`polymorphic_downcast` was contributed by [@http://www.boost.org/people/dave_abrahams.htm Dave Abrahams].
+
+`polymorphic_pointer_downcast` was contributed by [@http://www.boost.org/people/boris_rasin.htm Boris Rasin]
+and `polymorphic_pointer_cast` by Antony Polukhin.
+
+`polymorphic_downcast` overload for references was contributed by Julien Delacroix.
+
+An old `numeric_cast` that was contributed by [@http://www.boost.org/people/kevlin_henney.htm Kevlin Henney]
+is now superseded by the [@boost:numeric_conversion/doc/html/html/boost_numericconversion/improved_numeric_cast__.html Boost Numeric Conversion Library]
+[endsect]

include/boost/implicit_cast.hpp

@@ -2,8 +2,14 @@
 // 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)
-#ifndef IMPLICIT_CAST_DWA200356_HPP
-# define IMPLICIT_CAST_DWA200356_HPP
+
+#ifndef BOOST_IMPLICIT_CAST_DWA200356_HPP
+#define BOOST_IMPLICIT_CAST_DWA200356_HPP
+
+#include <boost/config.hpp>
+#ifdef BOOST_HAS_PRAGMA_ONCE
+# pragma once
+#endif
 
 namespace boost {
 
@@ -11,7 +17,7 @@ namespace detail {
 
 template<class T> struct icast_identity
 {
-    typedef T type;
+    using type = T;
 };
 
 } // namespace detail
@@ -22,15 +28,11 @@ template<class T> struct icast_identity
 // The use of identity creates a non-deduced form, so that the
 // explicit template argument must be supplied
 template <typename T>
-inline T implicit_cast (typename boost::detail::icast_identity<T>::type x) {
+constexpr T implicit_cast (typename boost::detail::icast_identity<T>::type x) {
     return x;
 }
 
-// incomplete return type now is here
-//template <typename T>
-//void implicit_cast (...);
-
 } // namespace boost
 
 
-#endif // IMPLICIT_CAST_DWA200356_HPP
+#endif // BOOST_IMPLICIT_CAST_DWA200356_HPP

include/boost/polymorphic_cast.hpp

@@ -14,7 +14,7 @@
 //  08 Nov 14  Add polymorphic_pointer_downcast (Boris Rasin)
 //  09 Jun 14  "cast.hpp" was renamed to "polymorphic_cast.hpp" and
 //             inclusion of numeric_cast was removed (Antony Polukhin)
-//  23 Jun 05  numeric_cast removed and redirected to the new verion (Fernando Cacciola)
+//  23 Jun 05  numeric_cast removed and redirected to the new version (Fernando Cacciola)
 //  02 Apr 01  Removed BOOST_NO_LIMITS workarounds and included
 //             <boost/limits.hpp> instead (the workaround did not
 //             actually compile when BOOST_NO_LIMITS was defined in
@@ -31,7 +31,7 @@
 //  19 Oct 00  Fix numeric_cast for floating-point types (Dave Abrahams)
 //  15 Jul 00  Suppress numeric_cast warnings for GCC, Borland and MSVC
 //             (Dave Abrahams)
-//  30 Jun 00  More MSVC6 wordarounds.  See comments below.  (Dave Abrahams)
+//  30 Jun 00  More MSVC6 workarounds.  See comments below.  (Dave Abrahams)
 //  28 Jun 00  Removed implicit_cast<>.  See comment below. (Beman Dawes)
 //  27 Jun 00  More MSVC6 workarounds
 //  15 Jun 00  Add workarounds for MSVC6
@@ -49,15 +49,25 @@
 #ifndef BOOST_POLYMORPHIC_CAST_HPP
 #define BOOST_POLYMORPHIC_CAST_HPP
 
-# include <boost/config.hpp>
-# include <boost/assert.hpp>
-# include <boost/throw_exception.hpp>
-# include <typeinfo>
+#include <boost/config.hpp>
 
 #ifdef BOOST_HAS_PRAGMA_ONCE
 #   pragma once
 #endif
 
+# include <boost/assert.hpp>
+# include <boost/throw_exception.hpp>
+
+# include <memory>  // std::addressof
+# include <typeinfo>
+# include <type_traits>
+
+#if defined(__cpp_constexpr) && __cpp_constexpr >= 201907L
+#define BOOST_CONVERSION_IMPL_CONSTEXPR_DYN_CAST constexpr
+#else
+#define BOOST_CONVERSION_IMPL_CONSTEXPR_DYN_CAST inline
+#endif
+
 namespace boost
 {
 //  See the documentation for descriptions of how to choose between
@@ -70,7 +80,7 @@ namespace boost
     //  section 15.8 exercise 1, page 425.
 
     template <class Target, class Source>
-    inline Target polymorphic_cast(Source* x)
+    BOOST_CONVERSION_IMPL_CONSTEXPR_DYN_CAST Target polymorphic_cast(Source* x)
     {
         Target tmp = dynamic_cast<Target>(x);
         if ( tmp == 0 ) boost::throw_exception( std::bad_cast() );
@@ -79,7 +89,7 @@ namespace boost
 
 //  polymorphic_downcast  ----------------------------------------------------//
 
-    //  BOOST_ASSERT() checked polymorphic downcast.  Crosscasts prohibited.
+    //  BOOST_ASSERT() checked raw pointer polymorphic downcast.  Crosscasts prohibited.
 
     //  WARNING: Because this cast uses BOOST_ASSERT(), it violates
     //  the One Definition Rule if used in multiple translation units
@@ -89,12 +99,34 @@ namespace boost
     //  Contributed by Dave Abrahams
 
     template <class Target, class Source>
-    inline Target polymorphic_downcast(Source* x)
+    BOOST_CONVERSION_IMPL_CONSTEXPR_DYN_CAST Target polymorphic_downcast(Source* x)
     {
         BOOST_ASSERT( dynamic_cast<Target>(x) == x );  // detect logic error
         return static_cast<Target>(x);
     }
 
+    //  BOOST_ASSERT() checked reference polymorphic downcast.  Crosscasts prohibited.
+
+    //  WARNING: Because this cast uses BOOST_ASSERT(), it violates
+    //  the One Definition Rule if used in multiple translation units
+    //  where BOOST_DISABLE_ASSERTS, BOOST_ENABLE_ASSERT_HANDLER
+    //  NDEBUG are defined inconsistently.
+
+    //  Contributed by Julien Delacroix
+
+    template <class Target, class Source>
+    BOOST_CONVERSION_IMPL_CONSTEXPR_DYN_CAST typename std::enable_if<
+        std::is_reference<Target>::value, Target
+    >::type polymorphic_downcast(Source& x)
+    {
+        using target_pointer_type = typename std::remove_reference<Target>::type*;
+        return *boost::polymorphic_downcast<target_pointer_type>(
+            std::addressof(x)
+        );
+    }
+
 } // namespace boost
 
+#undef BOOST_CONVERSION_IMPL_CONSTEXPR_DYN_CAST
+
 #endif  // BOOST_POLYMORPHIC_CAST_HPP

include/boost/polymorphic_pointer_cast.hpp

@@ -1,5 +1,6 @@
 //  boost polymorphic_pointer_cast.hpp header file  ----------------------------------------------//
-//  (C) Copyright Boris Rasin and Antony Polukhin 2014-2015.
+//  (C) Copyright Boris Rasin, 2014-2021.
+//  (C) Copyright Antony Polukhin, 2014-2026.
 //  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)
@@ -9,19 +10,16 @@
 #ifndef BOOST_CONVERSION_POLYMORPHIC_POINTER_CAST_HPP
 #define BOOST_CONVERSION_POLYMORPHIC_POINTER_CAST_HPP
 
-# include <boost/config.hpp>
-# include <boost/assert.hpp>
-# include <boost/pointer_cast.hpp>
-# include <boost/throw_exception.hpp>
-# include <boost/utility/declval.hpp>
-# ifdef BOOST_NO_CXX11_DECLTYPE
-#   include <boost/typeof/typeof.hpp>
-# endif
-
+#include <boost/config.hpp>
 #ifdef BOOST_HAS_PRAGMA_ONCE
 #   pragma once
 #endif
 
+# include <boost/assert.hpp>
+# include <boost/pointer_cast.hpp>
+# include <boost/throw_exception.hpp>
+
+
 namespace boost
 {
 //  See the documentation for descriptions of how to choose between
@@ -40,36 +38,20 @@ namespace boost
 
     //  Contributed by Boris Rasin
 
-    namespace detail
-    {
-        template <typename Target, typename Source>
-        struct dynamic_pointer_cast_result
-        {
-#ifdef BOOST_NO_CXX11_DECLTYPE
-            BOOST_TYPEOF_NESTED_TYPEDEF_TPL(nested, dynamic_pointer_cast<Target>(boost::declval<Source>()))
-            typedef typename nested::type type;
-#else
-            typedef decltype(dynamic_pointer_cast<Target>(boost::declval<Source>())) type;
-#endif
-        };
-    }
-
     template <typename Target, typename Source>
-    inline typename detail::dynamic_pointer_cast_result<Target, Source>::type
-    polymorphic_pointer_downcast (const Source& x)
+    inline auto polymorphic_pointer_downcast (const Source& x)
+        -> decltype(static_pointer_cast<Target>(x))
     {
         BOOST_ASSERT(dynamic_pointer_cast<Target> (x) == x);
         return static_pointer_cast<Target> (x);
     }
 
     template <typename Target, typename Source>
-    inline typename detail::dynamic_pointer_cast_result<Target, Source>::type
-    polymorphic_pointer_cast (const Source& x)
+    inline auto polymorphic_pointer_cast (const Source& x)
+        -> decltype(dynamic_pointer_cast<Target>(x))
     {
-        typename detail::dynamic_pointer_cast_result<Target, Source>::type tmp
-            = dynamic_pointer_cast<Target> (x);
+        auto tmp = dynamic_pointer_cast<Target> (x);
         if ( !tmp ) boost::throw_exception( std::bad_cast() );
-
         return tmp;
     }
 

index.html

@@ -1,53 +1,39 @@
-<html>
+<!DOCTYPE html>
+<!--
+ Copyright (c) 2016 Mikhail Maximov
+ vigorous.activity at gmail dot com
 
+ Copyright (c) Antony Polukhin, 2021-2026
+
+ 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)
+
+boost-no-inspect
+-->
+<html>
 <head>
-<meta http-equiv="Content-Language" content="en-us">
-<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
-<meta name="GENERATOR" content="Microsoft FrontPage 5.0">
-<meta name="ProgId" content="FrontPage.Editor.Document">
-<title>Boost Conversion Library</title>
+<meta charset="utf-8">
+<meta http-equiv="refresh" content="0; url=../../doc/html/conversion.html">
+<title>Boost.Conversion</title>
 <style>
-   .copyright
-    {
-        color: #666666;
-        font-size: small;
-    }
+  body {
+    background: #fff;
+    color: #000;
+  }
+  a {
+    color: #00f;
+    text-decoration: none;
+  }
 </style>
 </head>
-
-<body bgcolor="#FFFFFF" text="#000000">
-
-<h1><img border="0" src="../../boost.png" align="center" width="277" height="86">Boost
-Conversion Library</h1>
-
-<p>The Conversion Library improves program safety and clarity by performing
-otherwise messy conversions.&nbsp; It includes cast-style function templates designed to complement the C++
-Standard's built-in casts.</p>
-<p>To reduce coupling, particularly to standard library IOStreams, the Boost
-Conversion Library is
-supplied by several headers:</p>
-<ul>
-  <li>The <a href="cast.htm">boost/polymorphic_cast.hpp and boost/polymorphic_pointer_cast.hpp</a> 
-    headers provide <b>polymorphic_cast&lt;&gt;</b>,
-    <b>polymorphic_downcast&lt;&gt;</b> and <b>polymorphic_pointer_downcast&lt;&gt;</b> to perform safe casting between
-  polymorphic types.<br>
-  </li>
-  <li>The boost/implicit_cast.hpp header provides <b>implicit_cast&lt;&gt;</b>
-    to perform implicit casts only (no down-cast, no void*->T*, no U->T if T has only explicit constructors for U).<br>
-  </li>
-  <li>The <a href="../../doc/html/boost_lexical_cast.html">boost/lexical_cast</a> header provides <b>lexical_cast&lt;&gt;</b>
-    general literal text conversions, such as an <code>int</code> represented as
-    a <code>string</code>, or vice-versa.</li>
-</ul>
-<hr>
-<p>Revised <!--webbot bot="Timestamp" S-Type="EDITED"
-S-Format="%d %B, %Y" startspan -->June 23, 2005<!--webbot bot="Timestamp" endspan i-checksum="30348" -->
-</p>
-<p class="copyright">
-    Copyright 2001 Beman Dawes.
-    Distributed under the Boost Software License, Version 1.0. (See accompanying
-    file LICENSE_1_0.txt or copy at <a href="http://www.boost.org/LICENSE_1_0.txt">http://www.boost.org/LICENSE_1_0.txt</a>)
-</p>
+<body>
+  <p>
+    Automatic redirection failed, please go to
+    <a href="../../doc/html/conversion.html">../../doc/html/conversion.html</a>
+  </p>
+  <p>
+    &copy; Antony Polukhin, 2014-2024
+  </p>
 </body>
-
 </html>

meta/libraries.json

@@ -11,5 +11,6 @@
     ],
     "maintainers": [
         "Antony Polukhin <antoshkka -at- gmail.com>"
-    ]
+    ],
+    "cxxstd": "11"
 }

test/CMakeLists.txt

@@ -0,0 +1,17 @@
+# Copyright  (c) 2016-2026 Antony Polukhin
+# 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
+
+include(BoostTest OPTIONAL RESULT_VARIABLE HAVE_BOOST_TEST)
+
+if(NOT HAVE_BOOST_TEST)
+  return()
+endif()
+
+set(BOOST_TEST_LINK_LIBRARIES Boost::conversion Boost::core)
+
+boost_test(TYPE run SOURCES cast_test.cpp)
+boost_test(TYPE run SOURCES implicit_cast.cpp)
+boost_test(TYPE compile-fail SOURCES implicit_cast_fail.cpp)
+boost_test(TYPE compile-fail SOURCES implicit_cast_fail2.cpp)
+boost_test(TYPE run SOURCES polymorphic_cast_test.cpp LINK_LIBRARIES Boost::smart_ptr)

test/Jamfile.v2

@@ -1,18 +1,20 @@
 # Copyright (C) 2001-2003 Douglas Gregor
-# Copyright (C) 2011-2014 Antony Polukhin
+# Copyright (C) Antony Polukhin, 2011-2024
 #
 # 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)
 #
 
+require-b2 5.0.1 ;
+import-search /boost/config/checks ;
+import config : requires ;
 import testing ;
 import feature ;
 
 project
     : requirements
-        <toolset>gcc-4.7:<cxxflags>-ftrapv
-        <toolset>gcc-4.6:<cxxflags>-ftrapv
-        <toolset>clang:<cxxflags>-ftrapv
+        <library>/boost/conversion//boost_conversion
+        [ requires cxx11_decltype ]
         # default to all warnings on:
         <warnings>all
         # set warnings as errors for those compilers we know we get warning free:
@@ -24,6 +26,6 @@ test-suite conversion
   : [ run implicit_cast.cpp ]
     [ compile-fail implicit_cast_fail.cpp ]
     [ run cast_test.cpp ]
-    [ run polymorphic_cast_test.cpp ]
+    [ run polymorphic_cast_test.cpp : : : <library>/boost/smart_ptr//boost_smart_ptr ]
     [ compile-fail implicit_cast_fail2.cpp ]
   ;

test/appveyor.yml

@@ -0,0 +1,87 @@
+# Use, modification, and distribution are
+# subject to 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)
+#
+# Copyright Antony Polukhin, 2016-2025.
+
+#
+# See https://svn.boost.org/trac/boost/wiki/TravisCoverals for description of this file
+# and how it can be used with Boost libraries.
+#
+# File revision #6
+
+init:
+    # boost-local/libs/ folder to put this library into. This may be useful, if you're for example running Travis
+    # from `Boost.DLL` repo while Boost already has `dll` and with to replace `dll` with content of`Boost.DLL`.
+    #
+    # Otherwise just leave the default value - set BOOST_LIBS_FOLDER=%APPVEYOR_PROJECT_NAME%
+    - set BOOST_LIBS_FOLDER=%APPVEYOR_PROJECT_NAME%
+
+###############################################################################################################
+# From this point and below code is same for all the Boost libs
+###############################################################################################################
+
+version: 1.84.{build}-{branch}
+ 
+# branches to build
+branches:
+  except:
+    - gh-pages
+
+skip_tags: true
+
+environment:
+  matrix:
+    - APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2017
+      TOOLSET: msvc-14.1,clang-win
+      CXXSTD: 14,17
+      ADDRMD: 32,64
+    - APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2015
+      ADDPATH: C:\cygwin\bin;
+      TOOLSET: gcc
+      CXXSTD: 03,11,14,1z
+    - APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2015
+      ADDPATH: C:\cygwin64\bin;
+      TOOLSET: gcc
+      CXXSTD: 03,11,14,1z
+    - APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2015
+      ADDPATH: C:\mingw\bin;
+      TOOLSET: gcc
+      CXXSTD: 03,11,14,1z
+    - APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2015
+      ADDPATH: C:\mingw-w64\x86_64-7.2.0-posix-seh-rt_v5-rev1\mingw64\bin;
+      TOOLSET: gcc
+      CXXSTD: 03,11,14,1z
+
+before_build:
+    - set BOOST_BRANCH=develop
+    - if "%APPVEYOR_REPO_BRANCH%" == "master" set BOOST_BRANCH=master
+    - echo "Testing %APPVEYOR_PROJECT_NAME%"
+    # Cloning Boost libraries (fast nondeep cloning)
+    - set BOOST=C:/boost-local
+    - git clone -b %BOOST_BRANCH% --depth 10 https://github.com/boostorg/boost.git %BOOST%
+    - cd %BOOST%
+    - git submodule update --init --depth 10 tools/build tools/boostdep
+
+    - rm -rf %BOOST%/libs/%BOOST_LIBS_FOLDER%
+    - mv -f %APPVEYOR_BUILD_FOLDER% %BOOST%/libs/%BOOST_LIBS_FOLDER%
+    - python tools/boostdep/depinst/depinst.py --git_args "--depth 10 --jobs 2" %BOOST_LIBS_FOLDER%
+
+build_script:
+    - cmd /c bootstrap
+    - b2.exe headers
+    - cd %BOOST%/libs/%BOOST_LIBS_FOLDER%/test
+
+after_build:
+before_test:
+test_script:
+  - PATH=%ADDPATH%%PATH%
+  - if not "%CXXSTD%" == "" set CXXSTD=cxxstd=%CXXSTD%
+  - if not "%ADDRMD%" == "" set ADDRMD=address-model=%ADDRMD%
+  - echo "Running command ..\..\..\b2 -j3 toolset=%TOOLSET% %CXXSTD% %ADDRMD% variant=debug,release"
+  - ..\..\..\b2.exe -j3 toolset=%TOOLSET% %CXXSTD% %ADDRMD% variant=debug,release cxxflags="-DBOOST_TRAVISCI_BUILD"
+
+after_test:
+on_success:
+on_failure:
+on_finish:

test/cast_test.cpp

@@ -15,6 +15,7 @@
 
 #include <iostream>
 #include <boost/polymorphic_cast.hpp>
+#include <boost/core/lightweight_test.hpp>
 
 using namespace boost;
 using std::cout;
@@ -37,6 +38,48 @@ namespace
     };
 }
 
+constexpr bool compile_time_polymorphic_cast_check() {
+#if defined(__cpp_constexpr) && __cpp_constexpr >= 201907L
+    Derived derived;
+    Base* base = &derived;
+    return polymorphic_cast<Derived*>(base) != nullptr;
+#endif
+    return true;
+}
+
+static_assert(
+    compile_time_polymorphic_cast_check(),
+    "polymorphic_cast does not work at compile time"
+);
+
+constexpr bool compile_time_polymorphic_downcast_check() {
+#if defined(__cpp_constexpr) && __cpp_constexpr >= 201907L
+    Derived derived;
+    Base* base = &derived;
+    return polymorphic_downcast<Derived*>(base) != nullptr;
+#endif
+    return true;
+}
+
+static_assert(
+    compile_time_polymorphic_downcast_check(),
+    "polymorphic_downcast does not work at compile time"
+);
+
+constexpr bool compile_time_polymorphic_downcast2_check() {
+#if defined(__cpp_constexpr) && __cpp_constexpr >= 201907L
+    Derived derived;
+    Base& base = derived;
+    Derived& derived_again = polymorphic_downcast<Derived&>(base);
+    (void)derived_again;
+#endif
+    return true;
+}
+
+static_assert(
+    compile_time_polymorphic_downcast2_check(),
+    "polymorphic_downcast does not work at compile time"
+);
 
 int main( int argc, char * argv[] )
 {
@@ -53,20 +96,16 @@ int main( int argc, char * argv[] )
     //  tests which should succeed
     Derived derived_instance;
     Base * base = &derived_instance;
-    Base2 *   base2 = 0;
-    Derived * derived = 0;
-    derived = polymorphic_downcast<Derived*>( base );  // downcast
-    assert( derived->kind() == 'D' );
+    Derived * derived = polymorphic_downcast<Derived*>( base );  // downcast
+    BOOST_TEST( derived->kind() == 'D' );
 
-    derived = 0;
     derived = polymorphic_cast<Derived*>( base ); // downcast, throw on error
-    assert( derived->kind() == 'D' );
+    BOOST_TEST( derived->kind() == 'D' );
 
-    base2 = polymorphic_cast<Base2*>( base ); // crosscast
-    assert( base2->kind2() == '2' );
+    Base2 *   base2 =  polymorphic_cast<Base2*>( base ); // crosscast
+    BOOST_TEST( base2->kind2() == '2' );
 
      //  tests which should result in errors being detected
-    int err_count = 0;
     Base base_instance;
     base = &base_instance;
 
@@ -75,13 +114,11 @@ int main( int argc, char * argv[] )
 
     bool caught_exception = false;
     try { derived = polymorphic_cast<Derived*>( base ); }
-    catch (std::bad_cast)
+    catch (const std::bad_cast&)
         { cout<<"caught bad_cast\n"; caught_exception = true; }
-    if ( !caught_exception ) ++err_count;
+    BOOST_TEST( caught_exception );
     //  the following is just so generated code can be inspected
-    if ( derived->kind() == 'B' ) ++err_count;
+    BOOST_TEST( derived->kind() != 'B' );
 
-    cout << err_count << " errors detected\nTest "
-         << (err_count==0 ? "passed\n" : "failed\n");
-    return err_count;
+    return boost::report_errors();
 }   // main

test/implicit_cast.cpp

@@ -4,8 +4,9 @@
 // http://www.boost.org/LICENSE_1_0.txt)
 
 #include <boost/implicit_cast.hpp>
-#include <boost/detail/lightweight_test.hpp>
+#include <boost/core/lightweight_test.hpp>
 #include <boost/type.hpp>
+
 using boost::implicit_cast;
 using boost::type;
 
@@ -18,8 +19,8 @@ struct foo
     operator long() const { return 0; }
 };
 
-typedef type<long> long_type;
-typedef type<foo> foo_type;
+using long_type = type<long>;
+using foo_type = type<foo>;
 
 int main()
 {
@@ -34,5 +35,9 @@ int main()
     (void)f;
     (void)z;
 
+
+    constexpr long value = boost::implicit_cast<long>(42);
+    BOOST_TEST(value == 42L);
+
     return boost::report_errors();
 }

test/polymorphic_cast_test.cpp

@@ -6,6 +6,7 @@
 // Copyright 1999 Dave Abrahams
 // Copyright 2014 Peter Dimov
 // Copyright 2014 Boris Rasin, Antony Polukhin
+// Copyright 2023 Antony Polukhin
 //
 // Distributed under the Boost Software License, Version 1.0.
 //
@@ -25,12 +26,17 @@
 static bool expect_assertion = false;
 static int assertion_failed_count = 0;
 
+//assertion handler throws it to exit like assert, but to be able to catch it and stop
+//usage: BOOST_TEST_THROWS( function_with_assert(), expected_assertion );
+struct expected_assertion {};
+
 // BOOST_ASSERT custom handler
 void boost::assertion_failed( char const * expr, char const * function, char const * file, long line )
 {
     if( expect_assertion )
     {
         ++assertion_failed_count;
+        throw expected_assertion();
     }
     else
     {
@@ -154,7 +160,7 @@ static void test_polymorphic_pointer_cast()
 
         if( sp_base2 != 0 )
         {
-            BOOST_TEST_EQ( base2->kind2(), "Base2" );
+            BOOST_TEST_EQ( sp_base2->kind2(), "Base2" );
         }
     }
     catch( std::bad_cast const& )
@@ -167,20 +173,23 @@ static void test_polymorphic_pointer_cast()
 
 static void test_polymorphic_downcast()
 {
-    Base * base = new Derived;
+    Base *base_pointer = new Derived;
 
-    Derived * derived = boost::polymorphic_downcast<Derived*>( base );
+    // test raw pointer cast
+    Derived *derived_pointer = boost::polymorphic_downcast<Derived *>(base_pointer);
 
-    BOOST_TEST( derived != 0 );
+    BOOST_TEST(derived_pointer != 0);
 
-    if( derived != 0 )
+    if (derived_pointer != 0)
     {
-        BOOST_TEST_EQ( derived->kind(), "Derived" );
+        BOOST_TEST_EQ(derived_pointer->kind(), "Derived");
     }
 
-    // polymorphic_downcast can't do crosscasts
+    // test reference cast
+    Derived& derived_ref = boost::polymorphic_downcast<Derived&>(*base_pointer);
+    BOOST_TEST_EQ(derived_ref.kind(), "Derived");
 
-    delete base;
+    delete base_pointer;
 }
 
 static void test_polymorphic_pointer_downcast_builtin()
@@ -229,8 +238,6 @@ static void test_polymorphic_pointer_downcast_intrusive()
     }
 }
 
-#ifndef BOOST_NO_CXX11_SMART_PTR
-
 static void test_polymorphic_pointer_downcast_std_shared()
 {
     std::shared_ptr<Base> base (new Derived);
@@ -245,8 +252,6 @@ static void test_polymorphic_pointer_downcast_std_shared()
     }
 }
 
-#endif
-
 static void test_polymorphic_cast_fail()
 {
     Base * base = new Base;
@@ -264,26 +269,39 @@ static void test_polymorphic_pointer_cast_fail()
 
     BOOST_TEST_THROWS( boost::polymorphic_pointer_cast<Derived>( boost::shared_ptr<Base>(new Base) ), std::bad_cast );
 
-#ifndef BOOST_NO_CXX11_SMART_PTR
     BOOST_TEST_THROWS( boost::polymorphic_pointer_cast<Derived>( std::shared_ptr<Base>(new Base) ), std::bad_cast );
-#endif
 
     BOOST_TEST_THROWS( boost::polymorphic_pointer_cast<Derived>( boost::intrusive_ptr<Base>(new Base) ), std::bad_cast );
 }
 
 static void test_polymorphic_downcast_fail()
 {
-    Base * base = new Base;
+    Base * base_pointer = new Base;
 
-    int old_count = assertion_failed_count;
-    expect_assertion = true;
+    {
+        // test raw pointer cast
 
-    boost::polymorphic_downcast<Derived*>( base ); // should assert
+        int old_count = assertion_failed_count;
+        expect_assertion = true;
 
-    BOOST_TEST_EQ( assertion_failed_count, old_count + 1 );
-    expect_assertion = false;
+        BOOST_TEST_THROWS(boost::polymorphic_downcast<Derived *>(base_pointer), expected_assertion); // should assert
 
-    delete base;
+        BOOST_TEST_EQ(assertion_failed_count, old_count + 1);
+        expect_assertion = false;
+    }
+    {
+        // test reference cast
+
+        int old_count = assertion_failed_count;
+        expect_assertion = true;
+
+        BOOST_TEST_THROWS(boost::polymorphic_downcast<Derived &>(*base_pointer), expected_assertion); // should assert
+
+        BOOST_TEST_EQ(assertion_failed_count, old_count + 1);
+        expect_assertion = false;
+    }
+
+    delete base_pointer;
 }
 
 static void test_polymorphic_pointer_downcast_builtin_fail()
@@ -293,7 +311,7 @@ static void test_polymorphic_pointer_downcast_builtin_fail()
     int old_count = assertion_failed_count;
     expect_assertion = true;
 
-    boost::polymorphic_pointer_downcast<Derived>( base ); // should assert
+    BOOST_TEST_THROWS( boost::polymorphic_pointer_downcast<Derived>( base ), expected_assertion ); // should assert
 
     BOOST_TEST_EQ( assertion_failed_count, old_count + 1 );
     expect_assertion = false;
@@ -308,13 +326,12 @@ static void test_polymorphic_pointer_downcast_boost_shared_fail()
     int old_count = assertion_failed_count;
     expect_assertion = true;
 
-    boost::polymorphic_pointer_downcast<Derived>( base ); // should assert
+    BOOST_TEST_THROWS( boost::polymorphic_pointer_downcast<Derived>( base ), expected_assertion ); // should assert
 
     BOOST_TEST_EQ( assertion_failed_count, old_count + 1 );
     expect_assertion = false;
 }
 
-#ifndef BOOST_NO_CXX11_SMART_PTR
 
 static void test_polymorphic_pointer_downcast_std_shared_fail()
 {
@@ -323,13 +340,12 @@ static void test_polymorphic_pointer_downcast_std_shared_fail()
     int old_count = assertion_failed_count;
     expect_assertion = true;
 
-    boost::polymorphic_pointer_downcast<Derived>( base ); // should assert
+    BOOST_TEST_THROWS( boost::polymorphic_pointer_downcast<Derived>( base ), expected_assertion ); // should assert
 
     BOOST_TEST_EQ( assertion_failed_count, old_count + 1 );
     expect_assertion = false;
 }
 
-#endif
 
 static void test_polymorphic_pointer_downcast_intrusive_fail()
 {
@@ -338,7 +354,7 @@ static void test_polymorphic_pointer_downcast_intrusive_fail()
     int old_count = assertion_failed_count;
     expect_assertion = true;
 
-    boost::polymorphic_pointer_downcast<Derived>( base ); // should assert
+    BOOST_TEST_THROWS( boost::polymorphic_pointer_downcast<Derived>( base ), expected_assertion); // should assert
 
     BOOST_TEST_EQ( assertion_failed_count, old_count + 1 );
     expect_assertion = false;
@@ -359,10 +375,9 @@ int main()
     test_polymorphic_pointer_downcast_boost_shared_fail();
     test_polymorphic_pointer_downcast_intrusive_fail();
 
-#ifndef BOOST_NO_CXX11_SMART_PTR
     test_polymorphic_pointer_downcast_std_shared();
     test_polymorphic_pointer_downcast_std_shared_fail();
-#endif
+
 
     return boost::report_errors();
 }