integer simio.display.show.usr
Función para mostrar en un display un valor con formato definido por el usuario.
Formato:
integer simio.display.show.usr(integer iIdDisplay, string sFormato, integer iValue)
Parámetros:
integer iIdDisplay: Identificador obtenido al crear el display.
string sFormato: Mascara de formato.
integer iValue: Valor a mostrar en el display.
Devuelve:
Uno (1) si todo ha ido bien.
Notas:
Esta función se utiliza para mostrar un valor en un display desde un script de LUA.
El formato usr está integrado por los siguientes componentes que deben ir entrecomillas: "S1%0X.YfS2"
S1 y S2:
Son cadenas de caracteres que se presentarán tal cual, antes y después de la máscara.
Admiten los siguientes caracteres: A, B, W, N y -
%0X:
Indica que el numero tendrá al menos X dígitos, incluyendo los decimales y el "." decimal.
El 0 indica que se rellenará con 0 a la izquierda para completar. Si se omite el 0 no rellenará por la izquierda.
.Yf:
Indica el número de decimales que se pondrán después del punto.
Se rellenará con 0 por la derecha para completar.
Ejemplos:
simio.display.show.usr(dsply_actv_1, "%07.2f", 23.4)
Se evalúa el numero de decimales (.2f) por lo que se coge el 4 y se completa con un 0 a la derecha --> .40
Se coge la parte entera 23 y se completa con la parte decimal anterior --> 23.40
Se evalúa %07 por lo que los 5 dígitos (23.40, incluyendo el punto) se rellenan con dos ceros a la izquierda --> 0023.40
simio.display.show.usr(dsply_actv_1, "BW3NA5", 3)
Como no se define mascara, el parámetro 3 es ignorado.
Se presenta la cadena tal cual se especifica.
