NcChar.h

Go to the documentation of this file.

#ifndef INC_netcdf_NcChar_h
#define INC_netcdf_NcChar_h

#include "NcType.h"

namespace netcdf {

  class NcChar : public NcType
  {
    public:
        typedef char                    value_type;
        typedef std::vector<value_type> vector_type;

        NcChar();

        static value_type FillValue ()  { return fillValue; }
        static value_type MinValue ()   { return minValue; }
        static value_type MaxValue ()   { return maxValue; }
        static std::size_t SizeOf ()    { return sizeof(value_type); }

        void Get (                              
          int const groupID,                    
          int const varID,                      
          char** & data);                       

        void Get (                              
          int const groupID,                    
          int const varID,                      
          std::vector<std::string> & data);     

        void Get (                              
          int const groupID,                    
          int const varID,                      
          vector_type & data);                  

//      void Get (                              ///< read a single value at indices
//        int const groupID,                    ///< group ID
//        int const varID,                      ///< variable ID
//        TVecIndex const & indices,            ///< indices at which to read
//        value_type & data);                   ///< receives value

        void Get (                              
          int const groupID,                    
          int const varID,                      
          TVecIndex const & indices,            
          std::string & data);                  

        void Get (                              
          int const groupID,                    
          int const varID,                      
          std::size_t const start,              
          std::size_t const count,              
          char** & data);                       

        void Get (                              
          int const groupID,                    
          int const varID,                      
          std::size_t const start,              
          std::size_t const count,              
          std::vector<std::string> & data);     

        void Get (                              
          int const groupID,                    
          int const varID,                      
          TVecIndex const & start,              
          TVecIndex const & count,              
          vector_type & data);                  

//      void Get (                              ///< read a subsampled (strided) section
//        int const groupID,                    ///< group ID
//        int const varID,                      ///< variable ID
//        TVecIndex const & start,              ///< zero-based index to start reading
//        TVecIndex const & count,              ///< count along each dimension (>= 1)
//        TVecStride const & stride,            ///< interval along each dimension
//        vector_type & data);                  ///< vector to receive data values

//      void Get (                              ///< read a mapped array section
//        int const groupID,                    ///< group ID
//        int const varID,                      ///< variable ID
//        TVecIndex const & start,              ///< zero-based index to start reading
//        TVecIndex const & count,              ///< count along each dimension (>= 1)
//        TVecStride const & stride,            ///< interval along each dimension
//        TVecStride const & imap,              ///< mapping intervals for each dimension (see NetCDF doc)
//        vector_type & data);                  ///< vector to receive data values

        void Put (                              
          int const groupID,                    
          int const varID,                      
          vector_type const & data);            

//      void Put (                              ///< write an array of values
//        int const groupID,                    ///< group ID
//        int const varID,                      ///< variable ID
//        TVecIndex const & indices,            ///< indices at which to write
//        value_type const & data);             ///< value to write

        void Put (                              
          int const groupID,                    
          int const varID,                      
          TVecIndex const & start,              
          TVecIndex const & count,              
          vector_type const & data);            

//      void Put (                              ///< write a subsampled (strided) section
//        int const groupID,                    ///< group ID
//        int const varID,                      ///< variable ID
//        TVecIndex const & start,              ///< zero-based index to start write
//        TVecIndex const & count,              ///< count along each dimension (>= 1)
//        TVecStride const & stride,            ///< interval along each dimension
//        vector_type const & data);            ///< vector of values to write

//      void Put (                              ///< write a mapped array section
//        int const groupID,                    ///< group ID
//        int const varID,                      ///< variable ID
//        TVecIndex const & start,              ///< zero-based index to start reading
//        TVecIndex const & count,              ///< count along each dimension (>= 1)
//        TVecStride const & stride,            ///< interval along each dimension
//        TVecStride const & imap,              ///< mapping intervals for each dimension (see NetCDF doc)
//        vector_type const & data);            ///< vector of values to write
    private:

        static char const * const myTypeName;
        static value_type const fillValue = NC_FILL_CHAR;
        static value_type const minValue = 0;
        static value_type const maxValue = NC_MAX_BYTE;

  };

  extern NcChar ncChar;

} // namespace netcdf
#endif