--- /dev/null
+/* -*- C++ -*- ------------------------------------------------------------
+
+Copyright (c) 2007 Jesse Anders and Demian Nave http://cmldev.net/
+
+The Configurable Math Library (CML) is distributed under the terms of the
+Boost Software License, v1.0 (see cml/LICENSE for details).
+
+ *-----------------------------------------------------------------------*/
+/** @file
+ * @brief
+ *
+ * Defines the fixed-size and runtime-sized external 1D arrays.
+ *
+ * @todo Need a better way to designate non-resizable, run-time sized
+ * arrays (e.g. by a resizeable tag).
+ */
+
+#ifndef external_1D_h
+#define external_1D_h
+
+#include <cml/core/common.h>
+#include <cml/core/cml_meta.h>
+#include <cml/core/cml_assert.h>
+#include <cml/external.h>
+
+namespace cml {
+
+/** Fixed-size external 1D array.
+ *
+ * Both the memory and the size are fixed at compile time, and cannot be
+ * changed.
+ */
+template<typename Element, int Size = -1>
+class external_1D
+{
+ public:
+
+ /* Require Size > 0: */
+ CML_STATIC_REQUIRE(Size > 0);
+
+ /* Record the generator: */
+ typedef external<Size,-1> generator_type;
+
+ /* Standard: */
+ typedef Element value_type;
+ typedef Element* pointer;
+ typedef Element& reference;
+ typedef const Element& const_reference;
+ typedef const Element* const_pointer;
+
+ /* Array implementation: */
+ typedef value_type array_impl[Size];
+
+ /* For matching by memory type: */
+ typedef external_memory_tag memory_tag;
+
+ /* For matching by size type: */
+ typedef fixed_size_tag size_tag;
+
+ /* For matching by resizability: */
+ typedef not_resizable_tag resizing_tag;
+
+ /* For matching by dimensions: */
+ typedef oned_tag dimension_tag;
+
+
+ public:
+
+ /** The length as an enumerated value. */
+ enum { array_size = Size };
+
+
+ public:
+
+ external_1D(pointer const ptr)
+ : m_data(ptr) {}
+
+
+ public:
+
+ /** Return the number of elements in the array. */
+ size_t size() const { return size_t(array_size); }
+
+ /** Access to the data as a C array.
+ *
+ * @param i a size_t index into the array.
+ * @return a mutable reference to the array value at i.
+ *
+ * @note This function does not range-check the argument.
+ */
+ reference operator[](size_t i) { return m_data[i]; }
+
+ /** Const access to the data as a C array.
+ *
+ * @param i a size_t index into the array.
+ * @return a const reference to the array value at i.
+ *
+ * @note This function does not range-check the argument.
+ */
+ const_reference operator[](size_t i) const { return m_data[i]; }
+
+ /** Return access to the data as a raw pointer. */
+ pointer data() { return m_data; }
+
+ /** Return access to the data as a raw pointer. */
+ const_pointer data() const { return m_data; }
+
+
+ protected:
+
+ pointer const m_data;
+
+
+ private:
+
+ /* Initialization without an argument isn't allowed: */
+ external_1D();
+};
+
+/** Run-time sized external 1D array.
+ *
+ * Both the memory and the size are fixed at run-time, and cannot be
+ * changed. This is a specialization for the case that Rows and Cols are
+ * not specified (i.e. given as the default of -1,-1).
+ */
+template<typename Element>
+class external_1D<Element,-1>
+{
+ public:
+
+ /* Record the generator. Note: this is *not* unique, as it is the same
+ * generator used by external_2D. However, external_2D is used only by
+ * matrix<> classes, so this is not a problem.
+ */
+ typedef external<> generator_type;
+
+ /* Standard: */
+ typedef Element value_type;
+ typedef Element* pointer;
+ typedef Element& reference;
+ typedef const Element& const_reference;
+ typedef const Element* const_pointer;
+
+ /* For matching by memory type: */
+ typedef external_memory_tag memory_tag;
+
+ /* For matching by size type: */
+ typedef dynamic_size_tag size_tag;
+
+ /* For matching by resizability: */
+ typedef not_resizable_tag resizing_tag;
+
+ /* For matching by dimensions: */
+ typedef oned_tag dimension_tag;
+
+
+ public:
+
+ /** The length as an enumerated value. */
+ enum { array_size = -1 };
+
+
+ public:
+
+ external_1D(pointer const ptr, size_t size)
+ : m_data(ptr), m_size(size) {}
+
+
+ public:
+
+ /** Return the number of elements in the array. */
+ size_t size() const { return m_size; }
+
+ /** Access to the data as a C array.
+ *
+ * @param i a size_t index into the array.
+ * @return a mutable reference to the array value at i.
+ *
+ * @note This function does not range-check the argument.
+ */
+ reference operator[](size_t i) { return m_data[i]; }
+
+ /** Const access to the data as a C array.
+ *
+ * @param i a size_t index into the array.
+ * @return a const reference to the array value at i.
+ *
+ * @note This function does not range-check the argument.
+ */
+ const_reference operator[](size_t i) const { return m_data[i]; }
+
+ /** Return access to the data as a raw pointer. */
+ pointer data() { return m_data; }
+
+ /** Return access to the data as a raw pointer. */
+ const_pointer data() const { return m_data; }
+
+
+ protected:
+
+ pointer const m_data;
+ const size_t m_size;
+
+
+ private:
+
+ /* Initialization without an argument isn't allowed: */
+ external_1D();
+};
+
+} // namespace cml
+
+#endif
+
+// -------------------------------------------------------------------------
+// vim:ft=cpp