summaryrefslogtreecommitdiff
path: root/src/stable/archival.h
blob: 78faffb769f5997f15cfa9f49eb4bbd3afeac18b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
/*
 * Copyright (C) 2007-2012 Xagasoft, All rights reserved.
 *
 * This file is part of the libbu++ library and is released under the
 * terms of the license contained in the file LICENSE.
 */

#ifndef BU_ARCHIVAL_H
#define BU_ARCHIVAL_H

#include "bu/archivebase.h"

namespace Bu
{
    /**
     * The base class for any class you want to archive.  Simply include this as
     * a base class, implement the purely virtual archive function and you've
     * got an easily archiveable class.
     *
     * Archival: "of or pertaining to archives or valuable records; contained
	 * in or comprising such archives or records."
     */
    class Archival
    {
    public:
        /**
         * Does nothing, here for completeness.
         */
        Archival();

        /**
         * Here to ensure the deconstructor is virtual.
         */
        virtual ~Archival();

        /**
         * This is the main workhorse of the archive system, just override and
         * you've got a archiveable class.  A reference to the Archive
         * used is passed in as your only parameter, query it to discover if
         * you are loading or saving.
         * @param ar A reference to the Archive object to use.
         */
        virtual void archive( class ArchiveBase &ar )=0;
    };

    ArchiveBase &operator<<(ArchiveBase &, const class Bu::Archival &);
    ArchiveBase &operator<<(ArchiveBase &, class Bu::Archival &);
    ArchiveBase &operator>>(ArchiveBase &, class Bu::Archival &);

}

#endif