@INIWRITE[file,section,entry,string]:  Crée, met à jour ou supprime une entrée dans le fichier spécifié .  Si le fichier n'existe pas, il sera créé. @INIWRITE renvoie 0 en cas de succès ou -1 en cas d'échec.

 

Le fichier, la section et l'entrée doivent être placés entre guillemets s'ils contiennent des espaces blancs ou des caractères spéciaux.

 

Sélection des fichiers

 

Le nom et l'extension du fichier doivent être spécifiés. Cette fonction n'applique pas d'extension par défaut. Si le fichier n'inclut pas explicitement un chemin d'accès, @INIWRITE utilise %Windir, le  répertoire d'installation de Windows. Pour utiliser le répertoire actuel, vous devez le spécifier explicitement, par exemple en utilisant .\ comme chemin d'accès.

 

Action

 

Si lefichier n'existe pas, il sera créé. Si la chaîne est vide, le fichier sera vide, sinon une ligne de section et une ligne de directive seront créées.

 

Les autres descriptions concernent le cas où le fichier existe.

 

S'il  existe plus d'une correspondance pour la section dans le fichier, seule la première est recherchée pour l'entrée. S'il existe plus d'une correspondance pour la section et l'entrée , seule la première correspondance est prise en compte. La recherche commence au début du fichier et s'arrête à la première correspondance.

 

Si lachaîne est vide, l'entrée correspondante , le cas échéant, est supprimée. Si la chaîne n'est pas vide et qu'il existe une section et une entrée correspondantes , celles-ci sont modifiées. Si la chaîne n'est pas vide et qu'il n'y a pas de section et d'entrée correspondantes, elle est créée.

 

Si l'entrée est vide, la section correspondante  (le cas échéant) est supprimée.

 

Exemples d'application

 

echo %@iniwrite[c:\tcmd\tcmd.ini,TakeCommand,history,8192]

 

fixe la taille de l'historique des commandes à 8 192 octets.

 

echo %@iniwrite[c:\tcmd\tcmd.ini,TakeCommand,history,]

 

supprimera l' entrée de l'historique du fichier.