# std::extents<IndexType,Extents...>::rank

> C++ Atlas: `cppatlas.com/w/cpp/container/mdspan/extents/rank` | Source: https://en.cppreference.com/w/cpp/container/mdspan/extents/rank | Domain: Containers | Standards: C++11, C++23

Returns the number of dimensions in extents.

## Official Specification Summary (cppreference)

```cpp
static constexpr rank_type rank() const noexcept; // (since C++23)
```

Returns the number of dimensions in `extents`.

### Parameters

(none)

### Return value

The number of dimensions.

### Example

```cpp
#include <iostream>
#include <mdspan>

int main()
{
    std::extents<int, 1, 2> e1;
    std::extents<int, 3, 4, std::dynamic_extent> e2(5);
    std::cout << e1.rank() << ", " << e2.rank() << '\n';
}
```

Output:

```text
2, 3
```

### See also

- [`rank_dynamic`](https://en.cppreference.com/w/cpp/container/mdspan/extents/rank_dynamic) [static]: returns the dynamic rank of an `extents` (public static member function)
- [`rank`](https://en.cppreference.com/w/cpp/types/rank) (C++11): obtains the number of dimensions of an array type (class template)

---
Attribution: content from https://en.cppreference.com/w/cpp/container/mdspan/extents/rank (cppreference.com), licensed under CC-BY-SA 3.0 and GFDL. Modified: converted to markdown, study notes added. Offline snapshot of 9 February 2025.