Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features.

BUG:215923


git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdeadmin@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da

1 files changed, 156 insertions, 0 deletions

diff --git a/kdat/Tape.h b/kdat/Tape.h
new file mode 100644
index 0000000..eab7cb3
--- /dev/null
+++ b/kdat/Tape.h
@@ -0,0 +1,156 @@
+// KDat - a tar-based DAT archiver
+// Copyright (C) 1998-2000  Sean Vyain, svyain@mail.tds.net
+// Copyright (C) 2001-2002  Lawrence Widman, kdat@cardiothink.com
+//
+// This program is free software; you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation; either version 2 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with this program; if not, write to the Free Software
+// Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
+
+#ifndef _Tape_h_
+#define _Tape_h_
+
+#include <qptrlist.h>
+#include <qstring.h>
+
+#include "Archive.h"
+
+/**
+ * @short This class represents a single tape index.
+ */
+class Tape {
+    bool           _stubbed;
+    QCString       _id;
+    int            _ctime;
+    int            _mtime;
+    QString        _name;
+    int            _size;
+    QPtrList<Archive> _children;
+
+    FILE* _fptr;
+
+    void readVersion1Index( FILE* fptr );
+    void readVersion2Index( FILE* fptr );
+    void readVersion3Index( FILE* fptr );
+    void readVersion4Index( FILE* fptr );
+
+    void calcRanges();
+
+    void read();
+    void readAll( int version );
+    void write();
+public:
+    /**
+     * Create a new tape index, and automatically generate a unique tape ID.
+     */
+    Tape();
+
+    /**
+     * Create a new tape index for the given tape index ID.
+     *
+     * @param id The unique tape index identifier.
+     */
+    Tape( const char * id );
+
+    /**
+     * Destroy the tape index.
+     */
+    ~Tape();
+
+    /**
+     * Writes a KDat header containing the tape ID, at the beginning of the
+     * tape.  All data on the tape will be lost.
+     */
+    void format();
+
+    /**
+     * Get the unique ID for the tape.
+     *
+     * @return The tape id.
+     */
+    QString getID();
+
+    /**
+     * Get the user-specified name for the tape.
+     *
+     * @return The name of the tape.
+     */
+    QString getName();
+
+    /**
+     * Get the date and time that the tape was formatted.
+     *
+     * @return The tape format time, in seconds since the Epoch.
+     */
+    int getCTime();
+    
+    /**
+     * Get the last time that the tape was modified.
+     *
+     * @return The tape modification time, in seconds since the Epoch.
+     */
+    int getMTime();
+
+    /**
+     * Get the total tape capacity.
+     *
+     * @return The tape capacity in kilobytes.
+     */
+    int getSize();
+
+    /**
+     * Get the list of archives on this tape.
+     *
+     * @return The list of all archives on the tape.
+     */
+    const QPtrList<Archive>& getChildren();
+
+    /**
+     * Set the name for the tape.
+     *
+     * @param name The new name for the tape.
+     */
+    void setName( const QString & name );
+
+    /**
+     * Set the modification time for the tape to be the current time..
+     */
+    void setMTime( int mtime );
+
+    /**
+     * Set the total capacity of the tape.
+     *
+     * @param size The total size, in kilobytes, of the tape.
+     */
+    void setSize( int size );
+
+    /**
+     * Add an archive to the tape index.
+     *
+     * @param archive The archive to add.
+     */
+    void addChild( Archive* archive );
+
+    /**
+     * Remove an archive and all the archives that follow it from the index.
+     *
+     * @param archive The archive to remove.
+     */
+    void removeChild( Archive* archive );
+
+    /**
+     * Recursively destroy all children of the tape index.
+     */
+    void clear();
+};
+
+#endif