Merge pull request #381 from cppalliance/develop

Merge to master for v2.0.0

Author: mborland

.drone.jsonnet

@@ -416,4 +416,10 @@ local windows_pipeline(name, image, environment, arch = "amd64") =
         "cppalliance/dronevs2022:1",
         { TOOLSET: 'msvc-14.3', CXXSTD: '14,17,20,latest', ADDRMD: '32,64' },
     ),
+
+    windows_pipeline(
+        "Windows VS2026 msvc-14.5",
+        "cppalliance/dronevs2026:1",
+        { TOOLSET: 'msvc-14.5', CXXSTD: '14,17,20,latest', ADDRMD: '32,64' },
+    ),
 ]

.github/dependabot.yml

@@ -0,0 +1,15 @@
+# Copyright 2025 Matt Borland
+# Distributed under the Boost Software License, Version 1.0.
+# (See accompanying file LICENSE_1_0.txt or copy at http://boost.org/LICENSE_1_0.txt)
+
+version: 2
+updates:
+  - package-ecosystem: "npm"
+    directory: "/doc"
+    schedule:
+      interval: "weekly"
+    groups:
+      all-dependencies:
+        # Groups all updates into a single PR
+        patterns:
+          - "*"

.github/workflows/ci.yml

@@ -298,12 +298,12 @@ jobs:
             source_keys:
               - "https://apt.llvm.org/llvm-snapshot.gpg.key"
 
-          - toolset: clang
-            cxxstd: "03,11,14,17,20,2b"
-            os: macos-14
           - toolset: clang
             cxxstd: "03,11,14,17,20,2b"
             os: macos-15
+          - toolset: clang
+            cxxstd: "03,11,14,17,20,2b,2c"
+            os: macos-26
 
     timeout-minutes: 180
     runs-on: ${{matrix.os}}
@@ -620,8 +620,8 @@ jobs:
         include:
           - os: ubuntu-22.04
           - os: ubuntu-24.04
-          - os: macos-14
           - os: macos-15
+          - os: macos-26
 
     runs-on: ${{matrix.os}}
 
@@ -666,8 +666,8 @@ jobs:
       fail-fast: false
       matrix:
         include:
-          - os: macos-14
           - os: macos-15
+          - os: macos-26
 
     runs-on: ${{matrix.os}}
 
@@ -724,8 +724,8 @@ jobs:
         include:
           - os: ubuntu-22.04
           - os: ubuntu-24.04
-          - os: macos-14
           - os: macos-15
+          - os: macos-26
 
     runs-on: ${{matrix.os}}
 
@@ -780,8 +780,8 @@ jobs:
         include:
           - os: ubuntu-22.04
           - os: ubuntu-24.04
-          - os: macos-14
           - os: macos-15
+          - os: macos-26
 
     runs-on: ${{matrix.os}}
 
@@ -952,8 +952,8 @@ jobs:
       matrix:
         include:
           - os: ubuntu-24.04
-          - os: macos-14
           - os: macos-15
+          - os: macos-26
 
     runs-on: ${{matrix.os}}
 
@@ -1146,3 +1146,60 @@ jobs:
           cd ~/pkgconfig_test
           g++ main.cpp $(pkg-config --cflags --libs boost_int128) -o test_pkgconfig
           ./test_pkgconfig
+
+  cuda-cmake-test:
+    strategy:
+      fail-fast: false
+
+    runs-on: gpu-runner-1
+
+    steps:
+      - uses: Jimver/cuda-toolkit@v0.2.30
+        id: cuda-toolkit
+        with:
+          cuda: '12.8.0'
+          method: 'network'
+          sub-packages: '["nvcc"]'
+
+      - name: Output CUDA information
+        run: |
+          echo "Installed cuda version is: ${{steps.cuda-toolkit.outputs.cuda}}"+
+          echo "Cuda install location: ${{steps.cuda-toolkit.outputs.CUDA_PATH}}"
+          nvcc -V
+      - uses: actions/checkout@v5
+
+      - name: Install Packages
+        run: |
+          sudo apt-get install -y cmake make
+      - 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 1 https://github.com/boostorg/boost.git boost-root
+          cd boost-root
+          mkdir -p libs/$LIBRARY
+          cp -r $GITHUB_WORKSPACE/* libs/$LIBRARY
+          git submodule update --init tools/boostdep
+          python3 tools/boostdep/depinst/depinst.py --git_args "--jobs 3" $LIBRARY
+      - name: Test C++17/20/23
+        run: |
+          for std in 17 20 23; do
+            echo "======== Testing C++${std} ========"
+            cd ../boost-root
+            rm -rf __build__
+            mkdir __build__ && cd __build__
+            cmake -DBOOST_INCLUDE_LIBRARIES=$LIBRARY -DBUILD_TESTING=ON -DCMAKE_CUDA_COMPILER=/usr/local/cuda/bin/nvcc -DBOOST_INT128_ENABLE_CUDA=1 -DCMAKE_CUDA_ARCHITECTURES="75;86" -DCMAKE_CUDA_STANDARD=${std} ..
+            cmake --build . --target tests -j $(nproc)
+            ctest --output-on-failure --no-tests=error
+            cd $GITHUB_WORKSPACE
+          done

.github/workflows/codecov.yml

@@ -80,21 +80,21 @@ jobs:
           fi
           git config --global pack.threads 0
 
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
         with:
           # For coverage builds fetch the whole history, else only 1 commit using a 'fake ternary'
           fetch-depth: ${{ matrix.coverage && '0' || '1' }}
 
       - name: Cache ccache
-        uses: actions/cache@v3
+        uses: actions/cache@v4
         if: env.B2_USE_CCACHE
         with:
           path: ~/.ccache
           key: ${{matrix.os}}-${{matrix.container}}-${{matrix.compiler}}-${{github.sha}}
           restore-keys: ${{matrix.os}}-${{matrix.container}}-${{matrix.compiler}}-
 
       - name: Fetch Boost.CI
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
         with:
           repository: boostorg/boost-ci
           ref: master

.github/workflows/fuzz.yml

@@ -41,7 +41,22 @@ jobs:
           echo 'compiling test/fuzzing/test_fuzzing_div_versus_wide_int.cpp'
           ${{ matrix.compiler }} -std=c++20 -g -O2 -Wall -Wextra -Wpedantic -Wconversion -Wsign-conversion -fsanitize=fuzzer -I./include -I${{runner.workspace}}/wide-integer test/fuzzing/test_fuzzing_div_versus_wide_int.cpp -o test_fuzzing_div_versus_wide_int
           echo "run test_fuzzing_div_versus_wide_int"
-          ./test_fuzzing_div_versus_wide_int -max_total_time=900 -max_len=32 -verbosity=0 -close_fd_mask=3
+          ./test_fuzzing_div_versus_wide_int -max_total_time=600 -max_len=32 -verbosity=0 -close_fd_mask=3
+
+          echo 'compiling test/fuzzing/test_fuzzing_add_versus_wide_int.cpp'
+          ${{ matrix.compiler }} -std=c++20 -g -O2 -Wall -Wextra -Wpedantic -Wconversion -Wsign-conversion -fsanitize=fuzzer -I./include -I${{runner.workspace}}/wide-integer test/fuzzing/test_fuzzing_add_versus_wide_int.cpp -o test_fuzzing_add_versus_wide_int
+          echo "run test_fuzzing_add_versus_wide_int"
+          ./test_fuzzing_add_versus_wide_int -max_total_time=300 -max_len=32 -verbosity=0 -close_fd_mask=3
+          
+          echo 'compiling test/fuzzing/test_fuzzing_sub_versus_wide_int.cpp'
+          ${{ matrix.compiler }} -std=c++20 -g -O2 -Wall -Wextra -Wpedantic -Wconversion -Wsign-conversion -fsanitize=fuzzer -I./include -I${{runner.workspace}}/wide-integer test/fuzzing/test_fuzzing_sub_versus_wide_int.cpp -o test_fuzzing_sub_versus_wide_int
+          echo "run test_fuzzing_sub_versus_wide_int"
+          ./test_fuzzing_sub_versus_wide_int -max_total_time=300 -max_len=32 -verbosity=0 -close_fd_mask=3
+          
+          echo 'compiling test/fuzzing/test_fuzzing_mul_versus_wide_int.cpp'
+          ${{ matrix.compiler }} -std=c++20 -g -O2 -Wall -Wextra -Wpedantic -Wconversion -Wsign-conversion -fsanitize=fuzzer -I./include -I${{runner.workspace}}/wide-integer test/fuzzing/test_fuzzing_mul_versus_wide_int.cpp -o test_fuzzing_mul_versus_wide_int
+          echo "run test_fuzzing_mul_versus_wide_int"
+          ./test_fuzzing_mul_versus_wide_int -max_total_time=300 -max_len=32 -verbosity=0 -close_fd_mask=3
 
   clang-fuzzing-versus-wide-integer-no-builtin:
     runs-on: ubuntu-latest
@@ -68,4 +83,19 @@ jobs:
           echo 'compiling test/fuzzing/test_fuzzing_div_versus_wide_int.cpp'
           ${{ matrix.compiler }} -std=c++20 -g -O2 -Wall -Wextra -Wpedantic -Wconversion -Wsign-conversion -fsanitize=fuzzer -I./include -I${{runner.workspace}}/wide-integer -DBOOST_INT128_NO_BUILTIN_INT128=1 test/fuzzing/test_fuzzing_div_versus_wide_int.cpp -o test_fuzzing_div_versus_wide_int
           echo "run test_fuzzing_div_versus_wide_int"
-          ./test_fuzzing_div_versus_wide_int -max_total_time=900 -max_len=32 -verbosity=0 -close_fd_mask=3
+          ./test_fuzzing_div_versus_wide_int -max_total_time=600 -max_len=32 -verbosity=0 -close_fd_mask=3
+          
+          echo 'compiling test/fuzzing/test_fuzzing_add_versus_wide_int.cpp'
+          ${{ matrix.compiler }} -std=c++20 -g -O2 -Wall -Wextra -Wpedantic -Wconversion -Wsign-conversion -fsanitize=fuzzer -I./include -I${{runner.workspace}}/wide-integer -DBOOST_INT128_NO_BUILTIN_INT128=1 test/fuzzing/test_fuzzing_add_versus_wide_int.cpp -o test_fuzzing_add_versus_wide_int
+          echo "run test_fuzzing_add_versus_wide_int"
+          ./test_fuzzing_add_versus_wide_int -max_total_time=300 -max_len=32 -verbosity=0 -close_fd_mask=3
+          
+          echo 'compiling test/fuzzing/test_fuzzing_sub_versus_wide_int.cpp'
+          ${{ matrix.compiler }} -std=c++20 -g -O2 -Wall -Wextra -Wpedantic -Wconversion -Wsign-conversion -fsanitize=fuzzer -I./include -I${{runner.workspace}}/wide-integer -DBOOST_INT128_NO_BUILTIN_INT128=1 test/fuzzing/test_fuzzing_sub_versus_wide_int.cpp -o test_fuzzing_sub_versus_wide_int
+          echo "run test_fuzzing_sub_versus_wide_int"
+          ./test_fuzzing_sub_versus_wide_int -max_total_time=300 -max_len=32 -verbosity=0 -close_fd_mask=3
+          
+          echo 'compiling test/fuzzing/test_fuzzing_mul_versus_wide_int.cpp'
+          ${{ matrix.compiler }} -std=c++20 -g -O2 -Wall -Wextra -Wpedantic -Wconversion -Wsign-conversion -fsanitize=fuzzer -I./include -I${{runner.workspace}}/wide-integer -DBOOST_INT128_NO_BUILTIN_INT128=1 test/fuzzing/test_fuzzing_mul_versus_wide_int.cpp -o test_fuzzing_mul_versus_wide_int
+          echo "run test_fuzzing_mul_versus_wide_int"
+          ./test_fuzzing_mul_versus_wide_int -max_total_time=300 -max_len=32 -verbosity=0 -close_fd_mask=3

README.md

@@ -16,6 +16,7 @@ int128 is under active development and is not an official boost library.
 
 This library is header only. It contains no other dependencies.
 Simply `#include` it and use it.
+With C++20 and greater you can instead `import boost.int128`.
 
 ## CMake
 
@@ -64,13 +65,13 @@ struct int128_t;
 
 These types operate like built-in integer types.
 They have their own implementations of the Standard-Library functions
-(e.g. like those found in `<limits>`, `<iostream>`, `<bit>` etc.).
+(e.g., like those found in `<limits>`, `<iostream>`, `<bit>` etc.).
 
 The entire library can be conveniently included with `#include <boost/int128.hpp>`
 
 # Full Documentation
 
-The complete documentation can be found at: https://master.int128.cpp.al
+The complete documentation can be found at: https://develop.int128.cpp.al
 
 ## References
 

doc/antora.yml

@@ -1,6 +1,9 @@
 name: ROOT
 version: ~
 title: Boost.int128
+asciidoc:
+  attributes:
+    page-pagination: ''
 nav:
   - modules/ROOT/nav.adoc
 start_page: overview.adoc

doc/int128-playbook.yml

@@ -5,7 +5,7 @@ content:
   sources:
     - url: ..
       start_path: doc
-      branches: HEAD
+      branches: develop
 output:
   dir: html
 ui:

doc/modules/ROOT/nav.adoc

@@ -6,12 +6,13 @@
 ** xref:examples.adoc#examples_rollover[Rollover Behavior]
 ** xref:examples.adoc#examples_bit[`<bit>` support]
 ** xref:examples.adoc#examples_numeric[`<numeric>` support (Saturating Arithmetic)]
-** xref:examples.adoc#examples_numeric[`<numeric>` support (Numeric Logarithms)]
+** xref:examples.adoc#examples_numeric_algorithms[`<numeric>` support (Numeric Algorithms)]
 ** xref:examples.adoc#examples_mixed_sign[Mixed Signedness Arithmetic]
 ** xref:examples.adoc#examples_to_string[String Conversion (to_string)]
 ** xref:examples.adoc#examples_boost_math_random[Boost Math and Random Integration]
 ** xref:examples.adoc#examples_boost_charconv[Boost.Charconv Integration]
 ** xref:examples.adoc#examples_cstdlib[`<cstdlib>` support (Combined div and mod)]
+** xref:examples.adoc#examples_cuda[Use of the library in a CUDA kernel]
 * xref:api_reference.adoc[]
 ** xref:api_reference.adoc#api_namespaces[Namespaces]
 ** xref:api_reference.adoc#api_types[Types]
@@ -29,6 +30,7 @@
 ** xref:api_reference.adoc#api_macros[Macros]
 *** xref:api_reference.adoc#api_macro_literals[Literals]
 *** xref:api_reference.adoc#api_macro_configuration[Configuration]
+** xref:api_reference.adoc#api_headers[Headers]
 * xref:uint128_t.adoc[]
 ** xref:uint128_t.adoc#u128_alignment[Alignment]
 ** xref:uint128_t.adoc#u128_operator_behavior[Operator Behavior]

doc/modules/ROOT/pages/api_reference.adoc

@@ -20,6 +20,9 @@ https://www.boost.org/LICENSE_1_0.txt
 
 | xref:literals.adoc[`boost::int128::literals`]
 | User-defined literals for 128-bit integers
+
+| xref:charconv.adoc[`boost::charconv`]
+| `to_chars` and `from_chars` overloads for 128-bit integers (requires Boost.Charconv)
 |===
 
 [#api_types]
@@ -146,7 +149,7 @@ Listed by analogous STL header.
 |===
 | Function | Description
 
-| `abs`
+| xref:int128_t.adoc#i128_math_operators[`abs`]
 | Absolute value
 |===
 
@@ -307,6 +310,9 @@ Listed by analogous STL header.
 
 | xref:config.adoc#disable_exceptions[`BOOST_INT128_DISABLE_EXCEPTIONS`]
 | Disables exception throwing
+
+| xref:config.adoc#enable_cuda[`BOOST_INT128_ENABLE_CUDA`]
+| Enables CUDA support allowing the library types and functions to be run on both host and device
 |===
 
 ==== Automatic Configuration
@@ -323,4 +329,58 @@ Listed by analogous STL header.
 
 | xref:config.adoc#automatic_config[`BOOST_INT128_ENDIAN_BIG_BYTE`]
 | Defined on big-endian systems
-|===
+
+| xref:config.adoc#host_device[`BOOST_INT128_HOST_DEVICE`]
+| Expands to `pass:[__host__ __device__]` under NVCC for CUDA support
+|===
+
+[#api_headers]
+== Headers
+
+[cols="1,2", options="header"]
+|===
+| Header | Contents
+
+| `<boost/int128.hpp>`
+| Convenience header including the entire library
+
+| xref:bit.adoc[`<boost/int128/bit.hpp>`]
+| Bit manipulation functions
+
+| xref:charconv.adoc[`<boost/int128/charconv.hpp>`]
+| Character conversion functions
+
+| `<boost/int128/climits.hpp>`
+| Min and max macros
+
+| xref:cstdlib.adoc[`<boost/int128/cstdlib.hpp>`]
+| Combined division and modulo function
+
+| xref:format.adoc#fmt_format[`<boost/int128/fmt_format.hpp>`]
+| Formatting integration for pass:[{fmt}]
+
+| xref:format.adoc#std_format[`<boost/int128/format.hpp>`]
+| Formatting integration for pass:[C++20] `<format>`
+
+| `<boost/int128/int128.hpp>`
+| The xref:uint128_t.adoc[`uint128_t`] and xref:int128_t.adoc[`int128_t`] types
+
+| xref:stream.adoc[`<boost/int128/iostream.hpp>`]
+| Iostream overloads for `int128_t` and `uint128_t`
+
+| `<boost/int128/limits.hpp>`
+| Overloads for `std::numeric_limits` for `int128_t` and `uint128_t`
+
+| xref:literals.adoc[`<boost/int128/literals.hpp>`]
+| User-defined literals for `int128_t` and `uint128_t`
+
+| xref:numeric.adoc[`<boost/int128/numeric.hpp>`]
+| Numeric algorithms (gcd, lcm, midpoint)
+
+| xref:string.adoc[`<boost/int128/string.hpp>`]
+| `to_string` overloads
+
+| `<boost/int128/random.hpp>`
+| Required for usage of Boost.Random
+
+|===