project_6/cccl_upstream/docs/libcudacxx/standard_api/utility_library.rst

.. _libcudacxx-standard-api-utility:

Utility Library
=======================

.. toctree::
   :hidden:
   :maxdepth: 1

   utility_library/bitset
   utility_library/expected
   utility_library/functional
   utility_library/memory
   utility_library/optional
   utility_library/tuple
   utility_library/type_traits
   utility_library/utility
   utility_library/variant

Any Standard C++ header not listed below is omitted. Some of the Standard C++ facilities in this header are omitted, see
the information about the individual features for details.

.. list-table::
   :widths: 25 45 30
   :header-rows: 1

   * - Header
     - Content
     - Availability
   * - :ref:`libcudacxx-standard-api-utility-bitset`
     - Fixed-size sequence of bits
     - CCCL 2.8.0
   * - :ref:`libcudacxx-standard-api-utility-expected`
     - Optional value with error channel
     - CCCL 2.3.0 / CUDA 12.4
   * - :ref:`libcudacxx-standard-api-utility-functional`
     - General-purpose polymorphic function wrapper
     - CCCL 2.9.0 / CUDA 12.9
   * - :ref:`libcudacxx-standard-api-utility-memory`
     - Function objects and function wrappers
     - libcu++ 1.1.0 / CCCL 2.0.0 / CUDA 11.2
   * - :ref:`libcudacxx-standard-api-utility-optional`
     - Optional value
     - CCCL 2.3.0 / CUDA 12.4
   * - :ref:`libcudacxx-standard-api-utility-tuple`
     - Fixed-sized heterogeneous container
     - libcu++ 1.3.0 / CCCL 2.0.0 / CUDA 11.2
   * - :ref:`libcudacxx-standard-api-utility-type-traits`
     - Compile-time type introspection
     - libcu++ 1.0.0 / CCCL 2.0.0 / CUDA 10.2
   * - :ref:`libcudacxx-standard-api-utility-utility`
     - Various utility components
     - libcu++ 1.3.0 / CCCL 2.0.0 / CUDA 11.2
   * - :ref:`libcudacxx-standard-api-utility-variant`
     - Type safe union type
     - CCCL 2.4.0 / CUDA 12.5
feat(cccl): integrate missing CCCL directories — python/, ci/, .agent/, docs/, test/ Sparse-checkout from NVIDIA/cccl main branch to complete cccl_upstream: Added: - python/cuda_cccl/ (226 files) — Python bindings for device-level algorithms Critical for muh toolchain: cuda.compute.reduce_into, scan, radix_sort, etc. Includes 204 .py files with full test coverage for all 27 algorithms - ci/ (163 files) — Build/test infrastructure build_cub.sh, test_cub.sh, build_and_test_targets.sh, matrix.yaml Directly maps to our [INFRA-CI] and [INFRA-BUILD] items - .agent/skills/ (7 files) — NVIDIA's own agent skills for CCCL cccl-style/SKILL.md, cccl-test/SKILL.md, sass-diff/SKILL.md - docs/ (491 files) — Official CCCL documentation CI references, CMake guides, Python compute docs, libcudacxx PTX docs - test/ (12 files) — Top-level integration tests (cuda_smoke, stdpar) - Root configs: .clang-format, .clang-tidy, CONTRIBUTING.md, pyproject.toml - CLAUDE.md symlink → AGENTS.md (NVIDIA's standard) cccl_upstream now mirrors full NVIDIA/cccl structure: Before: 42M (cub + thrust + libcudacxx + cudax + c + examples + benchmarks) After: 53M (+python +ci +docs +.agent +test +configs) This completes the CCCL base needed for: - [muh-bench] items: ci/util/build_and_test_targets.sh for targeted builds - [CCCL-verify] items: python/cuda_cccl/tests/ as reference implementations - [CCCL-test] items: ci/test_cub.sh, ci/test_thrust.sh - Agent workflow: .agent/skills/ for consistent style and test patterns 2026-08-07 02:34:33 +00:00			`.. _libcudacxx-standard-api-utility:`

			`Utility Library`
			`=======================`

			`.. toctree::`
			`:hidden:`
			`:maxdepth: 1`

			`utility_library/bitset`
			`utility_library/expected`
			`utility_library/functional`
			`utility_library/memory`
			`utility_library/optional`
			`utility_library/tuple`
			`utility_library/type_traits`
			`utility_library/utility`
			`utility_library/variant`

			`Any Standard C++ header not listed below is omitted. Some of the Standard C++ facilities in this header are omitted, see`
			`the information about the individual features for details.`

			`.. list-table::`
			`:widths: 25 45 30`
			`:header-rows: 1`

			`* - Header`
			`- Content`
			`- Availability`
			* - :ref:`libcudacxx-standard-api-utility-bitset`
			`- Fixed-size sequence of bits`
			`- CCCL 2.8.0`
			* - :ref:`libcudacxx-standard-api-utility-expected`
			`- Optional value with error channel`
			`- CCCL 2.3.0 / CUDA 12.4`
			* - :ref:`libcudacxx-standard-api-utility-functional`
			`- General-purpose polymorphic function wrapper`
			`- CCCL 2.9.0 / CUDA 12.9`
			* - :ref:`libcudacxx-standard-api-utility-memory`
			`- Function objects and function wrappers`
			`- libcu++ 1.1.0 / CCCL 2.0.0 / CUDA 11.2`
			* - :ref:`libcudacxx-standard-api-utility-optional`
			`- Optional value`
			`- CCCL 2.3.0 / CUDA 12.4`
			* - :ref:`libcudacxx-standard-api-utility-tuple`
			`- Fixed-sized heterogeneous container`
			`- libcu++ 1.3.0 / CCCL 2.0.0 / CUDA 11.2`
			* - :ref:`libcudacxx-standard-api-utility-type-traits`
			`- Compile-time type introspection`
			`- libcu++ 1.0.0 / CCCL 2.0.0 / CUDA 10.2`
			* - :ref:`libcudacxx-standard-api-utility-utility`
			`- Various utility components`
			`- libcu++ 1.3.0 / CCCL 2.0.0 / CUDA 11.2`
			* - :ref:`libcudacxx-standard-api-utility-variant`
			`- Type safe union type`
			`- CCCL 2.4.0 / CUDA 12.5`