Run grand-replace (issue 3765)

[lilypond.git] / lily / include / scm-hash.hh

diff --git a/lily/include/scm-hash.hh b/lily/include/scm-hash.hh
index 3bc455f88a9c4ba8360467a993eec75438eecb1b..1182c503f9af5791e1fddf3301b049e5c09be680 100644 (file)
--- a/lily/include/scm-hash.hh
+++ b/lily/include/scm-hash.hh
@@ -1,40 +1,65 @@
-/*   
-  scm-hash.hh -- declare Scheme hasher.
-  
-  source file of the GNU LilyPond music typesetter
-  
-  (c) 1999 Han-Wen Nienhuys <hanwen@cs.uu.nl>
-  
- */
+/*
+  This file is part of LilyPond, the GNU music typesetter.
+
+  Copyright (C) 1999--2014 Han-Wen Nienhuys <hanwen@xs4all.nl>
+
+  LilyPond 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 3 of the License, or
+  (at your option) any later version.
+
+  LilyPond 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 LilyPond.  If not, see <http://www.gnu.org/licenses/>.
+*/
 
 #ifndef SCM_HASH_HH
 #define SCM_HASH_HH
 
-#include "lily-guile.hh"
-#include "hash-table.hh"
 #include "smobs.hh"
 
-/**
-   auto resizing hash table. This should come from GUILE.
- */
-class Scheme_hash_table : private Hash_table<SCM,SCM>
+/*
+  hash table.
+
+  1. ALWAYS USE THIS AS VIA A POINTER, i.e.
+
+  class Foo {
+  Scheme_hash_table * tab;
+  };
+
+  and NOT
+
+  class Foo {
+  Scheme_hash_table tab;
+  }
+
+
+  2. UPON DESTRUCTION, DO
+
+  scm_gc_unprotect_object (tab->self_scm_);
+*/
+
+class Scheme_hash_table
 {
 public:
-  //  bool elem_b (SCM k) const;
-  Hash_table<SCM,SCM>::try_retrieve;
-  Hash_table<SCM,SCM>::elem_b;  
-  /**
-     WARNING: putting something in assumes responsibility for cleaning
-     up.  */
+  bool try_retrieve (SCM key, SCM *val);
+  bool contains (SCM key) const;
   void set (SCM k, SCM v);
-  SCM get (SCM k);
-  
+  SCM get (SCM k) const;
+  void remove (SCM k);
   Scheme_hash_table ();
-  void operator = (Scheme_hash_table const &); 
+  void operator = (Scheme_hash_table const &);
   Scheme_hash_table (Scheme_hash_table const &);
-  virtual ~Scheme_hash_table ();
-  DECLARE_SMOBS;
   SCM to_alist () const;
+
+private:
+  SCM hash_tab_;
+  void copy (Scheme_hash_table const &src);
+  DECLARE_SMOBS (Scheme_hash_table);
 };
 
 #endif /* SCM_HASH_HH */