Proyectos : GP2X / GP32

libReadINI - reads your INI files!!
lunes, 15 de enero de 2007 a las 17:59
Leido: 992 veces | Última Actualización: 01 de diciembre de 2007

Español

See the english version of this text below

LibReadINI es librería que lee ficheros INI, hecha completamente en C, lo que permite ser usada en proyectos de GP32 sin problemas Smiley: Muy contento! Aunque evidentemente puede ser usada en cualquier otra plataforma que soporte C, como proyectos para programas en MSDOS u otros pequeños sistemas embebidos.

No tiene dependencias externas de SDL, libxml o similares, como la librería "oficial" de lectura de INIs que por ejemplo se usa en GP2X. Y lo mejor pesa muy poquito -unos 6kb- y es bastante rápida, aunque seguro que se podría mejorar, así comparte tus mejoras Smiley: guiño

La librería lee dos tipos de ficheros INI tipo, M$ (los que todos conocemos), o tipo "conf" de linux.

Un fichero INI podría ser algo como esto:

[General]
    name = Junk Config File Test
    version = 2

[Mode]
    StrictMode = yes
    useflags = no
    phase = 5

[OtherSection]
    name = Hello

[AnotherSection]
    name = Bye

Ejemplo Práctico

Su uso es muy simple:
- Primero abrimos el fichero, que podría ser algo como:

    if(!cfgOpen("./configs/ejemplo.ini", MS_STYLE))
    {
       //no encontre el fichero
    }else
    {
        //fichero leido!
    }

- Una vez abierto, hay que elegir una sección que la librería se encargara de buscar. Para seleccionar una sección seria:

    if(cfgSelectSection("General"))
    {
        //haz lo que sea...
    }else
    {
        //pues se ve que no la encontro!!! xD
    }

- Una vez seleccionada se pueden pedir datos de la misma usando funciones para cadenas, números y booleanos... unos ejemplos finales:

        currentVersion = (Uint8) cfgReadInt("version", 1);

Ex: Lee la variable versión del fichero INI y la almacena en nuestra variable, currentVersion.
(El numero del final es un valor por defecto, por si no lo encuentra, etc.)

Finalmente cuando hemos terminado de trastearla debemos hacer, simplemente:

    cfgClose();

La ventaja de usar ficheros INI es que puede hacer cambios en las configuraciones de sus programas y ver los cambios sin que se requiera una nueva compilación. Y si luego lo necesita siempre podría encapsular todo el código "INI" en un fichero binario... Smiley: guiño

Para acceder a más ejemplos vea la documentación de la libreria

English

LibReadINI is a library to read INI files, developed in C code.

Now you can read your game/program INI files on your GP32 and other embeddeds platforms that can run a C code!! Smiley: Muy contento!

Dont have any external dependencies (SDL, libxml, etc...)
Little -6kb- and quick code, but if you can make a better code, share your changes Smiley: guiño

Examples and more info on the library`s documentation