Functions > FileDirDisk >

IniRead

Lit une valeur dans un fichier .ini au format standard.

IniRead ( "filename", "section", "key", "default" )

Param�tres

filename Le nom complet du fichier .ini
section Le nom de la section dans le fichier .ini
key Le nom de la cl� dans le fichier .ini
default La valeur de retour par d�faut si la cl� demand�e n'est pas trouv�e.

Valeur de retour

Succ�s: Retourne la valeur de la cl� demand�e dans une cha�ne.
�chec: Retourne la valeur par d�faut si la cl� demand�e n'est pas trouv�e.

Remarque

Un fichier .ini standard ressemble � :

[Nom_Section]
Cl�=Valeur



Toutes les valeurs retourn�es sont convertis sous forme de cha�ne. Par cons�quent, si vous souhaitez qu'un 'integer', par exemple 1000, soit un nombre, utilisez Int() ou Number(), tout comme si vous voulez qu'un hwnd soit un ptr, utilisez Ptr() ou HWnd().

En relation

FileReadLine, IniDelete, IniReadSection, IniReadSectionNames, IniRenameSection, IniWrite, IniWriteSection

Exemple

#include <MsgBoxConstants.au3>
#include <WinAPIFiles.au3>

Example()

Func Example()
    ; Cr�e une constante locale avec le nom complet du fichier qui sera lu/�crit
    Local Const $sFilePath = _WinAPI_GetTempFileName(@TempDir)

    ; Ecrit la valeur de 'AutoIt' � la cl� "Title" et dans la section "General".
    IniWrite($sFilePath, "General", "Title", "AutoIt")

    ; Lit la valeur correspondante � la cl� 'Title' dans la section 'General'.
    Local $sRead = IniRead($sFilePath, "General", "Title", "Default Value")

    ; Affiche la valeur retourn�e par IniRead.
    MsgBox($MB_SYSTEMMODAL, "", "La valeur correspondante � la cl� 'Title' dans la section  'General' est: " & $sRead)

    ; Supprime la cl� 'Title'.
    IniDelete($sFilePath, "General", "Title")

    ; Lit le fichier INI pour la valeur de 'Title' dans la section 'General'.
    $sRead = IniRead($sFilePath, "General", "Title", "Default Value")

    ; Affiche la valeur retourn�e par IniRead. Comme il n'y a pas de cl� stock� la valeur sera la 'Valeur par d�faut' pass�e � IniRead.
    MsgBox($MB_SYSTEMMODAL, "", "La valeur correspondante � la cl� 'Title' dans la section  'General' est: : " & $sRead)

    ; Supprime le fichier INI.
    FileDelete($sFilePath)
EndFunc   ;==>Example