]> git.donarmstrong.com Git - lilypond.git/blobdiff - lily/include/lily-guile-macros.hh
Run grand replace for 2015.
[lilypond.git] / lily / include / lily-guile-macros.hh
index 77c45973648e33f0888c3be00c2c62bc4298f2e1..1196f1ec5dd683eef581b8f5654296b9c7a44f29 100644 (file)
@@ -1,14 +1,27 @@
 /*
-  lily-guile-macros.hh -- declare
+  This file is part of LilyPond, the GNU music typesetter.
 
-  source file of the GNU LilyPond music typesetter
+  Copyright (C) 2005--2015 Han-Wen Nienhuys <hanwen@xs4all.nl>
 
-  (c) 2005--2006 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 LILY_GUILE_MACROS_HH
 #define LILY_GUILE_MACROS_HH
 
+#include "config.hh"
+
 #ifndef SMOB_FREE_RETURN_VAL
 #define SMOB_FREE_RETURN_VAL(CL) 0
 #endif
 #define SCM_UNPACK(x) (x)
 #endif
 
-#if (__GNUC__ > 2)
+/* For backward compatability with Guile 1.8 */
+#if !HAVE_GUILE_SUBR_TYPE
+typedef SCM (*scm_t_subr) (GUILE_ELLIPSIS);
+#endif
+
 /* Unreliable with gcc-2.x
    FIXME: should add check for x86 as well?  */
 #define CACHE_SYMBOLS
-#endif
 
 #ifdef CACHE_SYMBOLS
 
 /* this lets us "overload" macros such as get_property to take
    symbols as well as strings */
 inline SCM
-scm_or_str2symbol (char const *c) { return scm_str2symbol (c); }
+scm_or_str2symbol (char const *c) { return scm_from_locale_symbol (c); }
 
 inline SCM
-scm_or_str2symbol (SCM s) { return s; }
+scm_or_str2symbol (SCM s)
+{
+  assert (scm_is_symbol (s));
+  return s;
+}
 
-/* Using this trick we cache the value of scm_str2symbol ("fooo") where
+/* Using this trick we cache the value of scm_from_locale_symbol ("fooo") where
    "fooo" is a constant string. This is done at the cost of one static
    variable per ly_symbol2scm() use, and one boolean evaluation for
    every call.
-
-   The overall speedup of lily is about 5% on a run of wtk1-fugue2.  */
-#define ly_symbol2scm(x)                                               \
-  ({                                                                   \
-    static SCM cached;                                                 \
-    /* We store this one locally, since G++ -O2 fucks up else */       \
-    SCM value = cached;                                                        \
-    if (__builtin_constant_p ((x)))                                    \
-      {                                                                        \
-       if (!cached)                                                    \
-         value = cached = scm_gc_protect_object (scm_or_str2symbol (x)); \
-      }                                                                        \
-    else                                                               \
-      value = scm_or_str2symbol (x);                                   \
-    value;                                                             \
+ */
+#define ly_symbol2scm(x)                                                \
+  ({                                                                    \
+    static SCM cached;                                                  \
+    /* We store this one locally, since G++ -O2 fucks up else */        \
+    SCM value = cached;                                                 \
+    if (__builtin_constant_p ((x)))                                     \
+      {                                                                 \
+        if (!cached)                                                    \
+          value = cached = scm_gc_protect_object (scm_or_str2symbol (x)); \
+      }                                                                 \
+    else                                                                \
+      value = scm_or_str2symbol (x);                                    \
+    value;                                                              \
   })
 #else
-inline SCM ly_symbol2scm (char const *x) { return scm_str2symbol ((x)); }
+inline SCM ly_symbol2scm (char const *x) { return scm_from_locale_symbol ((x)); }
 #endif
 
 /*
-  TODO: rename me to ly_c_lily_module_eval
-
   we don't have to protect the result; it's already part of the
   exports list of the module.
 */
 
-#define ly_lily_module_constant(x)                                     \
-  ({                                                                   \
-    static SCM cached;                                                 \
-    /* We store this one locally, since G++ -O2 fucks up else */       \
-    SCM value = cached;                                                        \
-    if (__builtin_constant_p ((x)))                                    \
-      {                                                                        \
-       if (!cached)                                                    \
-         value = cached = scm_eval (scm_str2symbol (x),                \
-                                    global_lily_module);               \
-      }                                                                        \
-    else                                                               \
-      value = scm_eval (scm_str2symbol (x), global_lily_module);       \
-    value;                                                             \
+#define ly_lily_module_constant(x)                                      \
+  ({                                                                    \
+    static SCM cached;                                                  \
+    /* We store this one locally, since G++ -O2 fucks up else */        \
+    SCM value = cached;                                                 \
+    if (__builtin_constant_p ((x)))                                     \
+      {                                                                 \
+        if (!cached)                                                    \
+          value = cached =                                              \
+            scm_variable_ref (scm_c_module_lookup (global_lily_module, (x))); \
+      }                                                                 \
+    else                                                                \
+      value =                                                           \
+        scm_variable_ref (scm_c_module_lookup (global_lily_module, (x))); \
+    value;                                                              \
   })
 
 /*
   Adds the NAME as a Scheme function, and a variable to store the SCM
   version of the function in the static variable NAME_proc
 */
-#define DECLARE_SCHEME_CALLBACK(NAME, ARGS)    \
-  static SCM NAME ARGS;                                \
+#define DECLARE_SCHEME_CALLBACK(NAME, ARGS)     \
+  static SCM NAME ARGS;                         \
   static SCM NAME ## _proc
+
+string mangle_cxx_identifier (string);
+
+void ly_add_type_predicate (void *ptr, const string &name);
+string predicate_to_typename (void *ptr);
+
 /*
   Make TYPE::FUNC available as a Scheme function.
 */
-string mangle_cxx_identifier (string);
-#define MAKE_SCHEME_CALLBACK_WITH_OPTARGS(TYPE, FUNC, ARGCOUNT, OPTIONAL_COUNT)        \
-  SCM TYPE ::FUNC ## _proc;                                            \
-  void                                                                 \
-  TYPE ## _ ## FUNC ## _init_functions ()                              \
-  {                                                                    \
-    string id = mangle_cxx_identifier (string (#TYPE) + "::" + string (#FUNC)); \
-    TYPE ::FUNC ## _proc = scm_c_define_gsubr (id.c_str(),                     \
-                                              (ARGCOUNT-OPTIONAL_COUNT), OPTIONAL_COUNT, 0,    \
-                                              (Scheme_function_unknown) TYPE::FUNC); \
-    scm_c_export (id.c_str (), NULL);                                  \
-  }                                                                    \
-                                                                       \
-  ADD_SCM_INIT_FUNC (TYPE ## _ ## FUNC ## _callback,                   \
-                    TYPE ## _ ## FUNC ## _init_functions);
-
-#define MAKE_SCHEME_CALLBACK(TYPE, FUNC, ARGCOUNT)                     \
-  MAKE_SCHEME_CALLBACK_WITH_OPTARGS(TYPE,FUNC,ARGCOUNT,0);
-
-void
-ly_add_function_documentation (SCM proc, char const *fname,
-                              char const *varlist,
-                              char const *doc);
-
-#define ADD_SCM_INIT_FUNC(name, func)          \
-  class name ## _scm_initter                   \
-  {                                            \
-  public:                                      \
-    name ## _scm_initter ()                    \
-    {                                          \
-      add_scm_init_func (func);                        \
-    }                                          \
-  }                                            \
+#define MAKE_SCHEME_CALLBACK_WITH_OPTARGS(TYPE, FUNC, ARGCOUNT, OPTIONAL_COUNT, DOC) \
+  SCM TYPE ::FUNC ## _proc;                                             \
+  void                                                                  \
+  TYPE ## _ ## FUNC ## _init_functions ()                               \
+  {                                                                     \
+    string cxx = string (#TYPE) + "::" + string (#FUNC); \
+    string id = mangle_cxx_identifier (cxx); \
+    TYPE ::FUNC ## _proc = scm_c_define_gsubr (id.c_str(),                      \
+                                               (ARGCOUNT-OPTIONAL_COUNT), OPTIONAL_COUNT, 0,    \
+                                               (scm_t_subr) TYPE::FUNC); \
+    ly_add_function_documentation (TYPE :: FUNC ## _proc, id.c_str(), "", \
+                                   DOC);                                \
+    scm_c_export (id.c_str (), NULL);                                   \
+  }                                                                     \
+                                                                        \
+  ADD_SCM_INIT_FUNC (TYPE ## _ ## FUNC ## _callback,                    \
+                     TYPE ## _ ## FUNC ## _init_functions);
+
+#define MAKE_DOCUMENTED_SCHEME_CALLBACK(TYPE, FUNC, ARGCOUNT, DOC)              \
+  MAKE_SCHEME_CALLBACK_WITH_OPTARGS(TYPE, FUNC, ARGCOUNT, 0, DOC);
+
+#define MAKE_SCHEME_CALLBACK(TYPE, FUNC, ARGCOUNT)                      \
+  MAKE_SCHEME_CALLBACK_WITH_OPTARGS(TYPE,FUNC,ARGCOUNT, 0, "");
+
+void ly_add_function_documentation (SCM proc, const string &fname, const string &varlist, const string &doc);
+void ly_check_name (const string &cxx, const string &fname);
+
+#define ADD_SCM_INIT_FUNC(name, func)           \
+  class name ## _scm_initter                    \
+  {                                             \
+  public:                                       \
+    name ## _scm_initter ()                     \
+    {                                           \
+      add_scm_init_func (func);                 \
+    }                                           \
+  }                                             \
     _ ## name ## _scm_initter;
 
 /* end define */
 
 #define LY_DEFINE_WITHOUT_DECL(INITPREFIX, FNAME, PRIMNAME, REQ, OPT, VAR, \
-                              ARGLIST, DOCSTRING)                      \
-  SCM FNAME ## _proc;                                                  \
-  void                                                                 \
-  INITPREFIX ## init ()                                                        \
-  {                                                                    \
-    FNAME ## _proc = scm_c_define_gsubr (PRIMNAME, REQ, OPT, VAR,      \
-                                        (Scheme_function_unknown) FNAME); \
-    ly_add_function_documentation (FNAME ## _proc, PRIMNAME, #ARGLIST, \
-                                  DOCSTRING);                          \
-    scm_c_export (PRIMNAME, NULL);                                     \
-  }                                                                    \
+                               ARGLIST, DOCSTRING)                      \
+  SCM FNAME ## _proc;                                                   \
+  void                                                                  \
+  INITPREFIX ## init ()                                                 \
+  {                                                                     \
+    FNAME ## _proc = scm_c_define_gsubr (PRIMNAME, REQ, OPT, VAR,       \
+                                         (scm_t_subr) FNAME); \
+    ly_check_name (#FNAME, PRIMNAME);\
+    ly_add_function_documentation (FNAME ## _proc, PRIMNAME, #ARGLIST,  \
+                                   DOCSTRING);                          \
+    scm_c_export (PRIMNAME, NULL);                                      \
+  }                                                                     \
   ADD_SCM_INIT_FUNC (INITPREFIX ## init_unique_prefix, INITPREFIX ## init); \
-  SCM                                                                  \
+  SCM                                                                   \
   FNAME ARGLIST
 
-#define LY_DEFINE(FNAME, PRIMNAME, REQ, OPT, VAR, ARGLIST, DOCSTRING)  \
-  SCM FNAME ARGLIST;                                                   \
+#define LY_DEFINE(FNAME, PRIMNAME, REQ, OPT, VAR, ARGLIST, DOCSTRING)   \
+  SCM FNAME ARGLIST;                                                    \
   LY_DEFINE_WITHOUT_DECL (FNAME, FNAME, PRIMNAME, REQ, OPT, VAR, ARGLIST, \
-                         DOCSTRING)
+                          DOCSTRING)
 
 #define LY_DEFINE_MEMBER_FUNCTION(CLASS, FNAME, PRIMNAME, REQ, OPT, VAR, \
-                                 ARGLIST, DOCSTRING)                   \
-  SCM FNAME ARGLIST;                                                   \
+                                  ARGLIST, DOCSTRING)                   \
+  SCM FNAME ARGLIST;                                                    \
   LY_DEFINE_WITHOUT_DECL (CLASS ## FNAME, CLASS::FNAME, PRIMNAME, REQ, OPT, \
-                         VAR, ARGLIST, DOCSTRING)
+                          VAR, ARGLIST, DOCSTRING)
 
 #define get_property(x) internal_get_property (ly_symbol2scm (x))
+#define get_pure_property(x,y,z) \
+  internal_get_pure_property (ly_symbol2scm (x), y, z)
+#define get_maybe_pure_property(w,x,y,z) \
+  internal_get_maybe_pure_property (ly_symbol2scm (w), x, y, z)
+#define get_property_data(x) internal_get_property_data (ly_symbol2scm (x))
 #define get_object(x) internal_get_object (ly_symbol2scm (x))
 #define set_object(x, y) internal_set_object (ly_symbol2scm (x), y)
 #define del_property(x) internal_del_property (ly_symbol2scm (x))
 
 #ifndef NDEBUG
-#define set_property(x, y) internal_set_property (ly_symbol2scm (x), y, __FILE__, __LINE__, __FUNCTION__)
+/*
+  TODO: include modification callback support here, perhaps
+  through intermediate Grob::instrumented_set_property( .. __LINE__ ).
+ */
+#define set_property(x, y) instrumented_set_property (ly_symbol2scm (x), y, __FILE__, __LINE__, __FUNCTION__)
 #else
 #define set_property(x, y) internal_set_property (ly_symbol2scm (x), y)
 #endif
 
+#define LY_ASSERT_TYPE(pred, var, number)                                       \
+  {                                                                     \
+    if (!pred (var)) \
+      {                                                                 \
+        scm_wrong_type_arg_msg(mangle_cxx_identifier (__FUNCTION__).c_str(), \
+                               number, var, \
+                               predicate_to_typename ((void*) &pred).c_str()); \
+      }                                                                 \
+  }
+
+#define LY_ASSERT_SMOB(klass, var, number) LY_ASSERT_TYPE(klass::is_smob, var, number)
+
 #endif /* LILY_GUILE_MACROS_HH */