//=============================================================================
//! (DO NOT USE) Smart-temporary Real Double-precision General Sparse Matrix Class
class _dgsmatrix
{
public:
  //// objects ////
  mutable long M; //!< matrix row size
  mutable long N; //!< matrix column size
  mutable long CAP; //!< the length of data arrays
  mutable long VOL; //!< the number of non-zero components
  mutable double* Array; //!< 1D array to store non-zero matrix data
  mutable long* Indx; //!< 1D array to store the i-index of non-zero matrix components
  mutable long* Jndx; //!< 1D array to store the j-index of non-zero matrix components
  mutable std::vector< std::pair<long,long> >* Rows; //!< array of vector to store the entry information of component for each row
  mutable std::vector< std::pair<long,long> >* Cols; //!< array of vector to store the entry information of component for each column
  
  //// constructor ////
  inline _dgsmatrix();
  inline _dgsmatrix(const _dgsmatrix&);
  inline ~_dgsmatrix(); //destructor
  
  //// cast ////
  inline _zgsmatrix to_zgsmatrix() const;
  inline _dgematrix to_dgematrix() const;
  
  //// io ////
  inline double operator()(const long&, const long&) const;//not return double&
  inline friend std::ostream& operator<<(std::ostream&, const _dgsmatrix&);
  inline void write(const char *) const;
  //// misc ////
  inline void nullify() const;
  inline void destroy() const;
  
  //// calc ////
  inline friend _dgsmatrix t(const dgsmatrix&);
  inline friend void idamax(long&, long&, const dgsmatrix&);
  inline friend double damax(const dgsmatrix&);
  
  //// unary ////
  inline friend const _dgsmatrix& operator+(const _dgsmatrix&);
  inline friend _dgsmatrix operator-(const _dgsmatrix&);
  
  //// + ////
  inline friend _dgsmatrix operator+(const  dgsmatrix&, const  dgsmatrix&);
  inline friend _dgsmatrix operator+(const  dgsmatrix&, const _dgsmatrix&);
  inline friend _dgsmatrix operator+(const _dgsmatrix&, const  dgsmatrix&);
  inline friend _dgsmatrix operator+(const _dgsmatrix&, const _dgsmatrix&);
  
  inline friend _dgematrix operator+(const _dgsmatrix&, const  dgematrix&);
  inline friend _dgematrix operator+(const _dgsmatrix&, const _dgematrix&);
  inline friend _dgematrix operator+(const _dgematrix&, const _dgsmatrix&);
  inline friend _dgematrix operator+(const  dgematrix&, const _dgsmatrix&);
  
  inline friend _dgematrix operator+(const _dgsmatrix&, const  dgbmatrix&);
  inline friend _dgematrix operator+(const _dgsmatrix&, const _dgbmatrix&);
  inline friend _dgematrix operator+(const _dgbmatrix&, const _dgsmatrix&);
  inline friend _dgematrix operator+(const  dgbmatrix&, const _dgsmatrix&);
  
  inline friend _dgematrix operator+(const _dgsmatrix&, const  dsymatrix&);
  inline friend _dgematrix operator+(const _dgsmatrix&, const _dsymatrix&);
  inline friend _dgematrix operator+(const _dsymatrix&, const _dgsmatrix&);
  inline friend _dgematrix operator+(const  dsymatrix&, const _dgsmatrix&);
  
  //// - ////
  inline friend _dgsmatrix operator-(const  dgsmatrix&, const  dgsmatrix&);
  inline friend _dgsmatrix operator-(const  dgsmatrix&, const _dgsmatrix&);
  inline friend _dgsmatrix operator-(const _dgsmatrix&, const  dgsmatrix&);
  inline friend _dgsmatrix operator-(const _dgsmatrix&, const _dgsmatrix&);
  
  inline friend _dgematrix operator-(const _dgsmatrix&, const  dgematrix&);
  inline friend _dgematrix operator-(const _dgsmatrix&, const _dgematrix&);
  inline friend _dgematrix operator-(const _dgematrix&, const _dgsmatrix&);
  inline friend _dgematrix operator-(const  dgematrix&, const _dgsmatrix&);
  
  inline friend _dgematrix operator-(const _dgsmatrix&, const  dgbmatrix&);
  inline friend _dgematrix operator-(const _dgsmatrix&, const _dgbmatrix&);
  inline friend _dgematrix operator-(const _dgbmatrix&, const _dgsmatrix&);
  inline friend _dgematrix operator-(const  dgbmatrix&, const _dgsmatrix&);
  
  inline friend _dgematrix operator-(const _dgsmatrix&, const  dsymatrix&);
  inline friend _dgematrix operator-(const _dgsmatrix&, const _dsymatrix&);
  inline friend _dgematrix operator-(const _dsymatrix&, const _dgsmatrix&);
  inline friend _dgematrix operator-(const  dsymatrix&, const _dgsmatrix&);
  
  //// * ////
  inline friend _dgsmatrix operator*(const  dgsmatrix&, const  dgsmatrix&);
  inline friend _dgsmatrix operator*(const  dgsmatrix&, const _dgsmatrix&);
  inline friend _dgsmatrix operator*(const _dgsmatrix&, const  dgsmatrix&);
  inline friend _dgsmatrix operator*(const _dgsmatrix&, const _dgsmatrix&);
  
  inline friend _dgematrix operator*(const _dgsmatrix&, const  dgematrix&);
  inline friend _dgematrix operator*(const _dgsmatrix&, const _dgematrix&);
  inline friend _dgematrix operator*(const _dgematrix&, const _dgsmatrix&);
  inline friend _dgematrix operator*(const  dgematrix&, const _dgsmatrix&);
  
  inline friend _dgematrix operator*(const _dgsmatrix&, const  dgbmatrix&);
  inline friend _dgematrix operator*(const _dgsmatrix&, const _dgbmatrix&);
  inline friend _dgematrix operator*(const _dgbmatrix&, const _dgsmatrix&);
  inline friend _dgematrix operator*(const  dgbmatrix&, const _dgsmatrix&);
  
  inline friend _dgematrix operator*(const _dgsmatrix&, const  dsymatrix&);
  inline friend _dgematrix operator*(const _dgsmatrix&, const _dsymatrix&);
  inline friend _dgematrix operator*(const _dsymatrix&, const _dgsmatrix&);
  inline friend _dgematrix operator*(const  dsymatrix&, const _dgsmatrix&);
  
  inline friend _dcovector operator*(const  dgsmatrix&, const  dcovector&);
  inline friend _dcovector operator*(const  dgsmatrix&, const _dcovector&);
  
  inline friend _drovector operator*(const  drovector&, const _dgsmatrix&);
  inline friend _drovector operator*(const _drovector&, const _dgsmatrix&);
  
  inline friend _dgsmatrix operator*(const  dgsmatrix&, const     double&);
  inline friend _dgsmatrix operator*(const _dgsmatrix&, const     double&);
  inline friend _dgsmatrix operator*(const     double&, const  dgsmatrix&);
  inline friend _dgsmatrix operator*(const     double&, const _dgsmatrix&);
  
  //// / ////
  inline friend _dgsmatrix operator/(const  dgsmatrix&, const     double&);
  inline friend _dgsmatrix operator/(const _dgsmatrix&, const     double&);
  
  //// friend classes ////
  friend class  dgematrix;
  friend class _dgematrix;
  friend class  dgbmatrix;
  friend class _dgbmatrix;
  friend class  dsymatrix;
  friend class _dsymatrix;
  friend class  dgsmatrix;
  friend class  dcovector;
  friend class _dcovector;
  friend class  drovector;
  friend class _drovector;
};