binary.hpp

Go to the documentation of this file.

// 
// BEGIN_DOUGLAS_MARK_ROYER_COPYRIGHT
//
// Copyright (C) 1993-2012 Douglas Mark Royer, All Rights Reserved.
// 
// NOTICE:
// 
// THIS SOURCE CODE BELONGS TO DOUGLAS MARK ROYER
// THIS CODE IS CONSIDERED A
// TRADE SECRET AND IS NOT TO BE DIVULGED OR USED BY PARTIES WHO HAVE
// NOT RECEIVED WRITTEN AUTHORIZATION FROM THE OWNER.
// 
// 
// THIS SOFTWARE AND MANUAL ARE BOTH PROTECTED BY UNITED STATES
// COPYRIGHT LAW (TITLE 17 UNITED STATES CODE). UNAUTHORIZED REPRODUCTION
// AND/OR SALE MAY RESULT IN IMPRISONMENT OF UP TO ONE YEAR AND FINES
// OF UP TO $100,000 (17 USC 506). COPYRIGHT INFRINGERS MAY ALSO
// BE SUBJECT TO CIVIL LIABILITY.
// 
// THIS NOTICE AND THE ABOVE COPYRIGHT NOTICE MUST REMAIN IN ALL
// COPIES AND ANY DERIVED WORK.
// 
// ALL OF THIS CODE IS ORIGINAL WORK BY THE COPYRIGHT HOLDER.
// 
// THIS  DOCUMENT  AND  THE  INFORMATION  CONTAINED  HEREIN  IS
// PROVIDED  ON  AN "AS IS" BASIS AND INET-CONSULTING.COM, INC.
// DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED,  INCLUDING  BUT
// NOT  LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION
// HEREIN  WILL  NOT  INFRINGE  ANY  RIGHTS  OR   ANY   IMPLIED
// WARRANTIES  OF  MERCHANTABILITY  OR FITNESS FOR A PARTICULAR
// PURPOSE.  ANY SERVICE CONTRACT  WILL  BE  UNDER  A  SEPARATE
// LICENSE.
//
// END_DOUGLAS_MARK_ROYER_COPYRIGHT
//

#ifndef __DOUGLAS_MARK_ROYER_LIBRARY_ICALENDAR_BINARY_HPP__
#define __DOUGLAS_MARK_ROYER_LIBRARY_ICALENDAR_BINARY_HPP__

#ifndef EXPORT_ICALENDAR
#ifdef BUILDING_LIBRARY_ICALENDAR
#define EXPORT_ICALENDAR EXPORT_OUT
#else
#define EXPORT_ICALENDAR EXPORT_IN
#endif
#endif

#ifdef BUILDING_LIBRARY_ICALENDAR
#include "iCalendar.hpp"
#include "BaseValueType.hpp"
#else
#include <SaS/iCalendar/iCalendar.hpp>
#include <SaS/iCalendar/BaseValueType.hpp>
#endif

using namespace std;
using namespace SoftwareAndServices::Library::Common;
using namespace SoftwareAndServices::Library::RfcBasic;
using namespace SoftwareAndServices::Library::iCalendar;

namespace SoftwareAndServices
{
    namespace Library 
    {
        namespace iCalendar
        {
            /*
             * @class binary
             * This object holds RFC-iCalendar BINARY data.
             */
            class EXPORT_ICALENDAR binary
                : public BaseValueType 
            {

            public:

                enum BinaryEncodingType {
                    UnknownEncoding_t       = UnknownToken_t,
                    Base64Encoding_t        = BASE64,
                    EightBitEncoding_t      = EIGHT_BIT
                };

                binary(unsigned char * data = NULL, const size_t octetCount = 0);

                virtual ~binary();

                bool            encode(BinaryEncodingType desiredType);

                bool            decode(const char * buffer, BinaryEncodingType encoding = Base64Encoding_t);

                void        *   get(size_t * size) const;

                virtual bool    sprint(String * Results) const;

                bool                parse(Parse & in, BinaryEncodingType encoding, component * errors);

                bool                operator==(const binary & Other);

                bool                operator==(const binary * Other);

                bool                operator!=(const binary & Other);

                bool                operator!=(const binary * Other);

            protected:

                BinaryEncodingType          _encoding;

                unsigned char           *   _blob;

                size_t                      _size;
            };

            typedef vector<binary*> binaryVec;

        }
    }
}

#endif /*__DOUGLAS_MARK_ROYER_LIBRARY_ICALENDAR_BINARY_HPP__*/