22.3.1 Sintaxis de las funciones de sustitución ¶

Es fácil hacer una función que sustituya a una variable en código de LilyPond. La forma general de estas funciones es

function =
#(define-music-function
     (arg1 arg2 ...)
     (tipo1? tipo2? ...)
   #{
     ...música...
   #})

donde

argN	El n-ésimo argumento.
tipoN?	Un predicado_de_tipo de Scheme para el que argN debe devolver #t.
…música…	Código normal de entrada de LilyPond, que usa ‘$’ (en aquellos lugares donde solo se admiten construcciones de LilyPond) o ‘#’ (para usarlo como un valor de Scheme o argumento de función musical o música dentro de listas de música) para referenciar argumentos (p.ej., ‘#arg1’).

La lista de predicados de tipo es obligatoria. Algunos de los predicados de tipo más comunes que se usan en las funciones musicales son:

• boolean?
• cheap-list? (usar en lugar de ‘list?’ para un procesamiento más rápido)
• ly:duration?
• ly:music?
• ly:pitch?
• markup?
• number?
• pair?
• string?
• symbol?

Para ver una lista de los predicados de tipo disponibles, see Predicados de tipo predefinidos. También se permiten predicados de tipo definidos por el usuario.

Véase también ¶

Referencia de la notación: Predicados de tipo predefinidos.

Manual de extensión de LilyPond: Music functions.

Archivos instalados: lily/music-scheme.cc, scm/c++.scm, scm/lily.scm.