Appel général
Base
Cette classe peut être intégrée dans n’importe quel script Python.
Une importation depuis cenpylib import * doit être effectuée.
Définissez un membre de la classe dans la méthode nls = NLSUtility() et vous avez désormais accès aux méthodes et fonctions de la classe.
Initialisation de la traduction NLS
Pour obtenir la traduction NLS disponible dans votre script Python, vous devez définir différents paramètres en appelant la méthode defineNLS().
Il fournit plusieurs paramètres pour obtenir la traduction souhaitée.
defineNLS( langage, projet, alternativePath )
Paramètre langue : peut être défini avec les langues habituelles E2 anglais « EN », allemand « DE », français « FR », chinois « CN », japonais « JP »
Si elle est laissée vide, la classe essaie d’obtenir la langue OSystem et de lier vers ce langage. Par défaut, c’est « EN » anglais
Paramètre project : un nom souhaité pour les fichiers de traduction peut être défini. Si « » est laissé vide, par défaut « commun » sera utilisé.
Cela signifie que la classe recherche des fichiers de traduction avec le nom souhaité (ou « commun »)
La convention de nommage des fichiers est [nom]. [langue].lng, par exemple report.fr.lng
Paramètre alternativePath : par défaut, la classe recherche des fichiers de langage dans l’installation E2 dans le dossier cenpylib, sous-dossier languages.
Si des fichiers personnalisés sont nécessaires, qu’ils existent déjà dans le dossier cenpylib ou qu’ils en complètent de nouveaux, un chemin vers un plug-in désiré peut être défini.
defineNLS() : no Args : get language from OS, Project « common », NLS in cenpylib\languages
defineNLS(language) : seulement langage Arg : langage désiré, Project « common », NLS in cenpylib\languages
defineNLS(altpath=“yourpath ») : only path Arg : get language from OS, Project « common », NLS in altpath & cenpylib\languages
defineNLS(language, altpath=“yourpath ») : langage & path Arg : langage désiré, Projet « common », NLS dans altpath & cenpylib\languages
defineNLS(langage, projet) : langage & projet Arg : langue souhaitée ou vide « “=OS, Projet avec nom désiré, NLS en cenpylib\languages
defineNLS(language, project, altpath) : langage & projet Arg : langage désiré ou vide « “=OS, projet avec nom désiré, NLS dans altpath & cenpylib\languages
defineNLS(project=“yourproject », altpath=“yourpath ») : language=OS, Projet avec nom désiré, NLS dans altpath & cenpylib\languages
Note : sachez que dans certains cas, la description du paramètre (altpath= »… ») peut être nécessaire
Emplacement par défaut des fichiers de traduction :
On obtient l’objet traduit
Pour obtenir l’élément désiré en chaîne, cette méthode sera utilisée :
définitivement getNLS(nom, par défaut):
Paramètre name : le nom de l’élément souhaité dans le fichier de traduction
Paramètre default : une chaîne par défaut qui sera utilisée si l’élément n’a pas été trouvé. Optionnel, si ce n’est pas défini, le paramètre name est pris comme valeur par défaut
La chaîne lue depuis le fichier NLS ou le défaut sera retournée
Remplace un substitut dans une ficelle
Il peut être possible de définir des espaces réservés dans une chaîne de traduction, qui doit être remplacée par n’importe quelle partie variable, par exemple un nom de fichier par défaut avec le nom du programme.
Dans ce cas, vous pouvez ajouter un ensemble unique de caractères à la traduction et laisser cet ensemble unique remplacer par le nom du programme souhaité dans la traduction retournée.
définitivement replaceNLS(instring, searchstr, replacestr):
Paramètre instring : la chaîne contenant le lieu de remplacement à remplacer
Paramètre searchstr : l’ensemble unique de caractères à remplacer
Paramètre replacestr : la chaîne qui remplacera le searchstr
La corde avec la section remplacée sera retournée
Exemple :
