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

生物技术

开发平台:

C/C++

  1. /*
  2.  * ===========================================================================
  3.  * PRODUCTION $Log: flat_text_formatter.hpp,v $
  4.  * PRODUCTION Revision 1000.0  2003/10/29 21:00:26  gouriano
  5.  * PRODUCTION PRODUCTION: IMPORTED [ORIGINAL] Dev-tree R1.6
  6.  * PRODUCTION
  7.  * ===========================================================================
  8.  */
  9. #ifndef OBJECTS_FLAT___FLAT_TEXT_FORMATTER__HPP
  10. #define OBJECTS_FLAT___FLAT_TEXT_FORMATTER__HPP
  11. /*  $Id: flat_text_formatter.hpp,v 1000.0 2003/10/29 21:00:26 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. * Author:  Aaron Ucko, NCBI
  37. *
  38. * File Description:
  39. *   new (early 2003) flat-file generator -- base class for traditional
  40. *   line-oriented formats (GenBank, EMBL, DDBJ but not GBSeq)
  41. *
  42. */
  43. #include <objtools/flat/flat_formatter.hpp>
  44. BEGIN_NCBI_SCOPE
  45. BEGIN_SCOPE(objects)
  46. class IFlatTextOStream : public CObject
  47. {
  48. public:
  49.     virtual void NewSequence (void) { } // switch to a new window/tab in GUIs?
  50.     // NB: item may be null, or appear for multiple paragraphs.
  51.     virtual void AddParagraph(const list<string>&  lines,
  52.                               const IFlatItem*     item = 0,
  53.                               const CSerialObject* topic = 0) = 0;
  54.     virtual SIZE_TYPE GetWidth(void) const { return 79; }
  55. };
  56. class NCBI_FLAT_EXPORT CFlatTextOStream : public IFlatTextOStream
  57. {
  58. public:
  59.     CFlatTextOStream(CNcbiOstream& stream, bool trace_topics = false);
  60.     virtual void AddParagraph(const list<string>&  lines,
  61.                               const IFlatItem*     item = 0,
  62.                               const CSerialObject* topic = 0);
  63. private:
  64.     CNcbiOstream&            m_Stream;
  65.     auto_ptr<CObjectOStream> m_TraceStream;
  66. };
  67. // Standard behavior is GB/DDBJ-ish.
  68. class NCBI_FLAT_EXPORT CFlatTextFormatter : public IFlatFormatter
  69. {
  70. public:
  71.     static CFlatTextFormatter* New(IFlatTextOStream& stream, CScope& scope,
  72.                                    EMode mode, EDatabase db,
  73.                                    EStyle style = eStyle_Normal,
  74.                                    TFlags flags = 0);
  75. protected:
  76.     CFlatTextFormatter(IFlatTextOStream& stream, CScope& scope, EMode mode,
  77.                        EStyle style = eStyle_Normal, TFlags flags = 0)
  78.         : IFlatFormatter(scope, mode, style, flags), m_Stream(&stream),
  79.           m_Indent(12, ' '), m_FeatIndent(21, ' ')
  80.         { }
  81.     void BeginSequence   (CFlatContext& ctx);
  82.     void FormatHead      (const CFlatHead& head);
  83.     void FormatKeywords  (const CFlatKeywords& keys);
  84.     void FormatSegment   (const CFlatSegment& seg);
  85.     void FormatSource    (const CFlatSource& source);
  86.     void FormatReference (const CFlatReference& ref);
  87.     void FormatComment   (const CFlatComment& comment);
  88.     void FormatPrimary   (const CFlatPrimary& prim); // TPAs
  89.     void FormatFeatHeader(const CFlatFeatHeader& fh);
  90.     void FormatFeature   (const IFlattishFeature& f);
  91.     void FormatDataHeader(const CFlatDataHeader& dh);
  92.     void FormatData      (const CFlatData& data);
  93.     // alternatives to DataHeader + Data...
  94.     void FormatContig    (const CFlatContig& contig);
  95.     void FormatWGSRange  (const CFlatWGSRange& range);
  96.     void FormatGenomeInfo(const CFlatGenomeInfo& g); // NS_*
  97.     void EndSequence     (void);
  98.     enum EPadContext {
  99.         ePara,
  100.         eSubp,
  101.         eFeatHead,
  102.         eFeat
  103.     };
  104.     static  string& Pad(const string& s, string& out, SIZE_TYPE width,
  105.                         const string& indent = kEmptyStr);
  106.     virtual string& Pad(const string& s, string& out, EPadContext where);
  107.     CRef<IFlatTextOStream> m_Stream;
  108.     string                 m_Indent, m_FeatIndent;
  109. private:
  110.     list<string>& Wrap(list<string>& l, const string& tag, const string& body,
  111.                        EPadContext where = ePara);
  112. };
  113. ///////////////////////////////////////////////////////////////////////////
  114. // INLINE METHODS
  115. inline
  116. string& CFlatTextFormatter::Pad(const string& s, string& out, SIZE_TYPE width,
  117.                                 const string& indent)
  118. {
  119.     out.assign(indent);
  120.     out += s;
  121.     out.resize(width, ' ');
  122.     return out;
  123. }
  124. inline
  125. list<string>& CFlatTextFormatter::Wrap(list<string>& l, const string& tag,
  126.                                        const string& body, EPadContext where)
  127. {
  128.     NStr::TWrapFlags flags = DoHTML() ? NStr::fWrap_HTMLPre : 0;
  129.     string tag2;
  130.     Pad(tag, tag2, where);
  131.     NStr::Wrap(body, m_Stream->GetWidth(), l, flags,
  132.                where == eFeat ? m_FeatIndent : m_Indent, tag2);
  133.     return l;
  134. }
  135. END_SCOPE(objects)
  136. END_NCBI_SCOPE
  137. /*
  138. * ===========================================================================
  139. *
  140. * $Log: flat_text_formatter.hpp,v $
  141. * Revision 1000.0  2003/10/29 21:00:26  gouriano
  142. * PRODUCTION: IMPORTED [ORIGINAL] Dev-tree R1.6
  143. *
  144. * Revision 1.6  2003/10/09 17:01:49  dicuccio
  145. * Added export specifiers
  146. *
  147. * Revision 1.5  2003/06/02 16:01:39  dicuccio
  148. * Rearranged include/objects/ subtree.  This includes the following shifts:
  149. *     - include/objects/alnmgr --> include/objtools/alnmgr
  150. *     - include/objects/cddalignview --> include/objtools/cddalignview
  151. *     - include/objects/flat --> include/objtools/flat
  152. *     - include/objects/objmgr/ --> include/objmgr/
  153. *     - include/objects/util/ --> include/objmgr/util/
  154. *     - include/objects/validator --> include/objtools/validator
  155. *
  156. * Revision 1.4  2003/04/10 20:08:22  ucko
  157. * Arrange to pass the item as an argument to IFlatTextOStream::AddParagraph
  158. *
  159. * Revision 1.3  2003/03/28 17:45:36  dicuccio
  160. * Added (very judicious) use of Win32 exports - only needed in external classes
  161. * CFlatTextFormatter and IFlatFormatter
  162. *
  163. * Revision 1.2  2003/03/21 18:47:47  ucko
  164. * Turn most structs into (accessor-requiring) classes; replace some
  165. * formerly copied fields with pointers to the original data.
  166. *
  167. * Revision 1.1  2003/03/10 16:39:08  ucko
  168. * Initial check-in of new flat-file generator
  169. *
  170. *
  171. * ===========================================================================
  172. */
  173. #endif  /* OBJECTS_FLAT___FLAT_TEXT_FORMATTER__HPP */