/*****************************************************************************/ /* XDMF */ /* eXtensible Data Model and Format */ /* */ /* Id : XdmfArray.hpp */ /* */ /* Author: */ /* Kenneth Leiter */ /* kenneth.leiter@arl.army.mil */ /* US Army Research Laboratory */ /* Aberdeen Proving Ground, MD */ /* */ /* Copyright @ 2011 US Army Research Laboratory */ /* All Rights Reserved */ /* See Copyright.txt for details */ /* */ /* This software is distributed WITHOUT ANY WARRANTY; without */ /* even the implied warranty of MERCHANTABILITY or FITNESS */ /* FOR A PARTICULAR PURPOSE. See the above copyright notice */ /* for more information. */ /* */ /*****************************************************************************/ #ifndef XDMFARRAY_HPP_ #define XDMFARRAY_HPP_ // C Compatible Includes #include "XdmfCore.hpp" #include "XdmfItem.hpp" #include "XdmfArrayReference.hpp" #include "XdmfHeavyDataController.hpp" #ifdef __cplusplus // Forward Declarations class XdmfArrayType; class XdmfHeavyDataController; // Includes #include // in order to support uint64 type, we need to increase the number of types // that can be used in a boost::variant // note : available values for BOOST_MPL_LIMIT_LIST_SIZE are 10, 20, 30, 40 and 50, // default is 20, which not enough, so increase to 30 #define BOOST_MPL_CFG_NO_PREPROCESSED_HEADERS #if !defined(BOOST_MPL_LIMIT_LIST_SIZE) #define BOOST_MPL_LIMIT_LIST_SIZE 30 #elif BOOST_MPL_LIMIT_LIST_SIZE < 30 #undef BOOST_MPL_LIMIT_LIST_SIZE #define BOOST_MPL_LIMIT_LIST_SIZE 30 #endif #include /** * @brief Provides storage for data values that are read in or will be * written to heavy data on disk. * * XdmfArray provides a single interface for storing a variety of data * types. The data type stored is determined by the type initially * inserted into the array. An array can be initialized with a * specific data type before insertion of values by calling * initialize(). * * An XdmfArray is associated with heavy data files on disk through an * XdmfHeavyDataController. When an Xdmf file is read from disk, * XdmfHeavyDataControllers are attached to all created XdmfArrays * that contain values stored in heavy data. These values are not read * into memory when the Xdmf file is parsed. The array is * uninitialized and the return value of isInitialized() is false. In * order to read the heavy data values into memory, read() must be * called. This will cause the array to ask for values to be read from * disk using the XdmfHeavyDataController. After the values have been * read from heavy data on disk, isInitialized() will return true. * * This version of Xdmf allows for multiple controllers to be added to * a single array. Be aware that doing this makes the files written * incompatible with previous editions. * * XdmfArray allows for insertion and retrieval of data in two * fundamental ways: * * By Copy: * * getValue * getValues * insert * pushBack * * XdmfArray stores its own copy of the data. Modifications to the * data stored in the XdmfArray will not change values stored in the * original array. * * By Shared Reference: * * getValuesInternal * setValuesInternal * * XdmfArray shares a reference to the data. No copy is * made. XdmfArray holds a shared pointer to the original data. * Modifications to the data stored in the XdmfArray also causes * modification to values stored in the original array. * * Xdmf supports the following datatypes: * Int8 * Int16 * Int32 * Int64 * Float32 * Float64 * UInt8 * UInt16 * UInt32 * UInt64 * String */ class XDMFCORE_EXPORT XdmfArray : public XdmfItem { public: enum ReadMode { Controller, Reference }; /** * Create a new XdmfArray. * * Example of use: * * C++ * * @dontinclude ExampleXdmfArray.cpp * @skipline //#initialization * @until //#initialization * * Python * * @dontinclude XdmfExampleArray.py * @skipline #//initialization * @until #//initialization * * @return Constructed XdmfArray. */ static shared_ptr New(); virtual ~XdmfArray(); LOKI_DEFINE_VISITABLE(XdmfArray, XdmfItem) XDMF_CHILDREN(XdmfArray, XdmfHeavyDataController, HeavyDataController, Name) static const std::string ItemTag; /** * Remove all values from this array. * * Example of use: * * C++ * * @dontinclude ExampleXdmfArray.cpp * @skipline //#initialization * @until //#initialization * @skipline //#clear * @until //#clear * * Python * * @dontinclude XdmfExampleArray.py * @skipline #//initialization * @until #//initialization * @skipline #//clear * @until #//clear */ void clear(); /** * Remove a value from this array. * * Example of use: * * C++ * * @dontinclude ExampleXdmfArray.cpp * @skipline //#initialization * @until //#initialization * @skipline //#erase * @until //#erase * * Python * * @dontinclude XdmfExampleArray.py * @skipline #//initialization * @until #//initialization * @skipline #//arraydefaultvalues * @until #//arraydefaultvalues * @skipline #//erase * @until #//erase * * @param index The index of the value to be removed */ void erase(const unsigned int index); /** * Get the data type of this array. * * Example of use: * * C++ * * @dontinclude ExampleXdmfArray.cpp * @skipline //#initialization * @until //#initialization * @skipline //#getArrayType * @until //#getArrayType * * Python * * @dontinclude XdmfExampleArray.py * @skipline #//initialization * @until #//initialization * @skipline #//getArrayType * @until #//getArrayType * * @return An XdmfArrayType containing the data type for the array. */ shared_ptr getArrayType() const; /** * Get the capacity of this array, the number of values the array * can store without reallocation. * * Example of use: * * C++ * * @dontinclude ExampleXdmfArray.cpp * @skipline //#initialization * @until //#initialization * @skipline //#getCapacity * @until //#getCapacity * * Python * * @dontinclude XdmfExampleArray.py * @skipline #//initialization * @until #//initialization * @skipline #//getCapacity * @until #//getCapacity * * @return The capacity of this array. */ unsigned int getCapacity() const; /** * Get the dimensions of the array. * If the array isn't initialized the dimensions * will be based on the heavyDataControllers it has, if any. * * Example of use: * * C++ * * @dontinclude ExampleXdmfArray.cpp * @skipline //#initialization * @until //#initialization * @skipline //#getDimensions * @until //#getDimensions * * Python * * @dontinclude XdmfExampleArray.py * @skipline #//initialization * @until #//initialization * @skipline #//getDimensions * @until #//getDimensions * * @return The dimensions of the array. */ std::vector getDimensions() const; /** * Get the dimensions of the array as a string. * * Example of use: * * C++ * * @dontinclude ExampleXdmfArray.cpp * @skipline //#initialization * @until //#initialization * @skipline //#getDimensionsString * @until //#getDimensionsString * * Python * * @dontinclude XdmfExampleArray.py * @skipline #//initialization * @until #//initialization * @skipline #//getDimensionsString * @until #//getDimensionsString * * @return The dimensions of the array as a string. */ std::string getDimensionsString() const; std::map getItemProperties() const; std::string getItemTag() const; /** * Get the name of the array. * * Example of use: * * C++ * * @dontinclude ExampleXdmfArray.cpp * @skipline //#initialization * @until //#initialization * @skipline //#setName * @until //#setName * @skipline //#getName * @until //#getName * * Python * * @dontinclude XdmfExampleArray.py * @skipline #//initialization * @until #//initialization * @skipline #//setName * @until #//setName * @skipline #//getName * @until #//getName * * @return A string containing the name of the array. */ virtual std::string getName() const; /** * Gets the method this array will be written/read. * Possible choices are: Controller, and Reference * * Example of use: * * C++ * * @dontinclude ExampleXdmfArray.cpp * @skipline //#initialization * @until //#initialization * @skipline //#setReference * @until //#setReference * @skipline //#setReadMode * @until //#setReadMode * @skipline //#getReadMode * @until //#getReadMode * * * Python * * @dontinclude XdmfExampleArray.py * @skipline #//initialization * @until #//initialization * @skipline #//setReference * @until #//setReference * @skipline #//setReadMode * @until #//setReadMode * @skipline #//getReadMode * @until #//getReadMode * * @return What method will be used when reading/writing the array */ ReadMode getReadMode() const; /** * Get the number of values stored in this array. * * Example of use: * * C++ * * @dontinclude ExampleXdmfArray.cpp * @skipline //#initialization * @until //#initialization * @skipline //#getSize * @until //#getSize * * Python * * @dontinclude XdmfExampleArray.py * @skipline #//initialization * @until #//initialization * @skipline #//getSize * @until #//getSize * * @return The number of values stored in this array. */ unsigned int getSize() const; /** * Gets the array reference that the array will pull from when reading from a reference. * * Example of use: * * C++ * * @dontinclude ExampleXdmfArray.cpp * @skipline //#initialization * @until //#initialization * @skipline //#setReference * @until //#setReference * @skipline //#getReference * @until //#getReference * * Python * * @dontinclude XdmfExampleArray.py * @skipline #//initialization * @until #//initialization * @skipline #//setReference * @until #//setReference * @skipline #//getReference * @until #//getReference * * @return The reference being pulled from */ shared_ptr getReference(); /** * Get a copy of a single value stored in this array. * * Example of use: * * C++ * * @dontinclude ExampleXdmfArray.cpp * @skipline //#initialization * @until //#initialization * @skipline //#datapointersetup * @until //#datapointersetup * @skipline //#initsharedvector * @until //#initsharedvector * @skipline //#getValueindex * @until //#getValueindex * * Python * * @dontinclude XdmfExampleArray.py * @skipline #//initialization * @until #//initialization * @skipline #//arraydefaultvalues * @until #//arraydefaultvalues * @skipline #//getValueindex * @until #//getValueindex * * @return The requested value. */ template T getValue(const unsigned int index) const; /** * Get a copy of the values stored in this array * * Example of use: * * C++ * * @dontinclude ExampleXdmfArray.cpp * @skipline //#initialization * @until //#initialization * @skipline //#getValues * @until //#getValues * * Python: * This function is not supported in Python, * it is replaced by the getNumpyArray function * * @dontinclude XdmfExampleArray.py * @skipline #//initialization * @until #//initialization * @skipline #//arraydefaultvalues * @until #//arraydefaultvalues * @skipline #//getNumpyArray * @until #//getNumpyArray * * @param startIndex The index in this array to begin copying from. * @param valuesPointer A pointer to an array to copy into. * @param numValues The number of values to copy. * @param arrayStride Number of values to stride in this array * between each copy. * @param valuesStride Number of values to stride in the pointer * between each copy. */ template void getValues(const unsigned int startIndex, T * const valuesPointer, const unsigned int numValues = 1, const unsigned int arrayStride = 1, const unsigned int valuesStride = 1) const; /** * Get a smart pointer to the internal values stored in this array. * * Example of use: * * C++ * * @dontinclude ExampleXdmfArray.cpp * @skipline //#initialization * @until //#initialization * @skipline //#getValuesInternalvector * @until //#getValuesInternalvector * * Python: * Python does not support this version of the getValuesInternal function, * it defaults to the version that returns a void pointer * * @return A smart pointer to the internal vector of values stored * in this array. */ template shared_ptr > getValuesInternal(); /** * Get a pointer to the internal values stored in this array. * * Example of use: * * C++ * * @dontinclude ExampleXdmfArray.cpp * @skipline //#initialization * @until //#initialization * @skipline //#getValuesInternalvoid * @until //#getValuesInternalvoid * * Python * * @dontinclude XdmfExampleArray.py * @skipline //#initialization * @until //#initialization * @skipline #//getValuesInternal * @until #//getValuesInternal * * @return A void pointer to the first value stored in this array. */ void * getValuesInternal(); /** * Get a pointer to the internal values stored in this array (const * version). * * Example of use: * * @dontinclude ExampleXdmfArray.cpp * @skipline //#initialization * @until //#initialization * @skipline //#getValuesInternalvoidconst * @until //#getValuesInternalvoidconst * * Python: * Python does not support this version of the getValuesInternal function, * it defaults to the version that returns a void pointer * * @return A void pointer to the first value stored in this array. */ const void * getValuesInternal() const; /** * Get the values stored in this array as a string. * * Example of use: * * C++ * * @dontinclude ExampleXdmfArray.cpp * @skipline //#initialization * @until //#initialization * @skipline //#getValuesString * @until //#getValuesString * * Python * * @dontinclude XdmfExampleArray.py * @skipline #//initialization * @until #//initialization * @skipline #//getValuesparse * @until #//getValuesparse * * @return A string containing the contents of the array. */ std::string getValuesString() const; /** * Initialize the array to a specific size. * * Example of use: * * C++ * * @dontinclude ExampleXdmfArray.cpp * @skipline //#initialization * @until //#initialization * @skipline //#sizedeclaration * @until //#sizedeclaration * @skipline //#initializesingletemplate * @until //#initializesingletemplate * * Python: Does not support this version of initialize * * @param size The number of values in the initialized array. * * @return A smart pointer to the internal vector of values * initialized in this array. */ template shared_ptr > initialize(const unsigned int size = 0); /** * Initialize the array to specific dimensions. * * Example of use: * * C++ * * @dontinclude ExampleXdmfArray.cpp * @skipline //#initialization * @until //#initialization * @skipline //#sizevectordeclaration * @until //#sizevectordeclaration * @skipline //#initializevectortemplate * @until //#initializevectortemplate * * Python: Does not support this version of initialize * * @param dimensions The dimensions of the initialized array. * * @return A smart pointer to the internal vector of values * initialized in this array. */ template shared_ptr > initialize(const std::vector & dimensions); /** * Initialize the array to contain a specified amount of a particular type. * * Example of use: * * C++ * * @dontinclude ExampleXdmfArray.cpp * @skipline //#initialization * @until //#initialization * @skipline //#sizedeclaration * @until //#sizedeclaration * @skipline //#initializesingletype * @until //#initializesingletype * * Python * * @dontinclude XdmfExampleArray.py * @skipline #//initialization * @until #//initialization * @skipline #//initializesingle * @until #//initializesingle * * @param arrayType The type of array to initialize. * @param size The number of values in the initialized array. */ void initialize(const shared_ptr & arrayType, const unsigned int size = 0); /** * Initialize the array with specified dimensions to contain a particular type. * * Example of use: * * C++ * * @dontinclude ExampleXdmfArray.cpp * @skipline //#initialization * @until //#initialization * @skipline //#sizevectordeclaration * @until //#sizevectordeclaration * @skipline //#initializevectortype * @until //#initializevectortype * * Python * * @dontinclude XdmfExampleArray.py * @skipline #//initialization * @until #//initialization * @skipline #//initializevector * @until #//initializevector * * @param arrayType The type of array to initialize. * @param dimensions The number dimensions of the initialized array. */ void initialize(const shared_ptr & arrayType, const std::vector & dimensions); using XdmfItem::insert; /** * Insert value into this array * * Example of use: * * C++ * * @dontinclude ExampleXdmfArray.cpp * @skipline //#initialization * @until //#initialization * @skipline //#pointinsertvalues * @until //#pointinsertvalues * @skipline //#pointinsert * @until //#pointinsert * * Python * * @dontinclude XdmfExampleArray.py * @skipline #//initialization * @until #//initialization * @skipline #//pointinsert * @until #//pointinsert * * @param index The index in this array to insert. * @param value The value to insert */ template void insert(const unsigned int index, const T & value); /** * Insert values from an XdmfArray into this array. * * Example of use: * * C++ * * @dontinclude ExampleXdmfArray.cpp * @skipline //#initialization * @until //#initialization * @skipline //#datapointersetup * @until //#datapointersetup * @skipline //#pointerinsert * @until //#pointerinsert * @skipline //#arrayinsert * @until //#arrayinsert * * Python * * @dontinclude XdmfExampleArray.py * @skipline #//initialization * @until #//initialization * @skipline #//insertarray * @until #//insertarray * * @param startIndex The index in this array to begin insertion. * @param values A shared pointer to an XdmfArray to copy * into this array. * @param valuesStartIndex The index in the XdmfArray to begin copying. * @param numValues The number of values to copy into this array. * @param arrayStride Number of values to stride in this array * between each copy. * @param valuesStride Number of values to stride in the XdmfArray * between each copy. */ void insert(const unsigned int startIndex, const shared_ptr values, const unsigned int valuesStartIndex = 0, const unsigned int numValues = 1, const unsigned int arrayStride = 1, const unsigned int valuesStride = 1); /** * Insert values from an XdmfArray into this array. This is the multidimensional version. * * Example of use: * * C++ * * @dontinclude ExampleXdmfArray.cpp * @skipline //#insertmultidim * @until //#insertmultidim * * Python * * @dontinclude XdmfExampleArray.py * @skipline #//insertmultidim * @until #//insertmultidim * * @param startIndex The index in this array to begin * insertion for each dimension * @param values A shared pointer to an XdmfArray * to copy into this array. * @param valuesStartIndex The index in the XdmfArray to begin * copying for each dimension of the * source array * @param numValues The number of values to copy into this * array for each dimension on the * source array * @param numInserted The number of strides to make across * the array being written to for each * dimension * @param arrayStride Number of values to stride in this array * between each copy for each dimension * @param valuesStride Number of values to stride in the * XdmfArray between each copy for each * dimension of the source array */ void insert(const std::vector startIndex, const shared_ptr values, const std::vector valuesStartIndex, const std::vector numValues, const std::vector numInserted, const std::vector arrayStride, const std::vector valuesStride); /** * Insert values into this array. * * Example of use: * * C++ * * @dontinclude ExampleXdmfArray.cpp * @skipline //#initialization * @until //#initialization * @skipline //#datapointersetup * @until //#datapointersetup * @skipline //#pointerinsert * @until //#pointerinsert * * Python * * @dontinclude XdmfExampleArray.py * @skipline #//initialization * @until #//initialization * @skipline #//insertlist * @until #//insertlist * * @param startIndex The index in this array to begin insertion. * @param valuesPointer A pointer to the values to copy into this array. * @param numValues The number of values to copy into this array. * @param arrayStride Number of values to stride in this array between * each copy. * @param valuesStride Number of values to stride in the pointer between * each copy. */ template void insert(const unsigned int startIndex, const T * const valuesPointer, const unsigned int numValues, const unsigned int arrayStride = 1, const unsigned int valuesStride = 1); /** * Returns whether the array is initialized (contains values in * memory). * * Example of use: * * C++ * * @dontinclude ExampleXdmfArray.cpp * @skipline //#initialization * @until //#initialization * @skipline //#isInitialized * @until //#isInitialized * * Python * * @dontinclude XdmfExampleArray.py * @skipline #//initialization * @until #//initialization * @skipline #//isInitialized * @until #//isInitialized */ virtual bool isInitialized() const; /** * Copy a value to the back of this array * * Example of use; * * C++ * * @dontinclude ExampleXdmfArray.cpp * @skipline //#initialization * @until //#initialization * @skipline //#pointinsertvalues * @until //#pointinsertvalues * @skipline //#pushBack * @until //#pushBack * * Python * * @dontinclude XdmfExampleArray.py * @skipline #//initialization * @until #//initialization * @skipline #//pushBack * @until #//pushBack * * @param value The value to be inserted */ template void pushBack(const T & value); /** * Get the first heavy data controller attached to this array. * * Example of use: * * C++ * * @dontinclude ExampleXdmfArray.cpp * @skipline //#initialization * @until //#initialization * @skipline //#getHeavyDataController * @until //#getHeavyDataController * * Python * * @dontinclude XdmfExampleArray.py * @skipline #//initialization * @until #//initialization * @skipline #//getHeavyDataController * @until #//getHeavyDataController * * @return The heavy data controller attached to this array. */ shared_ptr getHeavyDataController(); /** * Get the first heavy data controller attached to this array. (const version) * * Example of use: * * C++ * * @dontinclude ExampleXdmfArray.cpp * @skipline //#initialization * @until //#initialization * @skipline //#getHeavyDataControllerconst * @until //#getHeavyDataControllerconst * * Python: Doesn't support a constant version of this function * * @return The heavy data controller attached to this array. */ shared_ptr getHeavyDataController() const; /** * Replace all controllers attached to this array with the controller provided. * * Example of use: * * C++ * * @dontinclude ExampleXdmfArray.cpp * @skipline //#initialization * @until //#initialization * @skipline //#getHeavyDataController * @until //#getHeavyDataController * @skipline //#setHeavyDataController * @until //#setHeavyDataController * * Python * * @dontinclude XdmfExampleArray.py * @skipline #//initialization * @until #//initialization * @skipline #//getHeavyDataController * @until #//getHeavyDataController * @skipline #//setHeavyDataController * @until #//setHeavyDataController * * @param newController The heavy data controller to attach to this array. */ void setHeavyDataController(shared_ptr newController); /** * Sets the controllers attached to this array to the ones contained * in the provided vector. * * Example of use: * * C++ * * @dontinclude ExampleXdmfArray.cpp * @skipline //#initialization * @until //#initialization * @skipline //#setHeavyDataControllerVector * @until //#setHeavyDataControllerVector * * Python * * @dontinclude XdmfExampleArray.py * @skipline #//initialization * @until #//initialization * @skipline #//setHeavyDataControllerVector * @until #//setHeavyDataControllerVector * * @param newControllers The controllers to be set to the array. */ void setHeavyDataController(std::vector > & newControllers); /** * Read data from disk into memory. * * Example of use: * * C++ * * @dontinclude ExampleXdmfArray.cpp * @skipline //#initialization * @until //#initialization * @skipline //#read * @until //#read * * Python * * @dontinclude XdmfExampleArray.py * @skipline #//initialization * @until #//initialization * @skipline #//isInitialized * @until #//isInitialized */ void read(); /** * Reads data from the attached controllers to the internal data storage. * * Example of use: * * C++ * * @dontinclude ExampleXdmfArray.cpp * @skipline //#initialization * @until //#initialization * @skipline //#getHeavyDataController * @until //#getHeavyDataController * @skipline //#setHeavyDataController * @until //#setHeavyDataController * @skipline //#readController * @until //#readController * * Python * * @dontinclude XdmfExampleArray.py * @skipline #//initialization * @until #//initialization * @skipline #//getHeavyDataController * @until #//getHeavyDataController * @skipline #//setHeavyDataController * @until #//setHeavyDataController * @skipline #//readController * @until #//readController */ void readController(); /** * Reads the data pointed to by the array reference into the array. * * Example of use: * * C++ * * @dontinclude ExampleXdmfArray.cpp * @skipline //#initialization * @until //#initialization * @skipline //#setReference * @until //#setReference * @skipline //#readReference * @until //#readReference * * Python * * @dontinclude XdmfExampleArray.py * @skipline #//initialization * @until #//initialization * @skipline #//setReference * @until #//setReference * @skipline #//readReference * @until #//readReference */ void readReference(); /** * Release all data currently held in memory. * * Example of use: * * C++ * * @dontinclude ExampleXdmfArray.cpp * @skipline //#initialization * @until //#initialization * @skipline //#release * @until //#release * * Python * * @dontinclude XdmfExampleArray.py * @skipline #//initialization * @until #//initialization * @skipline #//release * @until #//release */ void release(); /** * Set the capacity of the array to at least size. * * Example of use: * * C++ * * @dontinclude ExampleXdmfArray.cpp * @skipline //#initialization * @until //#initialization * @skipline //#sizedeclaration * @until //#sizedeclaration * @skipline //#reserve * @until //#reserve * * Python * * @dontinclude XdmfExampleArray.py * @skipline #//initialization * @until #//initialization * @skipline #//reserve * @until #//reserve * * @param size The capacity to set this array to. */ void reserve(const unsigned int size); /** * Resizes the array to contain a number of values. If numValues is * larger than the current size, values are appended to the end of * the array equal to value. If numValues is less than the current * size, values at indices larger than numValues are removed. * * Example of use: * * C++ * * @dontinclude ExampleXdmfArray.cpp * @skipline //#initialization * @until //#initialization * @skipline //#sizedeclaration * @until //#sizedeclaration * @skipline //#resizesingle * @until //#resizesingle * * Python * * @dontinclude XdmfExampleArray.py * @skipline #//initialization * @until #//initialization * @skipline #//arraydefaultvalues * @until #//arraydefaultvalues * @skipline #//resizesingle * @until #//resizesingle * * @param numValues The number of values to resize this array to. * @param value The number to initialize newly created * values to, if needed. */ template void resize(const unsigned int numValues, const T & value = 0); /** * Resizes the array to specified dimensions. If the number of * values specified by the dimensions is larger than the current * size, values are appended to the end of the array equal to * value. If numValues is less than the current size, values at * indices larger than numValues are removed. * * Example of use: * * C++ * * @dontinclude ExampleXdmfArray.cpp * @skipline //#initialization * @until //#initialization * @skipline //#sizevectordeclaration * @until //#sizevectordeclaration * @skipline //#resizevector * @until //#resizevector * * Python * * @dontinclude XdmfExampleArray.py * @skipline #//initialization * @until #//initialization * @skipline #//arraydefaultvalues * @until #//arraydefaultvalues * @skipline #//resizevector * @until #//resizevector * * @param dimensions The dimensions to resize the array to. * @param value The number to intialize newly created values to, * if needed. */ template void resize(const std::vector & dimensions, const T & value = 0); /** * Sets the array reference from which the Array will fill when readReference is called. * * Example of use: * * C++ * * @dontinclude ExampleXdmfArray.cpp * @skipline //#initialization * @until //#initialization * @skipline //#setReference * @until //#setReference * * * Python * * @dontinclude XdmfExampleArray.py * @skipline #//initialization * @until #//initialization * @skipline #//setReference * @until #//setReference * * @param newReference The reference to be associated with this array */ void setReference(shared_ptr newReference); /** * Set the name of the array. * * Example of use: * * C++ * * @dontinclude ExampleXdmfArray.cpp * @skipline //#initialization * @until //#initialization * @skipline //#setName * @until //#setName * * Python * * @dontinclude XdmfExampleArray.py * @skipline #//initialization * @until #//initialization * @skipline #//setName * @until #//setName * * @param name Name of the array to set. */ virtual void setName(const std::string & name); /** * Sets the method this array will be written/read. * Possible choices are: Controller, and Reference * * Example of use: * * C++ * * @dontinclude ExampleXdmfArray.cpp * @skipline //#initialization * @until //#initialization * @skipline //#setReference * @until //#setReference * @skipline //#setReadMode * @until //#setReadMode * * * Python * * @dontinclude XdmfExampleArray.py * @skipline #//initialization * @until #//initialization * @skipline #//setReference * @until #//setReference * @skipline #//setReadMode * @until #//setReadMode * * @param newStatus The method that the array will be read/written */ void setReadMode(ReadMode newStatus = XdmfArray::Controller); /** * Sets the values of this array to the values stored in the * arrayPointer array. No copy is made. Modifications to the array * are not permitted through the XdmfArray API. Any calls through * the XdmfArray API to modify the array (i.e. any non-const * function) will result in the array being copied into internal * storage. The internal copy is then modified. This prevents * situations where a realloc of the pointer could cause other * references to become invalid. The caller of this method can * continue to modify the values stored in arrayPointer on its * own. This function is meant for applications that have their own * array data structures that merely use Xdmf to output the data, an * operation that should not require a copy. Other applications that * use Xdmf for in memory data storage should avoid this function. * * Example of use: * * C++ * * @dontinclude ExampleXdmfArray.cpp * @skipline //#initialization * @until //#initialization * @skipline //#datapointersetup * @until //#datapointersetup * @skipline //#setValuesInternalpointer * @until //#setValuesInternalpointer * * Python: does not support setValuesInternal * * @param arrayPointer A pointer to an array to store in * this XdmfArray. * @param numValues The number of values in the array. * @param transferOwnership Whether to transfer responsibility for * deletion of the array to XdmfArray. */ template void setValuesInternal(const T * const arrayPointer, const unsigned int numValues, const bool transferOwnership = 0); /** * Sets the values of this array to the values stored in the * vector. No copy is made. The caller of this method retains * ownership of the data and must ensure that the array is still * valid for the entire time Xdmf needs it. * * Example of use: * * C++ * * @dontinclude ExampleXdmfArray.cpp * @skipline //#initialization * @until //#initialization * @skipline //#initinternalvector * @until //#initinternalvector * @skipline //#setValuesInternalvector * @until //#setValuesInternalvector * * Python: does not support setValuesInternal * * @param array A vector to store in this XdmfArray. * @param transferOwnership Whether to transfer responsibility for * deletion of the array to XdmfArray. */ template void setValuesInternal(std::vector & array, const bool transferOwnership = 0); /** * Sets the values of this array to the values stored in the * vector. No copy is made. This array shares ownership with other * references to the smart pointer. * * Example of use: * * C++ * * @dontinclude ExampleXdmfArray.cpp * @skipline //#initialization * @until //#initialization * @skipline //#initinternalvector * @until //#initinternalvector * @skipline //#initsharedvector * @until //#initsharedvector * @skipline //#setValuesInternalsharedvector * @until //#setValuesInternalsharedvector * * Python: does not support setValuesInternal * * @param array A smart pointer to a vector to store in this array. */ template void setValuesInternal(const shared_ptr > array); /** * Exchange the contents of the vector with the contents of this * array. No copy is made. The internal arrays are swapped. * * Example of use * * C++ * * @dontinclude ExampleXdmfArray.cpp * @skipline //#initialization * @until //#initialization * @skipline //#initinternalvector * @until //#initinternalvector * @skipline //#swapvector * @until //#swapvector * * Python: The Python version only supports swapping XdmfArrays * * @param array A vector to exchange values with. * @return bool whether the swap was successful. */ template bool swap(std::vector & array); /** * Exchange the contents of the vector with the contents of this * array. No copy is made. The internal arrays are swapped. * * Example of use * * C++ * * @dontinclude ExampleXdmfArray.cpp * @skipline //#initialization * @until //#initialization * @skipline //#initinternalvector * @until //#initinternalvector * @skipline //#initsharedvector * @until //#initsharedvector * @skipline //#swapsharedvector * @until //#swapsharedvector * * Python: The Python version only supports swapping XdmfArrays * * @param array A smart pointer to a vector to exchange values with. * @return bool whether the swap was successful. */ template bool swap(const shared_ptr > array); /** * Exchange the contents of an XdmfArray with the contents of this * array. No copy is made. The internal arrays are swapped. * * Example of use * * C++ * * @dontinclude ExampleXdmfArray.cpp * @skipline //#initialization * @until //#initialization * @skipline //#swaparray * @until //#swaparray * * Python * * @dontinclude XdmfExampleArray.py * @skipline #//initialization * @until #//initialization * @skipline #//arraydefaultvalues * @until #//arraydefaultvalues * @skipline //#swap * @until //#swap * * @param array A smart pointer to a vector to exchange values with. */ void swap(const shared_ptr array); virtual void traverse(const shared_ptr visitor); XdmfArray(XdmfArray &); protected: XdmfArray(); virtual void populateItem(const std::map & itemProperties, const std::vector > & childItems, const XdmfCoreReader * const reader); private: XdmfArray(const XdmfArray &); // Not implemented. void operator=(const XdmfArray &); // Not implemented. // Variant Visitor Operations class Clear; class Erase; class GetArrayType; class GetCapacity; template class GetValue; template class GetValues; class GetValuesPointer; class GetValuesString; template class Insert; class InsertArray; class InternalizeArrayPointer; class IsInitialized; struct NullDeleter; template class PushBack; class Reserve; template class Resize; class Size; /** * After setValues() is called, XdmfArray stores a pointer that is * not allowed to be modified through the XdmfArray API. If the user * desires to modify the contents of the pointer, they must do so * without calling any non-const functions of XdmfArray. If they do * call non-const functions of XdmfArray, we attempt to accommodate * by copying the array pointer into internal data structures. */ void internalizeArrayPointer(); typedef boost::variant< boost::blank, shared_ptr >, shared_ptr >, shared_ptr >, shared_ptr >, shared_ptr >, shared_ptr >, shared_ptr >, shared_ptr >, shared_ptr >, shared_ptr >, shared_ptr >, shared_ptr >, boost::shared_array, boost::shared_array, boost::shared_array, boost::shared_array, boost::shared_array, boost::shared_array, boost::shared_array, boost::shared_array, boost::shared_array, boost::shared_array, boost::shared_array > ArrayVariant; unsigned int mArrayPointerNumValues; std::vector mDimensions; std::string mName; unsigned int mTmpReserveSize; ReadMode mReadMode; shared_ptr mReference; ArrayVariant mArray; }; #include "XdmfArray.tpp" #endif #ifdef __cplusplus extern "C" { #endif #define XDMF_ARRAY_READ_MODE_CONTROLLER 10 #define XDMF_ARRAY_READ_MODE_REFERENCE 11 // C wrappers go here struct XDMFARRAY; // Simply as a typedef to ensure correct typing typedef struct XDMFARRAY XDMFARRAY; XDMFCORE_EXPORT XDMFARRAY * XdmfArrayNew(); XDMFCORE_EXPORT void XdmfArrayClear(XDMFARRAY * array); XDMFCORE_EXPORT void XdmfArrayErase(XDMFARRAY * array, unsigned int index); XDMFCORE_EXPORT int XdmfArrayGetArrayType(XDMFARRAY * array, int * status); XDMFCORE_EXPORT unsigned int XdmfArrayGetCapacity(XDMFARRAY * array); XDMFCORE_EXPORT unsigned int * XdmfArrayGetDimensions(XDMFARRAY * array); XDMFCORE_EXPORT char * XdmfArrayGetDimensionsString(XDMFARRAY * array); XDMFCORE_EXPORT XDMFHEAVYDATACONTROLLER * XdmfArrayGetHeavyDataController(XDMFARRAY * array, unsigned int index); XDMFCORE_EXPORT int XdmfArrayGetReadMode(XDMFARRAY * array, int * status); XDMFCORE_EXPORT char * XdmfArrayGetName(XDMFARRAY * array); XDMFCORE_EXPORT unsigned int XdmfArrayGetNumberDimensions(XDMFARRAY * array); XDMFCORE_EXPORT unsigned int XdmfArrayGetNumberHeavyDataControllers(XDMFARRAY * array); XDMFCORE_EXPORT unsigned int XdmfArrayGetSize(XDMFARRAY * array); XDMFCORE_EXPORT XDMFARRAYREFERENCE * XdmfArrayGetReference(XDMFARRAY * array); XDMFCORE_EXPORT void * XdmfArrayGetValue(XDMFARRAY * array, unsigned int index, int arrayType, int * status); XDMFCORE_EXPORT void * XdmfArrayGetValues(XDMFARRAY * array, unsigned int startIndex, int arrayType, unsigned int numValues, unsigned int arrayStride, unsigned int valueStride, int * status); XDMFCORE_EXPORT void * XdmfArrayGetValuesInternal(XDMFARRAY * array); XDMFCORE_EXPORT char * XdmfArrayGetValuesString(XDMFARRAY * array); XDMFCORE_EXPORT void XdmfArrayInitialize(XDMFARRAY * array, int * dims, int numDims, int arrayType, int * status); XDMFCORE_EXPORT void XdmfArrayInsertDataFromPointer(XDMFARRAY * array, void * values, int arrayType, unsigned int startIndex, unsigned int numVals, unsigned int arrayStride, unsigned int valueStride, int * status); XDMFCORE_EXPORT void XdmfArrayInsertDataFromXdmfArray(XDMFARRAY * array, XDMFARRAY * valArray, int * arrayStarts, int * valueStarts, int * arrayCounts, int * valueCounts, int * arrayStrides, int * valueStrides, int * status); XDMFCORE_EXPORT void XdmfArrayInsertHeavyDataController(XDMFARRAY * array, XDMFHEAVYDATACONTROLLER * controller, int passControl); XDMFCORE_EXPORT void XdmfArrayInsertValue(XDMFARRAY * array, unsigned int index, void * value, int arrayType, int * status); XDMFCORE_EXPORT int XdmfArrayIsInitialized(XDMFARRAY * array); XDMFCORE_EXPORT void XdmfArrayPushBack(XDMFARRAY * array, void * value, int arrayType, int * status); XDMFCORE_EXPORT void XdmfArrayRead(XDMFARRAY * array, int * status); XDMFCORE_EXPORT void XdmfArrayReadController(XDMFARRAY * array, int * status); XDMFCORE_EXPORT void XdmfArrayReadReference(XDMFARRAY * array, int * status); XDMFCORE_EXPORT void XdmfArrayRelease(XDMFARRAY * array); XDMFCORE_EXPORT void XdmfArrayRemoveHeavyDataController(XDMFARRAY * array, unsigned int index); XDMFCORE_EXPORT void XdmfArrayReserve(XDMFARRAY * array, int size); XDMFCORE_EXPORT void XdmfArrayResize(XDMFARRAY * array, int * dims, int numDims, int arrayType, int * status); XDMFCORE_EXPORT void XdmfArraySetReadMode(XDMFARRAY * array, int readMode, int * status); XDMFCORE_EXPORT void XdmfArraySetReference(XDMFARRAY * array, XDMFARRAYREFERENCE * reference, int passControl); XDMFCORE_EXPORT void XdmfArraySetName(XDMFARRAY * array, char * name, int * status); XDMFCORE_EXPORT void XdmfArraySetValuesInternal(XDMFARRAY * array, void * pointer, unsigned int numValues, int arrayType, int transferOwnership, int * status); XDMFCORE_EXPORT void XdmfArraySwapWithXdmfArray(XDMFARRAY * array, XDMFARRAY * swapArray); XDMFCORE_EXPORT void XdmfArraySwapWithArray(XDMFARRAY * array, void ** pointer, int numValues, int arrayType, int * status); // C Wrappers for parent classes are generated by macros XDMF_ITEM_C_CHILD_DECLARE(XdmfArray, XDMFARRAY, XDMFCORE) #define XDMF_ARRAY_C_CHILD_DECLARE(ClassName, CClassName, Level) \ \ Level##_EXPORT void ClassName##Clear( CClassName * array); \ Level##_EXPORT void ClassName##Erase( CClassName * array, unsigned int index); \ Level##_EXPORT int ClassName##GetArrayType( CClassName * array, int * status); \ Level##_EXPORT unsigned int ClassName##GetCapacity( CClassName * array); \ Level##_EXPORT unsigned int * ClassName##GetDimensions( CClassName * array); \ Level##_EXPORT char * ClassName##GetDimensionsString( CClassName * array); \ Level##_EXPORT XDMFHEAVYDATACONTROLLER * ClassName##GetHeavyDataController( CClassName * array, unsigned int index); \ Level##_EXPORT int ClassName##GetReadMode( CClassName * array, int * status); \ Level##_EXPORT char * ClassName##GetName( CClassName * array); \ Level##_EXPORT unsigned int ClassName##GetNumberDimensions( CClassName * array); \ Level##_EXPORT unsigned int ClassName##GetNumberHeavyDataControllers( CClassName * array); \ Level##_EXPORT unsigned int ClassName##GetSize( CClassName * array); \ Level##_EXPORT XDMFARRAYREFERENCE * ClassName##GetReference( CClassName * array); \ Level##_EXPORT void * ClassName##GetValue( CClassName * array, \ unsigned int index, \ int arrayType, \ int * status); \ Level##_EXPORT void * ClassName##GetValues( CClassName * array, \ unsigned int startIndex, \ int arrayType, \ unsigned int numValues, \ unsigned int arrayStride, \ unsigned int valueStride, \ int * status); \ Level##_EXPORT void * ClassName##GetValuesInternal( CClassName * array); \ Level##_EXPORT char * ClassName##GetValuesString( CClassName * array); \ Level##_EXPORT void ClassName##Initialize( CClassName * array, \ int * dims, \ int numDims, \ int arrayType, \ int * status); \ Level##_EXPORT void ClassName##InsertDataFromPointer( CClassName * array, \ void * values, \ int arrayType, \ unsigned int startIndex, \ unsigned int numVals, \ unsigned int arrayStride, \ unsigned int valueStride, \ int * status); \ Level##_EXPORT void ClassName##InsertDataFromXdmfArray( CClassName * array, \ XDMFARRAY * valArray, \ int * arrayStarts, \ int * valueStarts, \ int * arrayCounts, \ int * valueCounts, \ int * arrayStrides, \ int * valueStrides, \ int * status); \ Level##_EXPORT void ClassName##InsertHeavyDataController( CClassName * array, \ XDMFHEAVYDATACONTROLLER * controller, \ int passControl); \ Level##_EXPORT void ClassName##InsertValue( CClassName * array, \ unsigned int index, \ void * value, \ int arrayType, \ int * status); \ Level##_EXPORT int ClassName##IsInitialized( CClassName * array); \ Level##_EXPORT void ClassName##PushBack( CClassName * array, \ void * value, \ int arrayType, \ int * status); \ Level##_EXPORT void ClassName##Read( CClassName * array, int * status); \ Level##_EXPORT void ClassName##ReadController( CClassName * array, int * status); \ Level##_EXPORT void ClassName##ReadReference( CClassName * array, int * status); \ Level##_EXPORT void ClassName##Release( CClassName * array); \ Level##_EXPORT void ClassName##RemoveHeavyDataController( CClassName * array, unsigned int index); \ Level##_EXPORT void ClassName##Reserve( CClassName * array, int size); \ Level##_EXPORT void ClassName##Resize( CClassName * array, \ int * dims, \ int numDims, \ int arrayType, \ int * status); \ Level##_EXPORT void ClassName##SetReadMode( CClassName * array, int readMode, int * status); \ Level##_EXPORT void ClassName##SetReference( CClassName * array, XDMFARRAYREFERENCE * reference, int passControl); \ Level##_EXPORT void ClassName##SetName( CClassName * array, char * name, int * status); \ Level##_EXPORT void ClassName##SetValuesInternal( CClassName * array, \ void * pointer, \ unsigned int numValues, \ int arrayType, \ int transferOwnership, \ int * status); \ Level##_EXPORT void ClassName##SwapWithXdmfArray( CClassName * array, XDMFARRAY * swapArray); \ Level##_EXPORT void ClassName##SwapWithArray( CClassName * array, \ void ** pointer, \ int numValues, \ int arrayType, \ int * status); #define XDMF_ARRAY_C_CHILD_WRAPPER(ClassName, CClassName) \ \ void ClassName##Clear( CClassName * array) \ { \ XdmfArrayClear((XDMFARRAY *)((void *)array)); \ } \ \ void ClassName##Erase( CClassName * array, unsigned int index) \ { \ XdmfArrayErase((XDMFARRAY *)((void *)array), index); \ } \ \ int ClassName##GetArrayType( CClassName * array, int * status) \ { \ return XdmfArrayGetArrayType((XDMFARRAY *)((void *)array), status); \ } \ \ unsigned int ClassName##GetCapacity( CClassName * array) \ { \ return XdmfArrayGetCapacity((XDMFARRAY *)((void *)array)); \ } \ \ unsigned int * \ ClassName##GetDimensions( CClassName * array) \ { \ return XdmfArrayGetDimensions((XDMFARRAY *)((void *)array)); \ } \ \ char * \ ClassName##GetDimensionsString( CClassName * array) \ { \ return XdmfArrayGetDimensionsString((XDMFARRAY *)((void *)array)); \ } \ \ XDMFHEAVYDATACONTROLLER * \ ClassName##GetHeavyDataController( CClassName * array, unsigned int index) \ { \ return XdmfArrayGetHeavyDataController((XDMFARRAY *)((void *)array), index); \ } \ \ char * \ ClassName##GetName( CClassName * array) \ { \ return XdmfArrayGetName((XDMFARRAY *)((void *)array)); \ } \ \ unsigned int \ ClassName##GetNumberDimensions( CClassName * array) \ { \ return XdmfArrayGetNumberDimensions((XDMFARRAY *)((void *)array)); \ } \ \ unsigned int \ ClassName##GetNumberHeavyDataControllers( CClassName * array) \ { \ return XdmfArrayGetNumberHeavyDataControllers((XDMFARRAY *)((void *)array)); \ } \ \ unsigned int \ ClassName##GetSize( CClassName * array) \ { \ return XdmfArrayGetSize((XDMFARRAY *)((void *)array)); \ } \ \ int \ ClassName##GetReadMode( CClassName * array, int * status) \ { \ return XdmfArrayGetReadMode((XDMFARRAY *)((void *)array), status); \ } \ \ XDMFARRAYREFERENCE * \ ClassName##GetReference( CClassName * array) \ { \ return XdmfArrayGetReference((XDMFARRAY *)((void *)array)); \ } \ \ void * \ ClassName##GetValue( CClassName * array, unsigned int index, int arrayType, int * status) \ { \ return XdmfArrayGetValue((XDMFARRAY *)((void *)array), index, arrayType, status); \ } \ \ void * \ ClassName##GetValues( CClassName * array, \ unsigned int startIndex, \ int arrayType, \ unsigned int numValues, \ unsigned int arrayStride, \ unsigned int valueStride, \ int * status) \ { \ return XdmfArrayGetValues((XDMFARRAY *)((void *)array), \ startIndex, \ arrayType, \ numValues, \ arrayStride, \ valueStride, \ status); \ } \ \ void * \ ClassName##GetValuesInternal( CClassName * array) \ { \ return XdmfArrayGetValuesInternal((XDMFARRAY *)((void *)array)); \ } \ \ char * \ ClassName##GetValuesString( CClassName * array) \ { \ return XdmfArrayGetValuesString((XDMFARRAY *)((void *)array)); \ } \ \ void \ ClassName##Initialize( CClassName * array, int * dims, int numDims, int arrayType, int * status) \ { \ XdmfArrayInitialize((XDMFARRAY *)((void *)array), dims, numDims, arrayType, status); \ } \ \ void \ ClassName##InsertDataFromPointer( CClassName * array, \ void * values, \ int arrayType, \ unsigned int startIndex, \ unsigned int numVals, \ unsigned int arrayStride, \ unsigned int valueStride, \ int * status) \ { \ XdmfArrayInsertDataFromPointer((XDMFARRAY *)((void *)array), \ values, \ arrayType, \ startIndex, \ numVals, \ arrayStride, \ valueStride, \ status); \ } \ \ void ClassName##InsertDataFromXdmfArray( CClassName * array, \ XDMFARRAY * valArray, \ int * arrayStarts, \ int * valueStarts, \ int * arrayCounts, \ int * valueCounts, \ int * arrayStrides, \ int * valueStrides, \ int * status) \ { \ XdmfArrayInsertDataFromXdmfArray((XDMFARRAY *)((void *)array), \ valArray, \ arrayStarts, \ valueStarts, \ arrayCounts, \ valueCounts, \ arrayStrides, \ valueStrides, \ status); \ } \ \ void \ ClassName##InsertHeavyDataController( CClassName * array, XDMFHEAVYDATACONTROLLER * controller, int passControl) \ { \ XdmfArrayInsertHeavyDataController((XDMFARRAY *)((void *)array), controller, passControl); \ } \ \ void \ ClassName##InsertValue( CClassName * array, \ unsigned int index, \ void * value, \ int arrayType, \ int * status) \ { \ XdmfArrayInsertValue((XDMFARRAY *)((void *)array), index, value, arrayType, status); \ } \ \ int \ ClassName##IsInitialized( CClassName * array) \ { \ return XdmfArrayIsInitialized((XDMFARRAY *)((void *)array)); \ } \ \ void \ ClassName##PushBack( CClassName * array, void * value, int arrayType, int * status) \ { \ XdmfArrayPushBack((XDMFARRAY *)((void *)array), value, arrayType, status); \ } \ \ void \ ClassName##Read( CClassName * array, int * status) \ { \ XdmfArrayRead((XDMFARRAY *)((void *)array), status); \ } \ \ void \ ClassName##ReadController( CClassName * array, int * status) \ { \ XdmfArrayReadController((XDMFARRAY *)((void *)array), status); \ } \ \ void \ ClassName##ReadReference( CClassName * array, int * status) \ { \ XdmfArrayReadReference((XDMFARRAY *)((void *)array), status); \ } \ \ void \ ClassName##Release( CClassName * array) \ { \ XdmfArrayRelease((XDMFARRAY *)((void *)array)); \ } \ \ void \ ClassName##RemoveHeavyDataController( CClassName * array, unsigned int index) \ { \ XdmfArrayRemoveHeavyDataController((XDMFARRAY *)((void *)array), index); \ } \ \ void \ ClassName##Reserve( CClassName * array, int size) \ { \ XdmfArrayReserve((XDMFARRAY *)((void *)array), size); \ } \ \ void \ ClassName##Resize( CClassName * array, int * dims, int numDims, int arrayType, int * status) \ { \ XdmfArrayResize((XDMFARRAY *)((void *)array), dims, numDims, arrayType, status); \ } \ \ void \ ClassName##SetReadMode( CClassName * array, int readMode, int * status) \ { \ XdmfArraySetReadMode((XDMFARRAY *)((void *)array), readMode, status); \ } \ \ void \ ClassName##SetReference( CClassName * array, XDMFARRAYREFERENCE * reference, int passControl) \ { \ XdmfArraySetReference((XDMFARRAY *)((void *)array), reference, passControl); \ } \ \ void \ ClassName##SetName( CClassName * array, char * name, int * status) \ { \ XdmfArraySetName((XDMFARRAY *)((void *)array), name, status); \ } \ \ void \ ClassName##SetValuesInternal( CClassName * array, \ void * pointer, \ unsigned int numValues, \ int arrayType, \ int transferOwnership, \ int * status) \ { \ XdmfArraySetValuesInternal((XDMFARRAY *)((void *)array), \ pointer, \ numValues, \ arrayType, \ transferOwnership, \ status); \ } \ \ void \ ClassName##SwapWithXdmfArray( CClassName * array, XDMFARRAY * swapArray) \ { \ XdmfArraySwapWithXdmfArray((XDMFARRAY *)((void *)array), swapArray); \ } \ \ void \ ClassName##SwapWithArray( CClassName * array, \ void ** pointer, \ int numValues, \ int arrayType, \ int * status) \ { \ XdmfArraySwapWithArray((XDMFARRAY *)((void *)array), pointer, numValues, arrayType, status); \ } #ifdef __cplusplus } #endif #endif /* XDMFARRAY_HPP_ */