Aide:IniWrite.txt

Document original V3.3.6.1 :

###Function###
IniWrite

###Description###
Writes a value to a standard format .ini file.

###Syntax###
IniWrite ( "filename", "section", "key", "value" )


###Parameters###
@@ParamTable@@
filename
	The filename of the .ini file.
section
	The section name in the .ini file.
key
	The key name in the in the .ini file.
value
	The value to write/change.
@@End@@


###ReturnValue###
@@ReturnTable@@
Success:	Returns 1.
Failure:	Returns 0 if file is read-only.
@@End@@


###Remarks###
A standard ini file looks like:
<i>[SectionName]
Key=Value</i>
If file does not exist, it is created. Any directories that do not exist, will not be created. Keys and/or sections are added to the end and are not sorted in any way."?
When writing a value that is quoted, the quotes are stripped.  In order to write the quote marks to the value, you must double up the quoting.  For example: ""This is a test"" will produce "This is a test" in the file.
Leading and trailing whitespace is stripped.  In order to preserve the whitespace, the string must be quoted.  For example, "    this is a test" will preserve the whitespace but per above, the quotation marks are stripped.
Multi-line values are not possible.

###Related###
IniDelete, IniRead, IniReadSection, IniReadSectionNames, IniWriteSection, IniRenameSection


###Example###
@@IncludeExample@@

Document traduit V3.3.6.1 :

###Function###
IniWrite

###Description###
Écrit une valeur dans un fichier .ini de format standard


###Syntax###
IniWrite ( "filename", "section", "key", "value" )


###Parameters###
@@ParamTable@@
filename
	Le nom du fichier .ini.
section
	Le nom de la section dans le fichier .ini.
key
	Le nom de la clé dans le fichier .ini.
value
	La valeur à écrire/changer.
@@End@@


###ReturnValue###
@@ReturnTable@@
Succès:	Retourne 1.
Échec:	Retourne 0 si le fichier est en lecture seule.
@@End@@


###Remarks###
Un fichier .ini standard ressemble à :
<i>[NomdelaSection]
clé=Valeur</i>
Si le fichier n'existe pas, il est créé. Les dossiers qui n'existent pas, ne seront pas créés. Les clés et/ou sections sont ajoutées à la fin et ne sont pas triées.
Lorsque vous écrivez une valeur qui est entre guillemets, les guillemets sont supprimés. Pour pouvoir écrire des guillemets dans la valeur, vous devez mettre des doubles guillemets entouré par des simple guillemets. Par exemple : '"Ceci est un test"' va produire "Ceci est un test" dans le fichier.
Les espaces de début et de fin sont supprimés. Pour conserver les espaces, la chaîne de caractère doit être entre guillemets. Par exemple, "     ceci est un test" préservera les espaces, mais comme vu plus haut les guillemets seront supprimés.
Une valeur sur plusieurs lignes n'est pas possible.


###Related###
<a href="IniDelete.htm">IniDelete</a>, <a href="IniRead.htm">IniRead</a>, <a href="IniReadSection.htm">IniReadSection</a>, <a href="IniReadSectionNames.htm">IniReadSectionNames</a>, <a href="IniRenameSection.htm">IniRenameSection</a>, <a href="IniWriteSection.htm">IniWriteSection</a>


###Example###
@@IncludeExample@@

Traducteur : cramaboule

Contributeurs (pour les modifications avant le Wiki) : Tlem