In questa guida vi spiegherò come usare il y_ini.
Prima di tutto bisogna sapere che il y_ini è un sistema di gestione file simile al dini ma molto più veloce.
In questa pagina: Click trovate il download di tutti gli include di y_less, però a noi per ora servirà soltanto il y_ini.

Prima di tutto dobbiamo sapere che il y_ini, come ogni include per la gestione dei file, ha delle funzioni per salvare variabili in un file e alcune per gettare variabili da un file già esistente.



Salvare nel file una variabile, cioè un numero intero, decimale o una stringa ecc..., è il lavoro più semplice, prima dobbiamo aprire il file, poi salviamo ciò che vogliamo ed infine richiudiamo il file, la struttura è molto simile al file, quindi chi sa usare il file capirà prima come fare, esempio:



Come abbiamo visto nello script qua sopra, prima creiamo la variabile che conterrà il file, poi apriamo il file, scriviamo nel file "Esempio = Ciao" e infine chiudiamo il file

Ovviamente nei file si potranno salvare altre cose oltre le stringhe, qui sotto posto tutte le funzioni che potrete utilizzare per salvare Float, Interi, Hex, Binari, Variabili Booleane ecc...

- INI_Open(file[]); //Apre il file nel percorso indicato da "file", per poterci scrivere sopra

- INI_Close(file); //Chiude il file su cui abbiamo scritto qualcosa

- INI_WriteString(INI:file, key[], value[]);

Il INI_WriteString scrive nel file una stringa, esempio

Nel file troveremo scritto "Nome = Giovanni"

- INI_WriteInt(INI:file, key[], value);

Uguale al INI_WriteString solo che invece di scrivere una stringa scrive un numero, esempio:

Nel file troveremo Numero = 4

- INI_WriteFloat(INI:file, key[], Float:value);

Uguale al INI_WriteInt, differenzia dal fatto che invece di salvare numeri interi salva numeri decimali

- INI_WriteHex(INI:file, key[], value);

Il INI_WriteHex salva nel file un esadecimale, esempio


Scriverà nel file: Nero = 0x000000FF

- INI_WriteBin(INI:file, key[], value);

Il INI_WriteBin salva nel file un Binario, esempio:


Scriverà nel file Binario = 010101

- INI_WriteBool(INI:file, key[], value);

Il INI_WriteBool scrive nel file la condizione della variabile booleana, cioè true o false, esempio:



Scriverà nel file Registrato = false

- INI_RemoveEntry(INI:file, key[]);

Il INI_RemoveEntry elimina dal file una riga segnalata da key, esempio:



Nel file troveremo scritto: Stringa = Ciao
questo perchè prima abbiamo scritto nel file: Numero = 0, ma poi con INI_RemoveEntry l'abbiamo cancellato.

Una specialità che troviamo nel y_ini sono le tag, ovvero targhette che verranno scritte nel file, la funzione è la seguente:

- INI_SetTag(file, tag[]);

Le tag servono per ordinare le righe inserite nel file.ini, ma possono essere anche omesse, le tag si possono rivelare utili nel momento in cui carichiamo da un file.


Nel file troveremo scritto:




Dopo che il file verrà compilato e salvato, dovrà pur sempre servire a qualcosa, e qui dobbiamo gettare dal file i valori.
Col dini basta creare una variabile ed usare un = per settare il valore alla variabile, qui invece abbiamo due procedimenti, il primo lo utilizziamo quando conosciamo il nome del file.ini salvato mentre il secondo lo utilizziamo quando non sappiamo il nome del file salvato.
Il primo caso, per esempio, verrà utilizzato quando abbiamo creato un file di impostazioni per il server, il quale ha un nome già conosciuto dal momento della compilazione di pawn mentre il secondo caso può essere utilizzato per salvare gli account dei player, infatti quando compiliamo non possiamo sapere in anticipo il nome degli account del player.




Nel primo caso, cioè quando sappiamo il nome del file.ini, per caricare da un file useremo il INI_Load.
In questo caso dobbiamo creare una funzione simile a questa:


we sta ad indicare il nome del file mentre esempio è la tag setta quando abbiamo salvato il file, in questo modo leggeremo(nel file) soltanto le righe che si trovano sotto "[esempio]" e che si trovano sopra una altra targhetta

dentro questa funzione possiamo gettare dalle righe i valori molto semplicemente, esempio:

In un callback o funzione


Dove vogliamo che vengano gettati i file, io uso il main come esempio


Come possiamo vedere, INI_Load ripeterà ciò che ha c'è nella funzione INI:Percorso, però sempre sotto la tag [Info]

Nel file possiamo anche trovare più di una tag, esempio:




In Questo caso abbiamo creato due funzioni, in questo caso INI_Load avrà caricherà sia l'una che l'altra quindi se mettiamo nel main:



Printerà:

Vita = 100.0
Colore = Blu

Come avete visto nelle funzioni io ho usato per esempio:



potete anche usare le funzioni per caricare da un file, sono le seguenti:

- INI_Int(key[], dest);

Il INI_Int caricherà un valore dal file e lo attribuirà a dest, esempio:



a destination verrà dato il valore di "Numero"

- INI_String(key[], dest[], sizeof(dest));

Il INI_String caricherà una stringa dal file e la attribuirà a dest, esempio:



dest prenderà la stringa che era stata attribuita alla key "Stringa"

- INI_Bool(key[], dest);

Il INI_Bool caricherà la condizione (true o false) di key e la darà a dest

- INI_Float(key[], Float:dest);

Il INI_Float caricherà il valore decimale di key e lo darà a dest

- INI_Hex(key[], dest); | INI_Bin(key[], dest);

INI_Hex e INI_Bin caricheranno il valore esadecimale o binario di key e lo daranno a dest

In questo modo lo script sopra:



Lo trasformeremo in:



Ma non cambierà assolutamente niente.



Nel secondo caso useremo la funzione: INI_ParseFile grazie alla quale potremmo caricare da file di cui il compilatore non sa il nome come un account utente.

Prima di tutto spieghiamo cos'è il INI_ParseFile:

Il INI_ParseFile è simile al INI_Load, solo che è più avanzato e sfrutta più memoria, vediamo però cosa cambia:



quindi cambia soltanto che la funzione diventa callback, per farvi capire meglio:



Come possiamo vedere INI_ParseFile ha un parametro che INI_Load non ha, ovvero il nome della funzione da chiamare, il quale va lasciato così in questo caso




Come possiamo vedere abbiamo due file (we.ini e ciao.ini) che potrebbero caricare dalla stessa funzione, per ovviare a questo problema dobbiamo separarli tramite le Extra Data.



Le Extra data sono degli ulteriori parametri inseriti nel INI_ParseFile o nel INI_Load, esempio:


Come possiamo vedere abbiamo aggiunto bExtra = true per indicare che metto un extra il quale poi sarà idx, nella prima funzione con valore 0, nella seconda con valore 1



Infine vi spiego come creare un account utente col nome del player




Guida finita, se non avete capito qualcosa chiedete pure

Angelo lavoro fantastico. Ottima alternativa veloce rispetto al vecchissimo dini.
Se non sbaglio è anche il più veloce

Grazie mille giova
Comunque si è il sistema di gestione file più veloce dopo il mysql se non mi sbaglio

Il MySQL non è un sistema di gestione file. E' il più veloce dopo il file.inc .

Tecnicamente non so che velocità ha il mysql. Ma se il server non risiede in locale la velocità diminuisce notevolmente.

quella del mysql la sapevo, volevo dire che è molto utilizzato per creare account ecc...
quella del file non la sapevo

Beh, per quanto puoi conoscere il MySQL, l'aiuto di un include è sempre richiesto. File.inc come dice Peppinux è più veloce dell'y_ini (visto che usa funzioni del file.inc).

Magari un giorno creeranno un include autonomo... Che magari sarà più veloce del file.inc... Ma sinceramente, la velocità è già buona .

Ci sono dei plugin che sono più veloci del file.inc

Sì tipo il File Manager di Ryder.

Boh che ne so... qua ne sfoderano una ogni 5 secondi questi due pazzi ._.

Comunque credo che già la velocità del file.inc basti ed avanzi.

Non ho ancora capito una cosa... Se io devo gettare un parametro dentro un file, posso usare solo INI_Int (ecc...) senza inserire INI_Load oppure INI_ParseFile?

Se conosci il nome del file da cui gettare allora usi INI_Load altrimenti INI_ParseFile

Si, ma non capisco... Non posso fare come il Dini? Cioè:



Con Y_Ini non posso fare in questo modo?

Ma il INI_Open serve per salvare nel file

Ok adesso ho capito... Però ho ancora dei dubbi riguardo l'INI_ParseFile, ovvero: tu, nell'esempio del login, hai inserito un "User_%s". Perché hai messo questo "_%s"?

User_%s sta ad indicare la funzione User_Info, ovvero la funzione dove possiamo caricare i dati del player tramite le funzioni, non so se funziona anche se metti User_Info al posto di User_%s

Ok... Un'ultima cosa: perché si inserisce %s?

Bhe potrebbero essererci più funzioni, tipo:



Così puoi usare uno dei due, per usare quello che vuoi usi appunto le extra data

Ok credo di aver capito...

Io non capisco bene l'INI_ParseFile, Me lo puoi spiegare meglio?