Format de fichier de paramètres de configuration Windows

Les fichiers de paramètres de configuration Windows sont des fichiers texte divisés en sections nommées. Des parenthèses entourent chaque nom de section. Chaque section porte un nom différent. Les sections contiennent des paires clé/valeur séparées par un signe égal (=). Les noms situés à l'intérieur de chaque section sont tous différents. Le nom de clé représente une préférence de configuration, et le nom de valeur représente le paramètre de cette préférence. L'exemple suivant illustre l'organisation du fichier :

[Section 1]

key1=value

key2=value

[Section 2]

key1=value

key2=value

Utilisez les types de données suivants pour la partie qui concerne la valeur du paramètre clé dans les VIs de fichiers de configuration :

• Chaîne
• Chemin
• Booléen
• Flottant double précision 64 bits
• Entier signé 32 bits
• Entier non signé 32 bits

Pour utiliser les VIs de Fichiers de configuration, vous devez formater correctement chaque ligne de texte dans le fichier .ini. Une ligne doit être vide ou contenir un nom de section, une paire clé/valeur ou un commentaire.

Remarque Vous ne pouvez utiliser les VIs de fichiers de configuration pour les fichiers de paramètres de configuration Windows que s'ils ont le format ANSI.

Utilisez les recommandations suivantes pour formater les lignes contenant des noms de section :

• Utilisez au moins un caractère
• N'utilisez pas de crochet de fermeture comme partie du nom
• N'utilisez pas de caractères non imprimables
• Utilisez un crochet d'ouverture pour le premier caractère qui n'est pas un espace blanc
• Utilisez un crochet de fermeture à la fin de la ligne de texte
• Assurez-vous que tous les caractères tiennent sur une ligne

Utilisez les recommandations suivantes pour formater les lignes contenant des paires clé/valeur :

• Incluez des paires sur les lignes après la ligne de section
• Placez un signe égal après le nom de clé
• Assurez-vous que tous les caractères tiennent sur une ligne
• Utilisez des noms de clé valides
  • Utilisez au moins un caractère
  • Ne commencez pas le nom par un point-virgule
  • N'utilisez pas de signe égal
  • Ne commencez pas le nom par un crochet d'ouverture
  • Ne commencez pas le nom par un espace blanc
  • Ne terminez pas le nom par un espace blanc
  • N'utilisez pas de caractères non imprimables
• Utilisez des noms de valeur valides
  • Utilisez un type de données de manière homogène
  • Ne commencez pas le nom par un espace blanc
  • Ne terminez pas le nom par un espace blanc

Remarque Si des valeurs commencent ou se terminent par des espaces blancs, vous devez mettre les valeurs entre guillemets. LabVIEW supprime les guillemets quand un VI renvoie la valeur.

Les VIs de fichiers de configuration ignorent les lignes qui ne comportent pas de nom de section ou de paire clé/valeur au cours d'une opération de lecture, mais ils préservent les lignes ne comportant pas de nom de section ni de paire clé/valeur au cours d'une opération d'écriture.

Lorsque les VIs écrivent dans un fichier de configuration, ils mettent entre guillemets toutes les données chaîne et les données de chemin. LabVIEW supporte également les apostrophes autour des valeurs dans les fichiers .ini.

La notation de commentaires acceptée pour les fichiers de configuration est un point-virgule, lequel sert à indiquer que le texte qui suit est un commentaire. Un point-virgule au début d'une ligne indique un commentaire. Un point-virgule dans un nom de section, une valeur numérique ou une valeur booléenne indique aussi un commentaire. Cependant, un point-virgule dans un nom de valeur chaîne n'indique pas un commentaire.

Si vous incluez un point-virgule comme premier caractère d'un nom de clé, LabVIEW ne renvoie pas de nom de clé ni de valeur car les fichiers de configuration ne supportent pas le point-virgule comme premier caractère d'un nom de clé. Si vous incluez un point-virgule à tout autre endroit du nom de clé que le premier caractère, LabVIEW renvoie le nom de clé avec le point-virgule.

Le tableau suivant fournit des exemples de la manière dont les VIs de fichiers de configuration lisent les noms de section dans les fichiers .ini.

Le tableau suivant fournit des exemples de la manière dont les VIs de fichiers de configuration lisent les paires clé/valeur dans les fichiers .ini.

Remarque Comme le VI Lire une clé est un VI polymorphe, il se conduit différemment dans certaines instances. Par exemple, pour la paire clé/valeur nomdeclé = 12.3 ;comm, l'instance Chaîne renvoie la valeur chaîne 12.3;comm alors que l'instance Double précision renvoie le nombre 12,3 pour la sortie valeur.

Les VIs de fichiers de configuration peuvent lire et écrire des données chaîne brute ou échappée. Les VIs lisent et écrivent les données brutes octet par octet, sans convertir les données en code ASCII. Dans des chaînes converties ou échappées, LabVIEW stocke tout texte non affichable dans le fichier de paramètres de configuration avec les codes hexadécimaux équivalents, comme \0D pour un retour chariot. De plus, LabVIEW stocke les barres obliques inverses dans le fichier de paramètres de configuration en double, c'est-à-dire \\ pour \. Définissez les entrées lire la chaîne brute ? ou écrire la chaîne brute ? des VIs de fichiers de configuration à VRAI pour les données brutes et à FAUX pour les données de chaîne échappée.

Dans les fichiers de paramètres de configuration, LabVIEW stocke des données chemin au format Linux standard pour les chemins. Les VIs interprètent le chemin absolu /c/temp/data.dat stocké dans le fichier de paramètres de configuration comme suit :

• (Windows) c:\temp\data.dat
• (macOS 32 bits) c:temp:data.dat
• (macOS 64 bits et Linux) /c/temp/data.dat

Les VIs interprètent le chemin relatif temp/data.dat comme suit :

• (Windows) temp\data.dat
• (macOS 32 bits) :temp:data.dat
• (macOS 64 bits et Linux) temp/data.dat