Add x, y, and z shorthands to id and range classes

adoc/chapters/programming_interface.adoc

@@ -11977,6 +11977,30 @@ size_t operator[](int dimension) const
    a@ Return the value of the specified dimension of the
       [code]#range#.
 
+a@
+[source]
+----
+size_t x() const noexcept
+----
+   a@ Return the value of dimension [code]#Dimensions - 1# of the [code]#range#
+      object.
+
+a@
+[source]
+----
+size_t y() const noexcept
+----
+   a@ Return the value of dimension [code]#Dimensions - 2# of the [code]#range#
+      object, or 1 if [code]#Dimensions < 2#.
+
+a@
+[source]
+----
+size_t z() const noexcept
+----
+   a@ Return the value of dimension [code]#Dimensions - 3# of the [code]#range#
+      object, or 1 if [code]#Dimensions < 3#.
+
 a@
 [source]
 ----
@@ -12322,6 +12346,30 @@ size_t operator[](int dimension) const
    a@ Return the value of the requested dimension of the [code]#id#
       object.
 
+a@
+[source]
+----
+size_t x() const noexcept
+----
+   a@ Return the value of dimension [code]#Dimensions - 1# of the [code]#id#
+      object.
+
+a@
+[source]
+----
+size_t y() const noexcept
+----
+   a@ Return the value of dimension [code]#Dimensions - 2# of the [code]#id#
+      object, or 0 if [code]#Dimensions < 2#.
+
+a@
+[source]
+----
+size_t z() const noexcept
+----
+   a@ Return the value of dimension [code]#Dimensions - 3# of the [code]#id#
+      object, or 0 if [code]#Dimensions < 3#.
+
 a@
 [source]
 ----

adoc/headers/id.h

@@ -27,6 +27,10 @@ template <int Dimensions = 1> class id {
   size_t& operator[](int dimension);
   size_t operator[](int dimension) const;
 
+  size_t x() const noexcept;
+  size_t y() const noexcept;
+  size_t z() const noexcept;
+
   // only available if Dimensions == 1
   operator size_t() const;
 

adoc/headers/range.h

@@ -24,6 +24,10 @@ template <int Dimensions = 1> class range {
   size_t& operator[](int dimension);
   size_t operator[](int dimension) const;
 
+  size_t x() const noexcept;
+  size_t y() const noexcept;
+  size_t z() const noexcept;
+
   size_t size() const;
 
   // OP is: +, -, *, /, %, <<, >>, &, |, ^, &&, ||, <, >, <=, >=