/************************************************************
 * The Data Acquisition Backbone Core (DABC)                *
 ************************************************************
 * Copyright (C) 2009 -                                     *
 * GSI Helmholtzzentrum fuer Schwerionenforschung GmbH      *
 * Planckstr. 1, 64291 Darmstadt, Germany                   *
 * Contact:  http://dabc.gsi.de                             *
 ************************************************************
 * This software can be used under the GPL license          *
 * agreements as stated in LICENSE.txt file                 *
 * which is part of the distribution.                       *
 ************************************************************/

#ifndef HADAQ_HldFile
#define HADAQ_HldFile

#ifndef DABC_BinaryFile
#include "dabc/BinaryFile.h"
#endif

#ifndef HADAQ_defines
#include "hadaq/definess.h"
#endif

namespace hadaq {

   /** Reading of HLD files */

   class HldFile : public dabc::BasicFile {
      protected:
         uint32_t       fRunNumber;   ///<! run number
         bool           fEOF;         ///<! flag indicate that end-of-file was reached

      public:
         HldFile();
         ~HldFile();

         /** Open file with specified name for writing */
         bool OpenWrite(const char* fname, uint32_t rid=0);

         /** Opened file for reading. Internal buffer required
           * when data read partially and must be kept there. */
         bool OpenRead(const char* fname);

         /** Close file */
         void Close();

         /** Returns runid, assigned with the file */
         uint32_t GetRunId() const { return fRunNumber; }

         /** When file open for reading, method returns true when file end was achieved */
         bool eof() const { return fEOF; }

         /** Read one or several elements to provided user buffer
           * When called, bufsize should has available buffer size,
           * after call contains actual size read.
           * If /param onlyevent=true, the only hadaq element will be read.
           * Returns true if any data were successfully read. */
         bool ReadBuffer(void* ptr, uint32_t* bufsize, bool onlyevent = false);

         /** Write user buffer to file without reformatting
          * User must be aware about correct formatting of data.
          * Returns true if data was written.*/
         bool WriteBuffer(void* buf, uint32_t bufsize);

   };

} // end of namespace

#endif