Registres

Si vous souhaitez stocker de l'information qui demeurent accessibles lors des différentes exécutions du jeu, il existe un mécanisme encore plus simple que d'utiliser un fichier. Vous pouvez utilisez la base de registres. La base de registres est une énorme base de données que Windows maintient à jour afin de conserver toutes sortes de paramétres sur les programmes. Une entrée (une clé de registre) posséde un nom et une valeur. Il est possible d'utiliser comme valeur à la fois des chaînes de caractères et des nombres réels. Les fonctions suivantes sont disponibles :

registry_write_string(name, str) Crée une entrée dans la base de registres en utilisant les nom et chaîne mentionnés.
registry_write_real(name, x) Crée une entrée dans la base de registres en utilisant les nom et nombre réel mentionnés.
registry_read_string(name) Retourne la chaîne de caractères que contient le nom de clé indiqué (le nom doit exister. Dans la négative, une chaîne vide sera retournée).
registry_read_real(name) Retourne la valeur réelle que contient le nom de clé mentionné (le nom doit exister. Dans le cas contraire, le nombre 0 sera retourné).
registry_exists(name) Indique si le nom de clé mentionné existe dans la base de registres.

Les valeurs dans la base de registres sont regroupées sous forme de clés. Toutes les routines ci-dessus travaillent avec des valeurs de clef spécialement créées pour votre jeu. Votre programme peut ainsi obtenir certaines informations sur le système que le jeu pourra exploiter. Vous pouvez également lire les valeurs d'autres clés. Vous pouvez même écrire dans ces clés mais soyez très prudent ! VOUS POUVEZ FACILEMENT DETRUIRE VOTRE SYSTEME en procédant ainsi ! (l'écriture n'est pas autorisée dans le mode sécurisé...) Veuillez noter que les clés sont placées à leur tour dans des groupes. Les routines suivantes travaillent par défaut avec le groupe HKEY_CURRENT_USER. Mais il est possible de changer de groupe racine. Ainsi, par exemple, si vous désirez connaître le répertoire temporaire courant, tapez ceci :

  path = registry_read_string_ext('\Environment','TEMP');

Les fonctions suivantes existent.

registry_write_string_ext(key, name, str) Crée une entrée de clé dans le registre avec les nom et valeur de chaîne fournis.
registry_write_real_ext(key, name, x) Crée une entrée de clé dans le registre avec les nom et valeur réelle fournis.
registry_read_string_ext(key, name) Retourne la valeur de la chaîne dont le nom est contenu dans la clé indiquée. (le nom doit exister. Sinon, une chaîne vide sera retournée).
registry_read_real_ext(key, name) Retourne la valeur du nombre réel dont le nom est contenu dans la clé indiquée. (le nom doit exister. Sinon, le nombre 0 sera retourné.)
registry_exists_ext(key, name) Indique si le nom donné existe dans la clé indiquée de la base de registres.
registry_set_root(root) Détermine la racine pour les autres routines. Utilisez les valeurs suivantes :

0 = HKEY_CURRENT_USER
1 = HKEY_LOCAL_MACHINE
2 = HKEY_CLASSES_ROOT
3 = HKEY_USERS

<< Traduction française par Philippe Ragni - (2005) >>