Using INI Files/fi: what changed

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

Old	New		Line
1	1		## Ini-tiedostot
2	2
3	3		### Johdanto
4	4
5	5		INI-tiedostot ovat ns tekstitiedostoja johon tallennetaan nimi=arvo pareja.
6	6
7	7		INI-tiedostoa voidaan käyttää tallentamaan käyttäjän asetukset helposti. Käytämällä INIfiles käännösyksikköä (unit) ja TINIFile luokkaa voidaan työskennellä helposti INI-tiedostojen kanssa. Tämä käännösyksikkö (unit) kuuluu FCL:n. Currently only INI files compliant with the \[<http://en.wikipedia.org/wiki/INI_file>\\| Microsoft standard\] are supported, so using \[<http://en.wikipedia.org/wiki/INI_file#Sections>\\| sections\] is obligatory.
8	8
9		-	~~`Tällä hetkellä vain INI-tiedostot noudattaen `[`standardin`](http://en.wikipedia.org/wiki/INI_file%7CMicrosoftin)` tuetaan, joten käyttämällä kohdat on pakollista.`~~
	9	+	```text
	10	+	Tällä hetkellä vain INI-tiedostot noudattaen standardin tuetaan, joten käyttämällä kohdat on pakollista.
	11	+	```
10	12
11	13		### INI-tiedostot
12	14
13	15		INI tiedostoissa käytetään sulkuja luomaan osioita (Sections), joka sisältää avaimet ja avaimen arvot. Avain ja sitä vastaava arvo erotetaan yhtäsuuruusmerkillä ( avain = arvo ).
14	16
15	17		Osioiden nimet laitetaan hakasulkeiden sisään (\[Osio\]).
16	18
17	19		Kommentit ovat yleensä sallittua ja on merkitty puolipisteellä (;) rivin alussa. Koska INI-tiedostot eivät ole täysin standardoituja, muita merkkejä käytetään myös, kuten \#
18	20
19	21		Nykyään XML-tiedostoja käytetään usein merkkijono varastointiin INI-tiedostojen sijasta, koska INI-tiedostot eivät tue suuria merkkijonoja hyvin. Kuitenkin INI-tiedostoa voi käyttää myös Linuxin / Unix-asetuksissa.
20	22
21	23		Esimerkki INI-tiedosto:
22	24
23	25		``` ini
24	26		; Kommentti. INI-tiedoston alku
25	27
26	28		; Tyhjät rivit ohitetaan
27	29
28	30		; Huomaa tähän ei ole osiota määritelty.
29	31		Compiler=Delphi
30	32		; Avain: Compiler
31	33		; Arvo: Delphi
32	34
33	35		[General]
34	36		; Tämä aloittaa General osion
35	37		Compiler=FreePascal
36	38		; Avain Compiler ja arvo FreePascal
37	39		```
38	40
39	41		### Ini tiedoston lukemisen esimerkki
40	42
41	43		Alla oleva konsoli (komentorivi) sovellus näyttää kuinka luetaan ini tiedostoja. Testateksi sitä joudut luomaan seuraavanlaisen ini tiedoston joka on nimeltään "C:\DB.ini".
42	44
43	45		Editoi se niin että se sisältää osio nimeltä INIDB ja seuraavia avaimet ja arvot:
44	46
45	47		``` ini
46	48		[INIDB]
47	49		; Save as C:\DB.ini
48	50		Author=Adam
49	51		Pass=
50	52		DBFile=C:\Money.dat
51	53		```
52	54
53	55		Nyt siirrytään koodiin.
54	56
55	57		``` pascal
56	58		Program IniSample;
57	59
58	60		{$mode objfpc}{$H+}
59	61
60	62		Uses
61	63		Classes,SysUtils,INIFiles;
62	64
63	65		Var
64	66		INI:TINIFile;
65	67		Author,Pass,DBFile:String;
66	68		PassEnter:String;
67	69
68	70		begin
69	71		// Luodaan olio, täsmennetään sitä niin että se löytää ini-tiedoston:
70	72		INI := TINIFile.Create('C:\DB.ini');
71	73		// Luetaan merkkijono (string) INI-tiedostosta.
72	74		// Voidaan myös lukea boolean tyyppistä tietoa jne.
73	75		Author := INI.ReadString('INIDB','Author','');
74	76		Pass := INI.ReadString('INIDB','Pass','');
75	77		DBFile := INI.ReadString('INIDB','DBFile','');
76	78		if Pass <> '' then
77	79		begin
78	80		Writeln('Password Required');
79	81		Repeat
80	82		Readln(PassEnter);
81	83		if not (PassEnter = Pass) then Writeln('Wrong Password');
82	84		until(PassEnter = Pass);
83	85		Writeln('Correct Password');
84	86		end;
85	87		Writeln('Author : '+Author);
86	88		Writeln('File : '+DBFile);
87	89		Writeln('Password : '+Pass);
88	90		Readln;
89	91		// Käytön lopuksi täytyy kutsua olion Free metodia
90	92		// ... Vaikka tämä olisi kääritty try..finally lohkoon
91	93		// niin kohde vapautuu, riippumatta mahdollisista virheistä
92	94		Ini.Free;
93	95		end.
94	96		```
95	97
96	98		### Luokan perustietoa
97	99
98	100		TINIFile luokassa on monia erilaisia ominaisuuksia, ja toimintoja, joita voidaan käyttää.
99	101
100	102		CaseSensitive - Tämän ominaisuuden avulla voit määritellä eroavatko avaimet ja osiot silloin kun kirjaimet ovat isoja tai pieniäi. Oletusarvoisesti ne eivät eroa.
101	103
102	104		ReadString - Tällä on kolme arvoa. Esimmäinen kertoo mistä osiosta etsitään. Toinen kertoo avaimen. Kolmas on oletusarvo siihen tapaukseen missä avain ja / tai osio kohta ei löytynyt.
103	105
104	106		WriteString - Tällä on myös kolme arvoa. Esimmäinen kertoo osion. Toinen kertoo avaimen ja kolmas on arvo jotka kaikki tallennetaan. Jos avain ja osio on jo olemassa niin avain korvataan uudella arvolla.
105	107
106	108		ReadSections - Madollisttaa ottamaan osioita INI-tiedostosta ja laittaa ne TStrings luokkaan (tai TStringList:n AS operatorilla).
107	109
108	110		DeleteKey - Poistaa olemassa olevan avaimen tietyssä osiossa.
109	111
110	112		EraseSection - Poistaa osion ja kaikki sen tiedot.
111	113
112	114		On olemassa enemmän toimintoja, mutta tämä on tarpeeksi jotta pääset alkuun.
113	115
114	116		### Dokumentaatio
115	117
116	118		[Free Pascal documentation on INI files](http://lazarus-ccr.sourceforge.net/docs/fcl/inifiles/index.html)
117	119
118	120		## Katso myös
119	121
120	122		- [[HistoryFiles]]
121	123		- [[XML Tutorial]]
122	124
123	125		---
124	126		From the Free Pascal wiki, page "Using INI Files/fi", 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