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 m�todos, herramientas y utiles necesarios para ciertas operaciones.

Es esta clase se encontrar�n m�todos gen�ricos que realizan operaciones muy espec�ficas pero que son necesarios para ciertos procesos habituales en las distintas tareas a desempe�ar en la gesti�n 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:

d	Fecha con la que operar
nd	Numero 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:

d	Fecha con la que operar
nm	Numero 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 a�os a una fecha.

Parámetros:

d	Fecha con la que operar
nm	Numero de a�os que sumar. Si es negativo resta a�os

Devuelve:

Fecha con el desplazamiento de a�os

QString FLUtil::buildNumber	(	const QVariant &	v,
		char	tipo,
		int	partDecimal
	)		[static]

Construye un string a partir de un n�mero, especificando el formato y precisi�n

Parámetros:

v.	N�mero a convertir a QString
tipo.	Formato del n�mero
partDecimal.	Precisi�n (n�mero de cifras decimales) del n�mero

Devuelve:

Cadena que contiene el n�mero formateado

QChar FLUtil::calcularDC

(

const QString &

n

)

[static]

Obtiene el n�mero del digito de control, para cuentas bancarias.

Los n�meros de las cuentas corrientes se organizan de la forma siguiente:

4 Digitos----->C�digo del banco � (ej. 0136 Banco Arabe espa�ol) 4 Digitos----->C�digo de la oficina 1 Digito de control------>de los 8 primeros digitos 1 Digito de control------>del n�mero de cuenta (de los 10 ultimos digitos) 10 Digitos del n�mero de la cuenta

Para comprobar el numero de cuenta se pasa primero los 8 primeros digitos obteniendo asi el primer digito de control, despu�s se pasan los 10 digitos del n�mero de la cuenta obteniendo el segundo digito de control.

Parámetros:

n	N�mero del que se debe obtener el d�gito de control

Devuelve:

Caracter con el d�gito de control asociado al n�mero dado

QString FLUtil::centenamillar

(

long

n

)

[static]

Enunciado de las centenas de millar de un n�mero.

Parámetros:

n	N�mero a tratar. Debe ser positivo

QString FLUtil::centenas

(

long

n

)

[static]

Enunciado de las centenas de un n�mero.

Parámetros:

n	N�mero a tratar. Debe ser positivo

void FLUtil::createProgressDialog	(	const QString &	l,
		int	tS,
		const QString &	id = "default"
	)		[static]

Crea un di�logo de progreso

Parámetros:

l	Label del di�logo
tS	N�mero 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:

f	Cadena 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:

f	Cadena 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:

d1	Fecha de partida
d2	Fecha de destino

Devuelve:

N�mero de d�as entre d1 y d2. Ser� negativo si d2 es anterior a d1.

QString FLUtil::decenas

(

long

n

)

[static]

Enunciado de las decenas de un n�mero.

Parámetros:

n	N�mero a tratar. Debe ser positivo

QString FLUtil::decenasmillar

(

long

n

)

[static]

Enunciado de las decenas de millar de un n�mero.

Parámetros:

n	N�mero a tratar. Debe ser positivo

void FLUtil::destroyProgressDialog

(

const QString &

id = "default"

)

[static]

Destruye el di�logo 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:

doc	Documento DOM a establecer
content	Contenido XML

Devuelve:

FALSE si hubo fallo, TRUE en caso contrario

QString FLUtil::enLetra

(

long

n

)

[static]

Obtiene la expresi�n en texto de como se enuncia un n�mero, en castellano.

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

Parámetros:

n	N�mero a transladar a su forma hablada. Debe ser positivo

Devuelve:

Cadena de texto con su expresi�n hablada

QString FLUtil::enLetraMoneda	(	double	n,
		const QString &	m
	)		[static]

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

Dado un n�mero doble, devuelve su expresi�n en texto de como se enuncia de forma hablada en la moneda indicada; por ejemplo dado el n�mero 130.25, devolver� la cadena de texto "ciento treinta 'moneda' con veinticinco c�ntimos".

Parámetros:

n	N�mero a transladar a su forma hablada. Debe ser positivo
m	Nombre de la moneda

Devuelve:

Cadena de texto con su expresi�n hablada

QString FLUtil::enLetraMonedaEuro

(

double

n

)

[static]

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

Dado un n�mero doble, devuelve su expresi�n en texto de como se enuncia de forma hablada en euros; por ejemplo dado el n�mero 130.25, devolver� la cadena de texto "ciento treinta euros con veinticinco c�ntimos".

Parámetros:

n	N�mero a transladar a su forma hablada. Debe ser positivo

Devuelve:

Cadena de texto con su expresi�n 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 seg�n el patr�n 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:

paths	Rutas de b�squeda
filter	Patr�n de filtrado para los ficheros. Admite varios separados por espacios "*.gif *.png". Por defecto todos, "*"
breakOnFirstMatch	Si es TRUE al encontrar el primer fichero que cumpla el patr�n indicado, termina la b�squeda 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:

fltype

Tipo de datos de AbanQ.

Devuelve:

Tipo de datos QVariant.

QString FLUtil::formatoMiles

(

const QString &

s

)

[static]

Formatea una cadena de texto poni�ndole separadores de miles.

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

Parámetros:

s	Cadena 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 c�digo de idioma del sistema

Devuelve:

C�digo de idioma del sistema

QString FLUtil::getOS

(

)

[static]

Devuelve el sistema operativo sobre el que se ejecuta el programa

Devuelve:

C�digo del sistema operativo (WIN32, LINUX, MACX)

bool FLUtil::isFLDefFile

(

const QString &

head

)

[static]

Para comprobar si la cabecera de un fichero de definici�n corresponde con las soportadas por AbanQ.

Este m�todo no sirve para los scripts, s�lo para los ficheros de definici�n; mtd, ui, qry, xml, ts y kut.

Parámetros:

head	Cadena de caracteres con la cabecera del fichero, bastar�a con las tres o cuatro primeras linea del fichero no vac�as

Devuelve:

TRUE si es un fichero soportado, FALSE en caso contrario

QChar FLUtil::letraDni

(

long

n

)

[static]

Obtiene la letra asociada al n�mero del D.N.I. espa�ol.

Parámetros:

n	Numero de D.N.I

Devuelve:

Caracter asociado al n�emro 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 m�s aconsejable es que el tipo del campo sea 'String' porque as� se le puede dar formato y ser usado para generar un c�digo de barras. De todas formas la funci�n soporta tanto que el campo sea de tipo 'String' como de tipo 'double'.

Parámetros:

name	Nombre del campo
cursor_	Cursor a la tabla donde se encuentra el campo.

Devuelve:

Qvariant con el numero siguiente.

Autor:

Andr�s Ot�n 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 numeraci�n 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:

nivel	Indica la profundidad a la que se hace el incremento.
secuencia	Estructura de la secuencia.
ultimo	Ultimo valor de la secuencia para poder dar el siguiente valor.

Devuelve:

La secuencia en el formato facilitado.

Autor:

Andr�s Ot�n 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 n�mero 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:

num	Cadena 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 n�mero.

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

Parámetros:

n	N�mero del que obtener la parte decimal. Debe ser positivo

Devuelve:

La parte decimal del n�mero, que puede ser cero

Q_ULLONG FLUtil::partInteger

(

double

n

)

[static]

Obtiene la parte entera de un n�mero.

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

Parámetros:

n	N�mero del que obtener la parte entera. Debe ser positivo

Devuelve:

La parte entera del n�mero, que puede ser cero

bool FLUtil::quickSqlDelete	(	const QString &	t,
		const QString &	w,
		const QString &	connName = "default"
	)		[static]

Versi�n r�pida de sqlDelete. Ejecuta directamente la consulta sin realizar comprobaciones y sin disparar se�ales de commits. Usar con precauci�n.

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

Versi�n r�pida de sqlSelect. Ejecuta directamente la consulta sin realizar comprobaciones. Usar con precauci�n.

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 instalaci�n 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 funci�n de la precisi�n especificada para un campo tipo double de la base de datos

Parámetros:

n.	N�mero a redondear
table.	Nombre de la tabla
field.	Nombre del campo

Devuelve:

N�mero redondeado

void FLUtil::saveIconFile	(	const QString &	data,
		const QString &	pathFile
	)		[static]

Guarda la imagen de icono de un bot�n de un formulario en un ficher png. Utilizado para documentaci�n

Parámetros:

data	Contenido de la imagen en una cadena de caracteres
pathFile	Ruta 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:

n	Nombre del fichero que contiene la descricpci�n del formulario.
pathFile	Ruta y nombre del fichero donde guardar la imagen

QString FLUtil::serialLettertoNumber

(

const QString &

letter

)

[static]

Esta funci�n convierte una cadena que es una serie de letras en su correspondiente valor numerico.

Parámetros:

letter

Cadena con la serie.

Devuelve:

Una cadena pero que contiene numeros.

QString FLUtil::serialNumbertoLetter

(

int

number

)

[static]

Esta funci�n convierte un numero a su correspondiente secuencia de Letras.

Parámetros:

number

N�mero a convertir

void FLUtil::setLabelText	(	const QString &	l,
		const QString &	id = "default"
	)		[static]

Cambia el texto de la etiqueta del di�logo

Parámetros:

l

Etiqueta

void FLUtil::setProgress	(	int	p,
		const QString &	id = "default"
	)		[static]

Establece el grado de progreso del di�logo

Parámetros:

p	Grado de progreso

void FLUtil::setTotalSteps	(	int	tS,
		const QString &	id = "default"
	)		[static]

Establece el n�mero total de pasos del di�logo

Parámetros:

ts	N�mero total de pasos

QString FLUtil::sha1

(

const QString &

str

)

[static]

Obtiene la clave SHA1 de una cadena de texto.

Parámetros:

str	Cadena 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:

n	Nombre del fichero que contiene la descricpci�n del formulario.

bool FLUtil::sqlDelete	(	const QString &	t,
		const QString &	w,
		const QString &	connName = "default"
	)		[static]

Borra uno o m�s registros en una tabla mediante un objeto FLSqlCursor

Parámetros:

t	Nombre de la tabla
w	Sentencia where para identificar los registros a borrar.
connName	Nombre de la conexion

Devuelve:

Verdadero en caso de realizar la inserci�n 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 inserci�n de un registro en una tabla mediante un objeto FLSqlCursor

Parámetros:

t	Nombre de la tabla
fL	Lista separada con comas de los nombres de los campos
vL	Lista separada con comas de los valores correspondientes
connName	Nombre de la conexion

Devuelve:

Verdadero en caso de realizar la inserci�n 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 m�s de una tabla
size,:	N�mero de l�neas encontradas. (-1 si hay error)
connName	Nombre 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 modificaci�n de uno o m�s registros en una tabla mediante un objeto FLSqlCursor

Parámetros:

t	Nombre de la tabla
fL	Lista separada con comas de los nombres de los campos
vL	Lista separada con comas de los valores correspondientes
w	Sentencia where para identificar los registros a editar.
connName	Nombre de la conexion

Devuelve:

Verdadero en caso de realizar la inserci�n con �xito, falso en cualquier otro caso

static QString FLUtil::translate	(	const QString &	contexto,
		const QString &	s
	)		[inline, static]

Traducci�n de una cadena al idioma local

Se hace una llamada a la funci�n tr() de la clase QObject para hacer la traducci�n. Se utiliza para traducciones desde fuera de objetos QObject

Parámetros:

contexto	Contexto en el que se encuentra la cadena, generalmente se refiere a la clase en la que est� definida
s	Cadena de texto a traducir

Devuelve:

Devuelve la cadena traducida al idioma local

QString FLUtil::unidades

(

long

n

)

[static]

Enunciado de las unidades de un n�mero.

Parámetros:

n	N�mero a tratar. Debe ser positivo

QString FLUtil::unidadesmillar

(

long

n

)

[static]

Enunciado de las unidades de millar de un n�mero.

Parámetros:

n	N�mero a tratar. Debe ser positivo

QString FLUtil::usha1	(	uchar *	data,
		uint	len
	)		[static]

QCString FLUtil::utf8

(

const QString &

s

)

[static]

Pasa una cadena a codificaci�n 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
Valor	del 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 instalaci�n de AbanQ

Parámetros:

key.	Clave identificadora del setting
Valor	del 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:

• src/flbase/FLUtil.h
• src/flbase/FLUtil.cpp