The ISO-C++ proposal P0009 will add support for non-owning multi-dimensional array references to the C++ standard library. This repository aims to provide a production-quality implementation of the proposal as written (with a few caveats, see below) in preparation for the addition of
mdspan to the standard. Please feel free to use this, file bugs when it breaks, and let us know how it works for you :-)
A tutorial-style introduction to the basic usage of
mdspan is provided on the project wiki. More advanced tutorials to come.
- C++17 backport (e.g., concepts not required)
- C++14 backport (e.g., fold expressions not required)
- Compile times of this backport will be substantially slower than the C++17 version
- C++11 backport
- Compile times of this backport will be substantially slower than the C++14 backport
- Macros to enable, e.g.,
__device__marking of all functions for CUDA compatibility
Building and Installation
This implementation is header-only, with compiler features detected using feature test macros, so you can just use it directly with no building or installation. If you would like to run the included tests or benchmarks, you'll need CMake.
TODO finish this
TODO write this
TODO write this
This implementation is fully conforming with a few exceptions (most of which are extensions):
layout_strideis a template that takes static strides (which can be
std::experimental::dynamic_extent), which enables zero-overhead subspan implementation
- zero-sized strides are allowed for
layout_stridemapping comparison operators work as expected, rather than the (typo) specification in the proposal
basic_mdspanis omitted for several reasons
This work was undertaken as part of the Kokkos project at Sandia National Laboratories. Sandia National Laboratories is a multimission laboratory managed and operated by National Technology & Engineering Solutions of Sandia, LLC, a wholly owned subsidary of Honeywell International Inc., for the U. S. Department of Energy's National Nuclear Security Administration under contract DE-NA0003525.