Eneboo - Documentación para desarrolladores
Métodos públicos estáticos
Referencia de la Clase FLUtil

#include <FLUtil.h>

Lista de todos los miembros.

Métodos públicos estáticos

static Q_ULLONG partInteger (double n)
static Q_ULLONG partDecimal (double n)
static QString unidades (long n)
static QCString utf8 (const QString &s)
static QString centenamillar (long n)
static QString decenas (long n)
static QString centenas (long n)
static QString unidadesmillar (long n)
static QString decenasmillar (long n)
static QString enLetra (long n)
static QString enLetraMoneda (double n, const QString &m)
static QString enLetraMonedaEuro (double n)
static QChar letraDni (long n)
static QStringList nombreCampos (const QString &tabla)
static QChar calcularDC (const QString &n)
static QString dateDMAtoAMD (const QString &f)
static QString dateAMDtoDMA (const QString &f)
static QString formatoMiles (const QString &s)
static QString translate (const QString &contexto, const QString &s)
static bool numCreditCard (const QString &num)
static QVariant nextCounter (const QString &name, FLSqlCursor *cursor_)
static QString nextSequence (int nivel, const QString &secuencia, const QString &ultimo)
static bool isFLDefFile (const QString &head)
static QDate addDays (const QDate &d, int nd)
static QDate addMonths (const QDate &d, int nm)
static QDate addYears (const QDate &d, int ny)
static int daysTo (const QDate &d1, const QDate &d2)
static QString buildNumber (const QVariant &v, char tipo, int partDecimal)
static QVariant readSettingEntry (const QString &key, const QString &def=QString::null, bool *ok=0)
static bool writeSettingEntry (const QString &key, const QString &value)
static QVariant readDBSettingEntry (const QString &key)
static bool writeDBSettingEntry (const QString &key, const QString &value)
static QString roundFieldValue (const QVariant &n, const QString &table, const QString &field)
static QVariant sqlSelect (const QString &f, const QString &s, const QString &w, const QString &tL=QString::null, int *size=0, const QString &connName="default")
static QVariant quickSqlSelect (const QString &f, const QString &s, const QString &w, const QString &connName="default")
static bool sqlInsert (const QString &t, const QString &fL, const QString &vL, const QString &connName="default")
static bool sqlUpdate (const QString &t, const QString &fL, const QString &vL, const QString &w, const QString &connName="default")
static bool sqlDelete (const QString &t, const QString &w, const QString &connName="default")
static bool quickSqlDelete (const QString &t, const QString &w, const QString &connName="default")
static void createProgressDialog (const QString &l, int tS, const QString &id="default")
static void destroyProgressDialog (const QString &id="default")
static void setProgress (int p, const QString &id="default")
static void setLabelText (const QString &l, const QString &id="default")
static void setTotalSteps (int tS, const QString &id="default")
static bool domDocumentSetContent (QDomDocument &doc, const QString &content)
static QString sha1 (const QString &str)
static QString usha1 (uchar *data, uint len)
static QImage snapShotUI (const QString &n)
static void saveSnapShotUI (const QString &n, const QString &pathFile)
static QVariant::Type flDecodeType (int fltype)
static void saveIconFile (const QString &data, const QString &pathFile)
static QString getIdioma ()
static QString getOS ()
static QString serialLettertoNumber (const QString &letter)
static QString serialNumbertoLetter (int number)
static QStringList findFiles (const QStringList &paths, const QString &filter="*", bool breakOnFirstMatch=false)
static bool execSql (const QString &sql, const QString &connName="default")

Descripción detallada

Clase con mtodos, herramientas y utiles necesarios para ciertas operaciones.

Es esta clase se encontrarn mtodos genricos que realizan operaciones muy especficas pero que son necesarios para ciertos procesos habituales en las distintas tareas a desempear en la gestin empresarial.

Autor:
InfoSiAL S.L.

Documentación de las funciones miembro

QDate FLUtil::addDays ( const QDate d,
int  nd 
) [static]

Suma dias a una fecha.

Parámetros:
dFecha con la que operar
ndNumero de dias que sumar. Si es negativo resta dias
Devuelve:
Fecha con el desplazamiento de dias
QDate FLUtil::addMonths ( const QDate d,
int  nm 
) [static]

Suma meses a una fecha.

Parámetros:
dFecha con la que operar
nmNumero de meses que sumar. Si es negativo resta meses
Devuelve:
Fecha con el desplazamiento de meses
QDate FLUtil::addYears ( const QDate d,
int  ny 
) [static]

Suma aos a una fecha.

Parámetros:
dFecha con la que operar
nmNumero de aos que sumar. Si es negativo resta aos
Devuelve:
Fecha con el desplazamiento de aos
QString FLUtil::buildNumber ( const QVariant v,
char  tipo,
int  partDecimal 
) [static]

Construye un string a partir de un nmero, especificando el formato y precisin

Parámetros:
v.Nmero a convertir a QString
tipo.Formato del nmero
partDecimal.Precisin (nmero de cifras decimales) del nmero
Devuelve:
Cadena que contiene el nmero formateado
QChar FLUtil::calcularDC ( const QString n) [static]

Obtiene el nmero del digito de control, para cuentas bancarias.

Los nmeros de las cuentas corrientes se organizan de la forma siguiente:

4 Digitos----->Cdigo del banco (ej. 0136 Banco Arabe espaol) 4 Digitos----->Cdigo de la oficina 1 Digito de control------>de los 8 primeros digitos 1 Digito de control------>del nmero de cuenta (de los 10 ultimos digitos) 10 Digitos del nmero de la cuenta

Para comprobar el numero de cuenta se pasa primero los 8 primeros digitos obteniendo asi el primer digito de control, despus se pasan los 10 digitos del nmero de la cuenta obteniendo el segundo digito de control.

Parámetros:
nNmero del que se debe obtener el dgito de control
Devuelve:
Caracter con el dgito de control asociado al nmero dado
QString FLUtil::centenamillar ( long  n) [static]

Enunciado de las centenas de millar de un nmero.

Parámetros:
nNmero a tratar. Debe ser positivo
QString FLUtil::centenas ( long  n) [static]

Enunciado de las centenas de un nmero.

Parámetros:
nNmero a tratar. Debe ser positivo
void FLUtil::createProgressDialog ( const QString l,
int  tS,
const QString id = "default" 
) [static]

Crea un dilogo de progreso

Parámetros:
lLabel del dilogo
tSNmero total de pasos a realizar
QString FLUtil::dateAMDtoDMA ( const QString f) [static]

Convierte fechas del tipo AAAA-MM-DD, AAAA-MM-DD o AAAAMMDD al tipo DD-MM-AAAA.

Parámetros:
fCadena de texto con la fecha a transformar
Devuelve:
Cadena de texto con la fecha transformada
QString FLUtil::dateDMAtoAMD ( const QString f) [static]

Convierte fechas del tipo DD-MM-AAAA, DD/MM/AAAA o DDMMAAAA al tipo AAAA-MM-DD.

Parámetros:
fCadena de texto con la fecha a transformar
Devuelve:
Cadena de texto con la fecha transformada
int FLUtil::daysTo ( const QDate d1,
const QDate d2 
) [static]

Diferencia de dias desde una fecha a otra.

Parámetros:
d1Fecha de partida
d2Fecha de destino
Devuelve:
Nmero de das entre d1 y d2. Ser negativo si d2 es anterior a d1.
QString FLUtil::decenas ( long  n) [static]

Enunciado de las decenas de un nmero.

Parámetros:
nNmero a tratar. Debe ser positivo
QString FLUtil::decenasmillar ( long  n) [static]

Enunciado de las decenas de millar de un nmero.

Parámetros:
nNmero a tratar. Debe ser positivo
void FLUtil::destroyProgressDialog ( const QString id = "default") [static]

Destruye el dilogo de progreso

bool FLUtil::domDocumentSetContent ( QDomDocument doc,
const QString content 
) [static]

Establece el contenido de un documento XML.

Establece un documento DOM a partir del XML. Chequea errores, y si existen muestra el error encontrado y la linea y columna donde se encuentra.

Parámetros:
docDocumento DOM a establecer
contentContenido XML
Devuelve:
FALSE si hubo fallo, TRUE en caso contrario
QString FLUtil::enLetra ( long  n) [static]

Obtiene la expresin en texto de como se enuncia un nmero, en castellano.

Dado un nmero entero, devuelve su expresin en texto de como se enuncia de forma hablada; por ejemplo dado el nmero 130, devolver la cadena de texto "ciento treinta".

Parámetros:
nNmero a transladar a su forma hablada. Debe ser positivo
Devuelve:
Cadena de texto con su expresin hablada
QString FLUtil::enLetraMoneda ( double  n,
const QString m 
) [static]

Obtiene la expresin en texto de como se enuncia una cantidad monetaria, en castellano y en cualquier moneda indicada.

Dado un nmero doble, devuelve su expresin en texto de como se enuncia de forma hablada en la moneda indicada; por ejemplo dado el nmero 130.25, devolver la cadena de texto "ciento treinta 'moneda' con veinticinco cntimos".

Parámetros:
nNmero a transladar a su forma hablada. Debe ser positivo
mNombre de la moneda
Devuelve:
Cadena de texto con su expresin hablada
QString FLUtil::enLetraMonedaEuro ( double  n) [static]

Obtiene la expresin en texto de como se enuncia una cantidad monetaria, en castellano y en Euros.

Dado un nmero doble, devuelve su expresin en texto de como se enuncia de forma hablada en euros; por ejemplo dado el nmero 130.25, devolver la cadena de texto "ciento treinta euros con veinticinco cntimos".

Parámetros:
nNmero a transladar a su forma hablada. Debe ser positivo
Devuelve:
Cadena de texto con su expresin hablada
bool FLUtil::execSql ( const QString sql,
const QString connName = "default" 
) [static]

Uso interno

QStringList FLUtil::findFiles ( const QStringList paths,
const QString filter = "*",
bool  breakOnFirstMatch = false 
) [static]

Busca ficheros recursivamente en las rutas indicadas y segn el patrn indicado

Ejemplo:

C++: QStringList filesFound = FLUtil::findFiles(QStringList() << "/home/user/Documents", "*.odt *.gif"); for (QStringList::Iterator it = filesFound.begin(); it != filesFound.end(); ++it) qWarning(*it);

QSA: var util = new FLUtil; var filesFound = util.findFiles( [ "/home/user/Documents" ], "*.odt *.gif");

for(var i = 0; i < filesFound.length; ++i) debug(filesFound[i]);

Parámetros:
pathsRutas de bsqueda
filterPatrn de filtrado para los ficheros. Admite varios separados por espacios "*.gif *.png". Por defecto todos, "*"
breakOnFirstMatchSi es TRUE al encontrar el primer fichero que cumpla el patrn indicado, termina la bsqueda y devuelve el nombre de ese fichero
Devuelve:
Lista de los nombres de los ficheros encontrados
QVariant::Type FLUtil::flDecodeType ( int  fltype) [static]

Decodifica un tipo de AbanQ a un tipo QVariant

Parámetros:
fltypeTipo de datos de AbanQ.
Devuelve:
Tipo de datos QVariant.
QString FLUtil::formatoMiles ( const QString s) [static]

Formatea una cadena de texto ponindole separadores de miles.

La cadena que se pasa se supone que un nmero, convirtiendola con QString::toDouble(), si la cadena no es nmero el resultado es imprevisible.

Parámetros:
sCadena de texto a la que se le quieren poder separadores de miles
Devuelve:
Devuelve la cadena formateada con los separadores de miles
QString FLUtil::getIdioma ( ) [static]

Devuelve una cadena de dos caracteres con el cdigo de idioma del sistema

Devuelve:
Cdigo de idioma del sistema
QString FLUtil::getOS ( ) [static]

Devuelve el sistema operativo sobre el que se ejecuta el programa

Devuelve:
Cdigo del sistema operativo (WIN32, LINUX, MACX)
bool FLUtil::isFLDefFile ( const QString head) [static]

Para comprobar si la cabecera de un fichero de definicin corresponde con las soportadas por AbanQ.

Este mtodo no sirve para los scripts, slo para los ficheros de definicin; mtd, ui, qry, xml, ts y kut.

Parámetros:
headCadena de caracteres con la cabecera del fichero, bastara con las tres o cuatro primeras linea del fichero no vacas
Devuelve:
TRUE si es un fichero soportado, FALSE en caso contrario
QChar FLUtil::letraDni ( long  n) [static]

Obtiene la letra asociada al nmero del D.N.I. espaol.

Parámetros:
nNumero de D.N.I
Devuelve:
Caracter asociado al nemro de D.N.I
QVariant FLUtil::nextCounter ( const QString name,
FLSqlCursor cursor_ 
) [static]

Este metodo devuelve el siguiente valor de un campo tipo contador de una tabla.

Este metodo es muy util cuando se insertan registros en los que la referencia es secuencial y no nos acordamos de cual fue el ultimo numero usado. El valor devuelto es un QVariant del tipo de campo es el que se busca la ultima referencia. Lo ms aconsejable es que el tipo del campo sea 'String' porque as se le puede dar formato y ser usado para generar un cdigo de barras. De todas formas la funcin soporta tanto que el campo sea de tipo 'String' como de tipo 'double'.

Parámetros:
nameNombre del campo
cursor_Cursor a la tabla donde se encuentra el campo.
Devuelve:
Qvariant con el numero siguiente.
Autor:
Andrs Otn Urbano.
QString FLUtil::nextSequence ( int  nivel,
const QString secuencia,
const QString ultimo 
) [static]

Nos devuelve el siguiente valor de la secuencia segun la profundidad indicada por nivel. Para explicar el funcionamiento pondremos un ejemplo. Supongamos una secuencia tipo A-N. A indica que se coloque en esa posicion una secuencia en letras y N una secuencia en numero. La numeracin de niveles va de derecha a izquierda asi el nivel 1 es N y el nivel 2 A. Si hacemos un nextSequence a nivel 1 el valor de vuelto ser un A que estubiera y un N sumando 1 al anterior. Si el nivel es 2 obtendremos un A + 1, trasformado a letras, y todos los niveles a la derecha de este se ponen a 1 o su correspondiente en letra que seria A.

Parámetros:
nivelIndica la profundidad a la que se hace el incremento.
secuenciaEstructura de la secuencia.
ultimoUltimo valor de la secuencia para poder dar el siguiente valor.
Devuelve:
La secuencia en el formato facilitado.
Autor:
Andrs Otn Urbano
QStringList FLUtil::nombreCampos ( const QString tabla) [static]

Obtiene la lista de nombres de campos de la tabla especificada. El primer string de la lista contiene el nmero de campos de la tabla

Parámetros:
tabla.Nombre de la tabla
Devuelve:
Lista de campos
bool FLUtil::numCreditCard ( const QString num) [static]

Devuelve si el numero de tarjeta de Credito es valido.

El parametro que se pasa es la cadena de texto que contiene el numero de tarjeta.

Parámetros:
numCadena de texto con el numero de tarjeta
Devuelve:
Devuelve verdadero si el numero de tarjeta es valido
Q_ULLONG FLUtil::partDecimal ( double  n) [static]

Obtiene la parte decimal de un nmero.

Dado un nmero devuelve la parte decimal correspondiente, es decir, cifras en la parte derecha de la coma decimal.

Parámetros:
nNmero del que obtener la parte decimal. Debe ser positivo
Devuelve:
La parte decimal del nmero, que puede ser cero
Q_ULLONG FLUtil::partInteger ( double  n) [static]

Obtiene la parte entera de un nmero.

Dado un nmero devuelve la parte entera correspondiente, es decir, cifras en la parte izquierda de la coma decimal.

Parámetros:
nNmero del que obtener la parte entera. Debe ser positivo
Devuelve:
La parte entera del nmero, que puede ser cero
bool FLUtil::quickSqlDelete ( const QString t,
const QString w,
const QString connName = "default" 
) [static]

Versin rpida de sqlDelete. Ejecuta directamente la consulta sin realizar comprobaciones y sin disparar seales de commits. Usar con precaucin.

QVariant FLUtil::quickSqlSelect ( const QString f,
const QString s,
const QString w,
const QString connName = "default" 
) [static]

Versin rpida de sqlSelect. Ejecuta directamente la consulta sin realizar comprobaciones. Usar con precaucin.

QVariant FLUtil::readDBSettingEntry ( const QString key) [static]

Lee el valor de un setting en la tabla flsettings

Parámetros:
key.Clave identificadora del setting
Devuelve:
Valor del setting
QVariant FLUtil::readSettingEntry ( const QString key,
const QString def = QString::null,
bool ok = 0 
) [static]

Lee el valor de un setting en el directorio de la instalacin de AbanQ

Parámetros:
key.Clave identificadora del setting
def.Valor por defecto en el caso de que el setting no est establecido
ok.Indicador de que la lectura es correcta
Devuelve:
Valor del setting
QString FLUtil::roundFieldValue ( const QVariant n,
const QString table,
const QString field 
) [static]

Redondea un valor en funcin de la precisin especificada para un campo tipo double de la base de datos

Parámetros:
n.Nmero a redondear
table.Nombre de la tabla
field.Nombre del campo
Devuelve:
Nmero redondeado
void FLUtil::saveIconFile ( const QString data,
const QString pathFile 
) [static]

Guarda la imagen de icono de un botn de un formulario en un ficher png. Utilizado para documentacin

Parámetros:
dataContenido de la imagen en una cadena de caracteres
pathFileRuta completa al fichero donde se guadar la imagen
void FLUtil::saveSnapShotUI ( const QString n,
const QString pathFile 
) [static]

Salva en un fichero con formato PNG la imagen o captura de pantalla de un formulario.

Parámetros:
nNombre del fichero que contiene la descricpcin del formulario.
pathFileRuta y nombre del fichero donde guardar la imagen
QString FLUtil::serialLettertoNumber ( const QString letter) [static]

Esta funcin convierte una cadena que es una serie de letras en su correspondiente valor numerico.

Parámetros:
letterCadena con la serie.
Devuelve:
Una cadena pero que contiene numeros.
QString FLUtil::serialNumbertoLetter ( int  number) [static]

Esta funcin convierte un numero a su correspondiente secuencia de Letras.

Parámetros:
numberNmero a convertir
void FLUtil::setLabelText ( const QString l,
const QString id = "default" 
) [static]

Cambia el texto de la etiqueta del dilogo

Parámetros:
lEtiqueta
void FLUtil::setProgress ( int  p,
const QString id = "default" 
) [static]

Establece el grado de progreso del dilogo

Parámetros:
pGrado de progreso
void FLUtil::setTotalSteps ( int  tS,
const QString id = "default" 
) [static]

Establece el nmero total de pasos del dilogo

Parámetros:
tsNmero total de pasos
QString FLUtil::sha1 ( const QString str) [static]

Obtiene la clave SHA1 de una cadena de texto.

Parámetros:
strCadena de la que obtener la clave SHA1
Devuelve:
Clave correspondiente en digitos hexadecimales
QImage FLUtil::snapShotUI ( const QString n) [static]

Obtiene la imagen o captura de pantalla de un formulario.

Parámetros:
nNombre del fichero que contiene la descricpcin del formulario.
bool FLUtil::sqlDelete ( const QString t,
const QString w,
const QString connName = "default" 
) [static]

Borra uno o ms registros en una tabla mediante un objeto FLSqlCursor

Parámetros:
tNombre de la tabla
wSentencia where para identificar los registros a borrar.
connNameNombre de la conexion
Devuelve:
Verdadero en caso de realizar la insercin con xito, falso en cualquier otro caso
bool FLUtil::sqlInsert ( const QString t,
const QString fL,
const QString vL,
const QString connName = "default" 
) [static]

Realiza la insercin de un registro en una tabla mediante un objeto FLSqlCursor

Parámetros:
tNombre de la tabla
fLLista separada con comas de los nombres de los campos
vLLista separada con comas de los valores correspondientes
connNameNombre de la conexion
Devuelve:
Verdadero en caso de realizar la insercin con xito, falso en cualquier otro caso
QVariant FLUtil::sqlSelect ( const QString f,
const QString s,
const QString w,
const QString tL = QString::null,
int size = 0,
const QString connName = "default" 
) [static]

Ejecuta una query de tipo select, devolviendo los resultados del primer registro encontrado

Parámetros:
f,:Sentencia from de la query
s,:Sentencia select de la query, que ser el nombre del campo a devolver
w,:Sentencia where de la query
tL,:Sentencia tableslist de la query. Necesario cuando en la sentencia from se incluya ms de una tabla
size,:Nmero de lneas encontradas. (-1 si hay error)
connNameNombre de la conexion
Devuelve:
Valor resultante de la query o falso si no encuentra nada.
bool FLUtil::sqlUpdate ( const QString t,
const QString fL,
const QString vL,
const QString w,
const QString connName = "default" 
) [static]

Realiza la modificacin de uno o ms registros en una tabla mediante un objeto FLSqlCursor

Parámetros:
tNombre de la tabla
fLLista separada con comas de los nombres de los campos
vLLista separada con comas de los valores correspondientes
wSentencia where para identificar los registros a editar.
connNameNombre de la conexion
Devuelve:
Verdadero en caso de realizar la insercin con xito, falso en cualquier otro caso
static QString FLUtil::translate ( const QString contexto,
const QString s 
) [inline, static]

Traduccin de una cadena al idioma local

Se hace una llamada a la funcin tr() de la clase QObject para hacer la traduccin. Se utiliza para traducciones desde fuera de objetos QObject

Parámetros:
contextoContexto en el que se encuentra la cadena, generalmente se refiere a la clase en la que est definida
sCadena de texto a traducir
Devuelve:
Devuelve la cadena traducida al idioma local
QString FLUtil::unidades ( long  n) [static]

Enunciado de las unidades de un nmero.

Parámetros:
nNmero a tratar. Debe ser positivo
QString FLUtil::unidadesmillar ( long  n) [static]

Enunciado de las unidades de millar de un nmero.

Parámetros:
nNmero a tratar. Debe ser positivo
QString FLUtil::usha1 ( uchar data,
uint  len 
) [static]
QCString FLUtil::utf8 ( const QString s) [static]

Pasa una cadena a codificacin utf-8

Parámetros:
s,:Cadena
Devuelve:
Cadena en formato UTF-8
bool FLUtil::writeDBSettingEntry ( const QString key,
const QString value 
) [static]

Establece el valor de un setting en la tabla flsettings

Parámetros:
key.Clave identificadora del setting
Valordel setting
Devuelve:
Indicador de si la escritura del settings se realiza correctamente
bool FLUtil::writeSettingEntry ( const QString key,
const QString value 
) [static]

Establece el valor de un setting en el directorio de instalacin de AbanQ

Parámetros:
key.Clave identificadora del setting
Valordel setting
Devuelve:
Indicador de si la escritura del settings se realiza correctamente

La documentación para esta clase fue generada a partir de los siguientes ficheros:
 Todo Clases Namespaces Archivos Funciones Variables 'typedefs' Enumeraciones Valores de enumeraciones Propiedades Amigas 'defines'