Updating text, names and comments to be consistent and generally make a bit more...
[barry.git] / src / r_memo.h
blob9a7411ba082731d5f1b25acb1bfbe874a2eaeec7
1 ///
2 /// \file r_memo.h
3 /// Record parsing class for the memo database.
4 ///
6 /*
7 Copyright (C) 2005-2010, Net Direct Inc. (http://www.netdirect.ca/)
8 Copyright (C) 2007, Brian Edginton
10 This program is free software; you can redistribute it and/or modify
11 it under the terms of the GNU General Public License as published by
12 the Free Software Foundation; either version 2 of the License, or
13 (at your option) any later version.
15 This program is distributed in the hope that it will be useful,
16 but WITHOUT ANY WARRANTY; without even the implied warranty of
17 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
19 See the GNU General Public License in the COPYING file at the
20 root directory of this project for more details.
23 #ifndef __BARRY_RECORD_MEMO_H__
24 #define __BARRY_RECORD_MEMO_H__
26 #include "dll.h"
27 #include "record.h"
28 #include <vector>
29 #include <string>
30 #include <stdint.h>
32 namespace Barry {
34 // forward declarations
35 class IConverter;
37 class BXEXPORT Memo
39 public:
40 typedef std::vector<UnknownField> UnknownsType;
42 uint8_t RecType;
43 uint32_t RecordId;
45 std::string Title;
46 std::string Body;
47 CategoryList Categories;
49 UnknownsType Unknowns;
51 public:
52 const unsigned char* ParseField(const unsigned char *begin,
53 const unsigned char *end, const IConverter *ic = 0);
55 public:
56 Memo();
57 ~Memo();
59 // Parser / Builder API (see parser.h / builder.h)
60 uint8_t GetRecType() const { return RecType; }
61 uint32_t GetUniqueId() const { return RecordId; }
62 void SetIds(uint8_t Type, uint32_t Id) { RecType = Type; RecordId = Id; }
63 void ParseHeader(const Data &data, size_t &offset);
64 void ParseFields(const Data &data, size_t &offset, const IConverter *ic = 0);
65 void BuildHeader(Data &data, size_t &offset) const;
66 void BuildFields(Data &data, size_t &offset, const IConverter *ic = 0) const;
68 void Clear();
70 void Dump(std::ostream &os) const;
72 bool operator<(const Memo &other) const;
74 // database name
75 static const char * GetDBName() { return "Memos"; }
76 static uint8_t GetDefaultRecType() { return 0; } // or 0?
79 BXEXPORT inline std::ostream& operator<<(std::ostream &os, const Memo &msg) {
80 msg.Dump(os);
81 return os;
84 } // namespace Barry
86 #endif