table.hpp
上传用户:yhdzpy8989
上传日期:2007-06-13
资源大小:13604k
文件大小:4k
源码类别:

生物技术

开发平台:

C/C++

  1. /*
  2.  * ===========================================================================
  3.  * PRODUCTION $Log: table.hpp,v $
  4.  * PRODUCTION Revision 1000.0  2003/10/29 20:58:17  gouriano
  5.  * PRODUCTION PRODUCTION: IMPORTED [ORIGINAL] Dev-tree R1.1
  6.  * PRODUCTION
  7.  * ===========================================================================
  8.  */
  9. #ifndef OBJTOOLS_DATA_LOADERS_TABLE___TABLE__HPP
  10. #define OBJTOOLS_DATA_LOADERS_TABLE___TABLE__HPP
  11. /*  $Id: table.hpp,v 1000.0 2003/10/29 20:58:17 gouriano Exp $
  12.  * ===========================================================================
  13.  *
  14.  *                            PUBLIC DOMAIN NOTICE
  15.  *               National Center for Biotechnology Information
  16.  *
  17.  *  This software/database is a "United States Government Work" under the
  18.  *  terms of the United States Copyright Act.  It was written as part of
  19.  *  the author's official duties as a United States Government employee and
  20.  *  thus cannot be copyrighted.  This software/database is freely available
  21.  *  to the public for use. The National Library of Medicine and the U.S.
  22.  *  Government have not placed any restriction on its use or reproduction.
  23.  *
  24.  *  Although all reasonable efforts have been taken to ensure the accuracy
  25.  *  and reliability of the software and data, the NLM and the U.S.
  26.  *  Government do not and cannot warrant the performance or results that
  27.  *  may be obtained by using this software or data. The NLM and the U.S.
  28.  *  Government disclaim all warranties, express or implied, including
  29.  *  warranties of performance, merchantability or fitness for any particular
  30.  *  purpose.
  31.  *
  32.  *  Please cite the author in any work or product based on this material.
  33.  *
  34.  * ===========================================================================
  35.  *
  36.  * Authors:  Mike DiCuccio
  37.  *
  38.  * File Description:
  39.  *
  40.  */
  41. #include <corelib/ncbiobj.hpp>
  42. #include <objects/seqloc/Seq_loc.hpp>
  43. #include <objects/seqloc/Seq_id.hpp>
  44. BEGIN_NCBI_SCOPE
  45. //
  46. // class ITableIterator defines a forward iterator over a set of rows
  47. // the set of rows is defined by some action on the table data itself
  48. //
  49. class ITableIterator : public CObject
  50. {
  51. public:
  52.     // virtual dtor
  53.     virtual ~ITableIterator() { }
  54.     // retrieve the current row's data
  55.     virtual void GetRow(list<string>& data) const = 0;
  56.     // advance to the next row
  57.     virtual void Next(void) = 0;
  58.     // check to see if the current iterator is valid
  59.     virtual bool IsValid(void) const = 0;
  60.     // pre-increment for advance
  61.     // this is implemented here as operators can't be virtual
  62.     ITableIterator& operator++(void)
  63.     {
  64.         Next();
  65.         return *this;
  66.     }
  67.     // operator bool for validity checking
  68.     // this is implemented here as operators can't be virtual
  69.     operator bool(void) const
  70.     {
  71.         return IsValid();
  72.     }
  73. };
  74. //
  75. // class ITableData defines an abstraction for dealing with tabular structures
  76. //
  77. class ITableData : public CObject
  78. {
  79. public:
  80.     typedef CRef<ITableIterator> TIterator;
  81.     virtual ~ITableData() { }
  82.     // retrieve the number of rows in the table
  83.     virtual int GetNumRows(void) const = 0;
  84.     // retrieve the number of columns in the table
  85.     virtual int GetNumCols(void) const = 0;
  86.     // retrieve a single, numbered row
  87.     virtual void GetRow        (int row, list<string>& data) const = 0;
  88.     // retrieve the title for a given column
  89.     virtual void GetColumnTitle(int col, string& title) const = 0;
  90.     // retrieve a list of the columns in the table
  91.     virtual void GetColumnTitles(list<string>& titles) const = 0;
  92.     // access an iterator for the entire table
  93.     virtual TIterator Begin(void) = 0;
  94.     // obtain an iterator valid for a given ID
  95.     virtual TIterator Begin(const objects::CSeq_id& id) = 0;
  96.     // obtain an iterator valid for a given location
  97.     virtual TIterator Begin(const objects::CSeq_loc& id) = 0;
  98.     // obtain an iterator valid for a given SQL query
  99.     virtual TIterator Begin(const string& query) = 0;
  100. };
  101. END_NCBI_SCOPE
  102. /*
  103.  * ===========================================================================
  104.  * $Log: table.hpp,v $
  105.  * Revision 1000.0  2003/10/29 20:58:17  gouriano
  106.  * PRODUCTION: IMPORTED [ORIGINAL] Dev-tree R1.1
  107.  *
  108.  * Revision 1.1  2003/10/02 17:50:00  dicuccio
  109.  * Moved table reader into the data loader project, as it depends on SQLite
  110.  *
  111.  * ===========================================================================
  112.  */
  113. #endif  // OBJTOOLS_DATA_LOADERS_TABLE___TABLE__HPP