Manual de Calibre | Page 159

Manual de usuario de calibre, Publicación 2.73.0 {series:'re_group($, "(\S* )(.*)", "[[$:uppercase()]]", "[[$]]")'} series_sort() – devuelve el valor de orden de serie. strcat(a,b,...) – puede tomar cualquier número de argumentos. Devuelve texto formado por la concatenación de todos los argumentos. strcat_max(máx,texto1,prefijo2,texto2,...) – devuelve un texto formado por concatenación de los argumentos. El valor devuelto es inicialmente texto1. Se van añadiendo parejas prefijo, texto al final del valor mientras la longitud del resultado sea menor que máx. El resultado es siempre al menos texto1, aunque su longitud sea mayor que máx. Pueden especificarse tantas parejas prefijo, texto como se desee. strcmp(x,y,mn,ig,my) – hace una comparación sin distinción de mayúsculas y minúsculas entre x e y como textos. Devuelve mn si x < y. Devuelve ig si x == y. Devuelve my en otros casos. strlen(a) – Devuelve la longitud del texto pasado como argumento. substr(texto,inicio,fin) – devuelve los caracteres entre la posición inicio y fin de texto. El primer carácter de texto está en la posición cero. Si fin es negativo, entonces indica la posición contando desde la derecha. Si fin es cero, indica el último carácter. Por ejemplo, substr('12345',1,0) devuelve 2345, y substr('12345',1,-1) devuelve 234. subtract(x,y) – devuelve x - y. Da un error si x o y no son números. today() – devuelve un texto para la fecha de hoy. Este valor está preparado para usarse con format_date o days_between, pero puede manipularse como cualquier otro texto. La fecha está en formato ISO. template(x) – evalúa x como una plantilla. La evaluación se realiza en un contexto propio, lo que significa que las variables no se comparten entre el proceso que llama a la función y la evaluación de la plantilla. Dado que los caracteres { y } tienen un uso especial, debe usar [[ en lugar de { y ]] para }; se convertirán automáticamente. Por ejemplo, template('[[orden_de_título]]') evaluará la plantilla {orden_de_título} y devolverá su valor. Tenga en cuenta que los prefijos y sufijos (la sintaxis |prefijo|sufijo) no puede usarse en el argumento de esta función en el modo de programación de plantilla. Clasificación de funciones Reference for all built-in template language functions Here, we document all the built-in functions available in the calibre template language. Every function is implemented as a class in python and you can click the source links to see the source code, in case the documentation is insufficient. The functions are arranged in logical groups by type. Arithmetic (página 158) • add(x, y) (página 158) • divide(x, y) (página 158) • multiply(x, y) (página 158) • subtract(x, y) (página 158) Boolean (página 158) • and(valor, valor, ...) (página 158) • not(valor) (página 159) • or(valor, valor, ...) (página 159) 1.9. Cursillos 155