- add sources for C++/Tcl based backend, add directories

- tools/src/... - tools/tcl/... - tools/dox - tools/make - add rlink test system - rtl/sys_gen/tst_rlink/nexys2/...
2026-02-03 15:33:22 +00:00 · 2011-04-02 11:08:56 +00:00
parent c3d40ba4b9
commit a20f49fcd5
183 changed files with 17944 additions and 34 deletions
--- a/tools/src/librtools/RosFill.cpp
+++ b/tools/src/librtools/RosFill.cpp
@@ -0,0 +1,92 @@
+// $Id: RosFill.cpp 364 2011-02-26 08:33:01Z mueller $
+//
+// Copyright 2000-2011 by Walter F.J. Mueller <W.F.J.Mueller@gsi.de>
+//
+// This program is free software; you may redistribute and/or modify it under
+// the terms of the GNU General Public License as published by the Free
+// Software Foundation, either version 2, 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 complete details.
+// 
+// Revision History: 
+// Date         Rev Version  Comment
+// 2011-02-25   364   1.1    Support << also to string
+// 2011-01-30   357   1.0    Adopted from RosFill
+// 2000-02-29     -   -      Last change on RosFill
+// ---------------------------------------------------------------------------
+
+/*!
+  \file
+  \version $Id: RosFill.cpp 364 2011-02-26 08:33:01Z mueller $
+  \brief   Implemenation of RosFill .
+*/
+
+#include "RosFill.hpp"
+
+using namespace std;
+using namespace Retro;
+
+/*! 
+  \class Retro::RosFill 
+  \brief I/O appicator to generate fill characters.
+
+  An \c RosFill object will add a given number of fill characters to an output
+  stream each time the object is inserted into the stream. The fill character
+  and the repeat count are specified when the object is constructed.
+
+  A typical usage of \c RosFill is to implement indention, especially when the
+  amount of indention is only known at runtime. The a Dump() function of a 
+  class may use use \c RosFill following the pattern:
+  \code
+void xyz::Dump(ostream& os, int indent) const
+{
+  RosFill bl(indent);
+  
+  os << bl << "-- xyz " << " @ " << this << endl;
+  os << bl << "  fMember1:    " << fMember1 << endl;
+  os << bl << "  fMember2:    " << fMember2 << endl;
+  fEmbeddedClass.Dump(os, indent+2);
+  return;
+}
+  \endcode
+
+  The indention is passed with \c indent. The object \c bl is setup to
+  create \c indent blanks and thrown into the outstream \c os at the
+  start of each output line. The \c Dump() function of member variables of
+  class type is called with a increamented indention (here \c indent+2).
+  This finally produces a nicely structured output.
+*/
+
+//------------------------------------------+-----------------------------------
+/*! 
+  \relates RosFill
+  \brief ostream insertion operator.
+*/
+
+std::ostream& Retro::operator<<(std::ostream& os, const RosFill& obj)
+{
+  for (int i=0; i<obj.Count(); i++) os.put(obj.Fill());
+  return os;
+}
+
+//------------------------------------------+-----------------------------------
+/*! 
+  \relates RosFill
+  \brief string insertion operator.
+*/
+
+std::string& Retro::operator<<(std::string& os, const RosFill& obj)
+{
+  for (int i=0; i<obj.Count(); i++) os.push_back(obj.Fill());
+  return os;
+}
+
+//------------------------------------------+-----------------------------------
+#if (defined(Retro_NoInline) || defined(Retro_RosFill_NoInline))
+#define inline
+#include "RosFill.ipp"
+#undef  inline
+#endif