Cette commande ajoute la chaîne chaine$ à la fin d’un bloc relogeable spécifié par STR#resHndl&. Le paramètre STR#resHndl& doit être un handle sur une ressource “STR#” existante, ou un handle sur un bloc que vous avez l’intention de sauvegarder en tant que ressource STR#. Pour créer un nouveau handle vide, dans le but d’utiliser DEF APNDSTR, vous devez le créer comme suit :

Après avoir ajouté des chaînes au nouveau handle, vous pouvez le sauvegarder en tant que ressource en invoquant la routine AddResource.

Pour obtenir le handle sur une ressource “STR#” existante afin de l’utiliser avec la commande DEF APNDSTR, vous pouvez employer une des multiples fonctions du Gestionnaire de Ressources (Resource Manager) telle que GetResource.

N’utilisez jamais DEF APNDSTR avec une ressource purgeable, à moins que vous n’ayez au préalable appelé la fonction FN HNoPurge(str#handle&) pour (temporairement) la rendre non purgeable. Si vous pensez que la ressource peut avoir été purgée avant que vous ayez eu la chance d’appeler FN HNoPurge, alors vous devez appeler aussi CALL LoadResource(str#handle&) pour vous assurer qu’elle est bien chargée en mémoire.

Si vous utilisez DEF APNDSTR pour mettre à jour une ressource “STR#” existante, utilisez alors CALL ChangedResource(str#handle&) après avoir exécuté DEF APNDSTR, pour que vos modifications soient écrites sur le disque lorsque le fichier de ressources sera fermé ou mis à jour.

DEF APNDSTR peut provoquer des erreurs système si l’espace mémoire réservé au heap est très restreint ou très fragmenté. Vous pouvez exécuter la fonction MEM(_maxAvail) périodiquement pour défragmenter la mémoire.