5.6.1 Sintassi della funzione di sostituzione
Creare una funzione che sostituisca una variabile presente nel codice LilyPond è semplice. La forma generica di queste funzioni è:
funzione =
#(define-music-function
(arg1 arg2 …)
(tipo1? tipo2? …)
#{
…musica…
#})
dove
argNL’nesimo argomento.
tipoN?Un tipo di predicato Scheme per il quale
argNdeve ritornare#t.
…musica…Il normale input LilyPond, usando
$(nei punti in cui sono consentiti solo i costrutti LilyPond) o#(per usarlo come un valore Scheme o come argomento di una funzione musicale o come musica all’interno di liste di musica) per riferirsi agli argomenti (es: ‘#arg1’).
La lista del tipo di predicati è obbligatoria. Alcuni dei tipi di predicati più comuni usati nelle funzioni musicali sono:
boolean? cheap-list? (usarlo al posto di ‘list?’ per un'elaborazione più veloce) ly:duration? ly:music? ly:pitch? markup? number? pair? string? symbol?
Un elenco dei tipi di predicati disponibili si trova in Tipi di predicati predefiniti. Sono consentiti anche tipi di predicati definiti dagli utenti.
Vedi anche
Guida alla notazione: Tipi di predicati predefiniti.
Estendere LilyPond: Music functions.
File installati: ‘lily/music-scheme.cc’, ‘scm/c++.scm’, ‘scm/lily.scm’.