Using INI Files/es: what changed

Revision 1 to 2. Removed lines have a minus sign; added lines have a plus sign.

Old	New		Line
1	1		## Archivos INI
2	2
3	3		### Información Básica
4	4
5	5		Los archivos INI se pueden utilizar para guardar la configuración básica del usuario con facilidad. Con la unidadINIfiles y la clase TINIFile puedes trabajar fácilmente con los archivos INI. Esta unidad forma parte de la FCL.
6	6
7	7		### Archivos INI
8	8
9	9		Los archivos INI utilizan corchetes para incluir secciones. En estas secciones se encuentran las claves y los valores de las claves.
10	10
11	11		La clave y su valor están separados mediante el símbolo (=) .
12	12
13	13		Los nombres de sección se escriben entre corchetes (\[UnaSeccion\]).
14	14
15	15		En los archivos INI, se permiten los comentarios y deben estar marcados por punto y coma (;) al inicio de la línea. Como no hay un estándar definido, se permiten otros caracteres como (#).
16	16
17	17		En estos días, los archivos INI no son tan populares como los archivos XML, debido a que no manejan muy bien grandes cadenas de texto, sin embargo, archivos similares a los INI, son usados comunmente en configuraciones Linux/Unix.
18	18
19	19		Un ejemplo de archivo INI:
20	20
21	21		``` ini
22	22		; Comment. Beginning of INI file
23	23
24	24		; empty lines are ignored
25	25
26	26		; note that no section has been defined.
27	27		Compiler=Delphi
28	28		; Key: Compiler
29	29		; Value: Delphi
30	30
31	31		[General]
32	32		; This starts a General section
33	33		Compiler=FreePascal
34	34		; Key Compiler and value FreePascal
35	35		```
36	36
37	37		### Ejemplo
38	38
39	39		Crearemos una sencilla aplicación de consola. Lo primero que hará es crear un archivo INI y llamado DB.ini y lo pondrá en el directorio de la aplicación. Contendrá una sección llamada INIDB, y las claves y valores siguientes:
40	40
41		-	~~` Autor=Adam`\~~
42		-	~~` Contrasenya=`\~~
43		-	~~` ArchivoDB=Dinero.dat`~~
	41	+	```text
	42	+	Autor=Adam
	43	+	Contrasenya=
	44	+	ArchivoDB=Dinero.dat
	45	+	```
44	46
45	47		Veremos ahora el código:
46	48
47	49		``` pascal
48	50		Program Proyecto1;
49	51		{$mode objfpc}{$H+}
50	52		Uses
51	53		Classes,SysUtils,INIFiles;
52	54		Var
53	55		INI:TINIFile;
54	56		Autor,Contrasenya,ArchivoDB:String;
55	57		DameContrasenya:String;
56	58		begin
57	59		INI := TINIFile.Create('DB.ini');
58	60		Autor := INI.ReadString('INIdb','Autor','');
59	61		Contrasenya := INI.ReadString('INIdb','Contrasenya','');
60	62		ArchivoDB := INI.ReadString('INIdb','ArchivoDB','');
61	63		if Contrasenya <> '' then
62	64		begin
63	65		Writeln('Contraseña Requerida');
64	66		Repeat
65	67		Readln(DameContrasenya);
66	68		if not DameContrasenya = Contrasenya then Writeln('Contraseña no válida');
67	69		until(DameContrasenya = Contrasenya);
68	70		Writeln('Contraseña correcta');
69	71		end;
70	72		Writeln('Autor : '+ Autor);
71	73		Writeln('Archivo : '+ ArchivoDB);
72	74		Writeln('Contraseña : '+ Contrasenya);
73	75		Readln;
74	76		end.
75	77		```
76	78
77	79		### Lectura de archivos INI
78	80
79	81		Para la lectura de los valores de los archivos INI, existen funciones específicas, de acuerdo al tipo de datos: ReadString, ReadBool, ReadInteger, ReadDate o ReadDateTime.
80	82
81	83		Cada una de estas funciones devolverá, el tipo de datos correspondiente. Así por ejemplo 'ReadBool' devolverá valores 'boolean', y 'ReadString' devolverá un string.
82	84
83	85		La lectura, se hace invocando a la función necesaria, y asignando el valor a una variable:
84	86
85		-	~~`Cadena := INIdb.ReadString('Nombre de Sección','Clave','valor por defecto');`~~
	87	+	``` pascal
	88	+	Cadena := INIdb.ReadString('Nombre de Sección','Clave','valor por defecto');
	89	+	```
86	90
87	91		El último parámetro, es el valor que se debe devolver, en caso de que la clave solicitada no exista en el archivo INI.
88	92
89	93		Para leer una seción completa, se puede usar el método ReadSection. En este caso, se le debe pasar una lista de cadenas, como parámetro de salida.
90	94
91	95		También puede resultar conveniente verificar si una sección existe. Para ello, se debe usar la función SectionExists.
92	96
93	97		### Operaciones adicionales
94	98
95	99		En la clase TINIFile hay diferentes propiedades, procedimientos y funciones que se pueden utilizar.
96	100
97	101		- CaseSensitive - Esta característica le permite determinar si las claves y secciones distinguen entre mayúsculas y minúsculas o no, por omisión no hay distinción.
98	102		- ReadString - Tiene tres parámetros constantes, el primero es la sección en la que buscar, el segundo es la clave buscada. El tercero es una cadena con el valor por omisión en caso de no encontrar la clave o la sección buscadas.
99	103		- WriteString tiene también tres parámetros. El primero es la sección. El segundo es la clave y el último es el valor. Si la clave y la sección que ya existen la clave será escrita con el nuevo valor.
100	104		- ReadSections - Permite obtener las secciones del archivo INI y las deposita en una clase TStrings (o TStringList usando la cláusula AS)
101	105		- DeleteKey - Eliminar una clave existente de una sección específica.
102	106		- EraseSection - Elimina una sección y todos los datos que contiene.
103	107
104	108		Hay más procedimientos y funciones, pero esto es lo básico.
105	109
106	110		### Palabra finales...
107	111
108	112		Aquí [1](http://lazarus-ccr.sourceforge.net/docs/fcl/inifiles/index.html) se puede conocer todo acerca de los archivos INI... Por favor, si tienes más información acerca de los archivos INI en Pascal. 'Modificar a voluntad.'
109	113
110	114		## Ver también
111	115
112	116		- [[XML Tutorial/es\|Tutoría XML]]
113	117
114	118		---
115	119		From the Free Pascal wiki, page "Using INI Files/es", as it stood on 2020-03-04 after a change by Trev, out of the wiki's dump of 2024-05-26. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).

Back to history