Manual de usuario de calibre, Publicación 2.73.0
tamaño de un formato específico. Tenga en cuenta que los nombres de formato siempre están en mayúsculas, como en « EPUB ».
has _ cover() – devuelve Yes si el libro tiene portada, en caso contrario devuelve un texto vacío.
not( valor) – devuelve el texto « 1 » si el valor está vacío, en caso contrario, devuelve un texto vacío. Esta función opera bien con « test » o « first _ non _ empty ».
list _ difference( lista1, lista2, separador) – devuelve una lista construida eliminando de lista1 cualquier elemento que aparezca en lista2, sin distinguir mayúsculas y minúsculas. Los elementos de lista1 y lista2 están separados por separador, así como los de la lista resultante.
list _ equals( lista1, sep1, lista2, sep2, val _ sí, val _ no) – devuelve val _ sí si lista1 y lista2 contienen los mismos elementos, en caso contrario devuelve val _ no. Los elementos se determinan dividiendo cada lista por el correspondiente carácter separador( sep1 o sep2). El orden de los elementos no es relevante. La comparación no diferencia mayúsculas y minúsculas.
list _ intersection( lista1, lista2, separador) – devuelve una lista construida eliminando de lista1 cualquier elemento que no aparezca en lista2, sin distinguir mayúsculas y minúsculas. Los elementos de lista1 y lista2 están separados por separador, así como los de la lista resultante.
list _ re( lista _ orig, separador, incluir, sust _ opc) – construye una lista separando primero lista _ orig en elementos usando el carácter separador. Para cada elemento en la lista, comprueba si coincide con la expresión regular incluir. Si coincide, se añade a la lista final. Si sust _ opc no es un texto vacío, se aplica la sustitución antes de añadir el elemento a la lista final.
list _ re _ group( lista _ orig, separador, incluir, búsqueda, plantilla _ grupo _ 1, plantilla _ grupo _ 2 – como list _ re, pero las sustituciones no son opcionales. Usa re _ group( elemento, búsqueda, plantilla _ grupo _ 1,...) para hacer sustituciones..
list _ sort( lista, dirección, separador) – devuelve lista ordenada sin distinción de mayúsculas y minúsculas. Si dirección es cero, la lista se ordena de manera ascendente, en caso contrario, de manera descendente. Los elementos de lista están separados por separador, así como los de la lista resultante.
list _ union( lista1, lista2, separador) – devuelve una lista construida por combinación de los elementos en lista1 y lista2, eliminando los duplicados de lista2( no distingue mayúsculas y minúsculas, se mantiene la versión de lista1). Los elementos de lista1 y lista2 están separados por separador, así como los de la lista resultante.
multiply( x, y)– devuelve x * y. Da una excepción si x o y no son números. ondevice() – devuelve el texto « Yes » si ondevice está activado, si no, devuelve un texto vacío
or( valor, valor,...) – devuelve el texto « 1 » si alguno de los valores no está vacío, en caso contrario devuelve un texto vacío. Esta función opera bien con test o first _ non _ empty. Pueden usarse tantos valores como se desee.
print( a, b,...) – escribe los argumentos en la salida estándar. Sólo será visible si inicia calibre a partir de línea de órdenes( calibre-debug-g).
raw _ field( name) – devuelve el campo de metadatos llamado nombre sin aplicar ningún formato.
raw _ list( nombre, separador) – devuelve la lista de metadatos nombrada por nombre sin aplicar ningún formato u ordenación, con los elementos separados por separador.
re _ group( val, patrón, plantilla _ para _ grupo _ 1, para _ grupo _ 2,...) – devuelve un texto formado por aplicación de la expresión regular patrón al valor val, sustituyendo cada coincidencia por el texto calculado al sustituir cada grupo por el valor devuelto por la correspondiente plantilla. El valor de correspondencia original del grupo está disponible como «$». En el modo de programación de plantillas, como en las funciones template y eval, use [[ en lugar de { y ]] en lugar de }. El siguiente ejemplo en modo de programación de plantillas busca nombres de serie con más de una palabra y pone la primera palabra en mayúsculas:
154 Capítulo 1. Secciones