cmnDataFunctionsVector.h

Go to the documentation of this file.

/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*-    */
/* ex: set filetype=cpp softtabstop=4 shiftwidth=4 tabstop=4 cindent expandtab: */

/*

  Author(s):  Anton Deguet
  Created on: 2011-06-27

  (C) Copyright 2011-2013 Johns Hopkins University (JHU), All Rights
  Reserved.

--- begin cisst license - do not edit ---

This software is provided "as is" under an open source license, with
no warranty.  The complete license can be found in license.txt and
http://www.cisst.org/cisst/license.txt.

--- end cisst license ---

*/


#pragma once
#ifndef _cmnDataFunctionsVector_h
#define _cmnDataFunctionsVector_h

#include <cisstCommon/cmnDataFunctions.h>
#include <vector>
#include <cisstCommon/cmnDataFunctionsVectorHelpers.h>

// always include last
#include <cisstCommon/cmnExport.h>

template <class _elementType>
class cmnData<std::vector<_elementType> >
{
public:
    enum {IS_SPECIALIZED = 1};

    typedef std::vector<_elementType> DataType;

    static void Copy(DataType & data, const DataType & source)
    {
        cmnDataVectorCopy(data, source);
    }

    static std::string HumanReadable(const DataType & data)
    {
        return cmnDataVectorHumanReadable(data);
    }

    static void SerializeText(const DataType & data,
                          std::ostream & outputStream,
                          const char delimiter) throw (std::runtime_error)
    {
        const size_t size = data.size();
        cmnData<size_t>::SerializeText(size, outputStream, delimiter);
        if (size > 0) {
            outputStream << delimiter;
            cmnDataVectorSerializeText(data, outputStream, delimiter);
        }
    }

    static void DeSerializeText(DataType & data,
                                std::istream & inputStream,
                                const char delimiter) throw (std::runtime_error)
    {
        cmnDataVectorDeSerializeTextResize(data, inputStream, delimiter);
    }

    static std::string SerializeDescription(const DataType & data,
                                            const char delimiter,
                                            const std::string & userDescription = "v")
    {
        return cmnDataVectorSerializeDescription(data, delimiter, userDescription, true /* need to serialize size */);
    }

    static void SerializeBinary(const DataType & data, std::ostream & outputStream)
        throw (std::runtime_error)
    {
        cmnData<size_t>::SerializeBinary(data.size(), outputStream);
        cmnDataVectorSerializeBinary(data, outputStream);
    }

    static void DeSerializeBinary(DataType & data,
                                  std::istream & inputStream,
                                  const cmnDataFormat & localFormat,
                                  const cmnDataFormat & remoteFormat)
        throw (std::runtime_error)
    {
        cmnDataVectorDeSerializeBinaryResize(data, inputStream, localFormat, remoteFormat);
    }

    static bool ScalarNumberIsFixed(const DataType & CMN_UNUSED(data))
    {
        return false;
    }

    static size_t ScalarNumber(const DataType & data)
    {
        return cmnDataVectorScalarNumber(data) + 1; /* treat vector size as a scalar */
    }

    static std::string ScalarDescription(const DataType & data, const size_t index,
                                         const std::string & userDescription = "v")
        throw (std::out_of_range)
    {
        /* treat vector size as a scalar */
        if (index == 0) {
            return cmnData<size_t>::ScalarDescription(data.size(), 0, userDescription + ".size");
        }
        return cmnDataVectorScalarDescription(data, index - 1, userDescription);
    }

    static double Scalar(const DataType & data, const size_t index)
        throw (std::out_of_range)
    {
        /* treat vector size as a scalar */
        if (index == 0) {
            return static_cast<double>(data.size());
        }
        return cmnDataVectorScalar(data, index - 1);
    }
};

#endif // _cmnDataFunctionsVector_h