Qt Toolkit - qgarray.h include file

# qgarray.h

This is the verbatim text of the qgarray.h include file. It is is provided only for illustration; the copyright remains with Troll Tech.

    /****************************************************************************
    ** $Id: qgarray.h,v 2.4.2.1 1998/08/19 16:02:36 agulbra Exp $
    **
    ** Definition of QGArray class
    **
    ** Created : 930906
    **
    ** Copyright (C) 1992-1999 Troll Tech AS.  All rights reserved.
    **
    ** This file is part of Qt Free Edition, version 1.45.
    **
    ** See the file LICENSE included in the distribution for the usage
    ** and distribution terms, or http://www.troll.no/free-license.html.
    **
    ** IMPORTANT NOTE: You may NOT copy this file or any part of it into
    ** your own programs or libraries.
    **
    ** Please see http://www.troll.no/pricing.html for information about
    ** Qt Professional Edition, which is this same library but with a
    ** license which allows creation of commercial/proprietary software.
    **
    *****************************************************************************/

    #ifndef QGARRAY_H
    #define QGARRAY_H

    #ifndef QT_H
    #include "qshared.h"
    #endif // QT_H

    class Q_EXPORT QGArray                                  // generic array
    {
    friend class QBuffer;
    public:
        struct array_data : public QShared {        // shared array
            array_data()    { data=0; len=0; }
            char *data;                             // actual array data
            uint  len;
        };
        QGArray();
    protected:
        QGArray( int, int );                        // dummy; does not alloc
        QGArray( int size );                        // allocate 'size' bytes
        QGArray( const QGArray &a );                // shallow copy
        virtual ~QGArray();

        QGArray    &operator=( const QGArray &a ) { return assign( a ); }

        virtual void detach()       { duplicate(*this); }

        char       *data()   const  { return shd->data; }
        uint        nrefs()  const  { return shd->count; }
        uint        size()   const  { return shd->len; }
        bool        isEqual( const QGArray &a ) const;

        bool        resize( uint newsize );

        bool        fill( const char *d, int len, uint sz );

        QGArray    &assign( const QGArray &a );
        QGArray    &assign( const char *d, uint len );
        QGArray    &duplicate( const QGArray &a );
        QGArray    &duplicate( const char *d, uint len );
        void        store( const char *d, uint len );

        array_data *sharedBlock()   const           { return shd; }
        void        setSharedBlock( array_data *p ) { shd=(array_data*)p; }

        QGArray    &setRawData( const char *d, uint len );
        void        resetRawData( const char *d, uint len );

        int         find( const char *d, uint index, uint sz ) const;
        int         contains( const char *d, uint sz ) const;

        char       *at( uint index ) const;

        bool        setExpand( uint index, const char *d, uint sz );

    protected:
        virtual array_data *newData()                   { return new array_data; }
        virtual void        deleteData( array_data *p ) { delete p; }

    private:
        static void msg_index( uint );
        array_data *shd;
    };

    inline char *QGArray::at( uint index ) const
    {
    #if defined(CHECK_RANGE)
        if ( index >= size() ) {
            msg_index( index );
            index = 0;
        }
    #endif
        return &shd->data[index];
    }

    #endif // QGARRAY_H