garray.h

Gambit 是一个游戏库理论软件

//
// $Source: /home/gambit/CVS/gambit/sources/base/garray.h,v $
// $Date: 2002/08/26 05:49:56 $
// $Revision: 1.3 $
//
// DESCRIPTION:
// A basic bounds-checked array type
//
// This file is part of Gambit
// Copyright (c) 2002, The Gambit Project
//
// 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., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
//

#ifndef GARRAY_H
#define GARRAY_H

#include <stdlib.h>
#include <assert.h>
#include "gstream.h"

template <class T> class gArray  {
  protected:
    int mindex, maxdex;
    T *data;

  public:
    class BadIndex : public gException  {
    public:
      virtual ~BadIndex();
      gText Description(void) const;
    };

    class BadRange : public gException  {
    public:
      virtual ~BadRange();
      gText Description(void) const;
    };

//
// Constructs a gArray of length 'len', starting at '1'
//
    gArray(unsigned int len = 0);
//
// Constructs a gArray starting at lo and ending at hi
//
    gArray(int lo, int hi);
//
// duplicate the input gArray<T> constant referrence
//
    gArray(const gArray<T> &);
//
// Destruct and deallocates gArray
//
    virtual ~gArray();
//
// Copies data from input gArray
//
    gArray<T> &operator=(const gArray<T> &);

//
// return length in the invoking gArray<T>
//
    int Length(void) const;

//
// return first index
//
    int First(void) const;

//
// return last index
//
    int Last(void) const;

//
// Check bounds of index. Exit program if out of bounds
//
    const T &operator[](int index) const;
    T &operator[](int index);
//
// Output data of the array
//
    virtual void Dump(gOutput &) const;
};
template <class T> bool operator==(const gArray<T> &, const gArray<T> &);
template <class T> bool operator!=(const gArray<T> &, const gArray<T> &);

template <class T> gOutput &operator<<(gOutput &, const gArray<T> &);


#endif	//# GARRAY_H