UpsKrn.Caractere

Définition


/***************************************************************/

Type Caractere Implemente Public : IEspaceMetre Defaut Final TailleSegment 32 ConserverObjets

/* Objet : Encapsulation du type Caractere. */

/***************************************************************/

/*-------------------------------------------------------------*/

/* Heritage des proprietes d'Objet.  */

/*-------------------------------------------------------------*/

Prive :

	
	EstInstanceDe : Type Lecture Public;

/*-------------------------------------------------------------*/

/* Heritage des methodes d'Objet.    					      */

/*-------------------------------------------------------------*/

Public :

	
	Fonction Optimiser(Invariant) Identique(O : Nul Ou Objet) Retourner Nul Ou Booleen;
	

	Procedure Convertir(O : Nul Ou Objet);
	

	Fonction Optimiser(Invariant) CreeParLeServeur() Retourner Entier;
	

	Fonction Optimiser(Invariant) CreeParLeProcessus() Retourner Entier;
	

	Fonction Optimiser(Invariant) CreeDansLEntrepot() Retourner Entrepot;
	

	Fonction Cloner(EntrepotCible : Nul Ou Entrepot=Nul, Profondeur : ModeClonage = ClonageObjetSeul) Retourner Nul Ou Objet;
	

	Fonction LirePropriete(NomPropriete : Caractere) Retourner Nul Ou Objet;
	

	Procedure EcrirePropriete(NomPropriete : Caractere, Valeur : Nul Ou Objet);
	

	Fonction IncrementerDecrementerPropriete(NomPropriete : Nul Ou Caractere, Incrementer : Booleen, Prefixe : Booleen) Retourner Nul Ou Objet;
	

	Procedure SupprimerPropriete(NomPropriete : Caractere);
	

	Fonction Optimiser(Invariant) EnumererProprietes(NumeroPropriete : Entier, TypePropriete : Nul Ou Type=? Sortie, PeutEtreNul : Booleen=? Sortie, Aide : Nul Ou Caractere=? Sortie, NomEnumere : Nul Ou Caractere=? Sortie) Retourner Nul Ou Caractere;
	

	Fonction Optimiser(Invariant) Adresse() Retourner Nul Ou Caractere;

Prive :

	
	Fonction Exporter(E : Nul Ou IEchangeElementaire) Retourner Boolean;
	

	Fonction Importer(E : Nul Ou IEchangeElementaire, EntrepotCible : Nul Ou Entrepot=Nul, EstFiltre : Booleen=Faux, V : Entier=0, R : Entier=0, C : Entier=0) Retourner Nul Ou Objet;

/*-------------------------------------------------------------*/

/* Heritage des methodes d'IEspaceMetre.    					      */

/*-------------------------------------------------------------*/

Public :


	
	Operateur Optimiser(Invariant, NulAbsorbant)  <=(C : Nul Ou Caractere) Retourner Nul Ou Booleen;
	

	Operateur Optimiser(Invariant, NulAbsorbant) >=(C : Nul Ou Caractere) Retourner Nul Ou Booleen;
	

	Operateur Optimiser(Invariant, NulAbsorbant) <(C : Nul Ou Caractere) Retourner Nul Ou Booleen;
	

	Operateur Optimiser(Invariant, NulAbsorbant) >(C : Nul Ou Caractere) Retourner Nul Ou Booleen;

/*-------------------------------------------------------------*/

/* Methodes propres.                                           */

/*-------------------------------------------------------------*/

Public :


	
	Constructeur();
	

	Constructeur Optimiser(Invariant, NulAbsorbant) (B : Nul Ou Booleen);
	

	Constructeur Optimiser(Invariant, NulAbsorbant) (D : Nul Ou Date, Filtre : Nul Ou Caractere=Nul);
	

	Constructeur Optimiser(Invariant, NulAbsorbant) (E : Nul Ou Entier, Filtre : Nul Ou Caractere=Nul, PointVirgule : Nul Ou Caractere=Nul);
	

	Constructeur Optimiser(Invariant, NulAbsorbant) (R : Nul Ou Reel, Filtre : Nul Ou Caractere=Nul, PointVirgule : Nul Ou Caractere=Nul);
	

	Constructeur Optimiser(Invariant, NulAbsorbant) (E : Nul Ou Entier, Base : Nul Ou Entier);
	

	Constructeur Optimiser(Invariant, NulAbsorbant) (B : Nul Ou Binaire);
	

   Operateur Optimiser(Invariant, NulAbsorbant) ==(C : Nul Ou Caractere) Retourner Nul Ou Booleen;
	

   Operateur Optimiser(Invariant, NulAbsorbant) !=(C : Nul Ou Caractere) Retourner Nul Ou Booleen;
	

	Operateur Optimiser(Invariant, NulAbsorbant) +(C : Nul Ou Caractere) Retourner Nul Ou Caractere;
	

	Operateur Optimiser(Invariant) -() Retourner Nul Ou Caractere;
	

	Fonction Optimiser(Invariant) Longueur() Retourner Entier;
	

	Fonction Optimiser(Invariant, NulAbsorbant) Gauche(Taille : Nul Ou Entier) Retourner Nul Ou Caractere;
	

	Fonction Optimiser(Invariant, NulAbsorbant) Droite(Taille : Nul Ou Entier) Retourner Nul Ou Caractere;
	

	Fonction Optimiser(Invariant, NulAbsorbant) Milieu(Position : Nul Ou Entier, Taille : Nul Ou Entier) Retourner Nul Ou Caractere;
	

   Operateur Optimiser(Invariant) [](Position : Nul Ou Entier) Retourner Nul Ou Entier;
	

   Operateur [](Position : Nul Ou Entier, Valeur : Nul Ou Entier, MethodeAComposer : Nul Ou Fonction(P1 : Nul Ou Entier, P2 : Nul Ou Entier) Retourner Nul Ou Entier);
	

   Operateur [](Position : Nul Ou Entier, Prefixe : Booleen, MethodeAComposer : Nul Ou Fonction(P1 : Nul Ou Entier, P2 : Booleen) Retourner Nul Ou Entier) Retourner Nul Ou Entier;
	

	Fonction Optimiser(Invariant) Majuscule() Retourner Nul Ou Caractere;
	

	Fonction Optimiser(Invariant) MajMinuscule() Retourner Nul Ou Caractere;
	

	Fonction Optimiser(Invariant) Minuscule() Retourner Nul Ou Caractere;
	

	Fonction Optimiser(Invariant, NulAbsorbant) Inserer(Chaine : Nul Ou Caractere, Position : Nul Ou Entier) Retourner Nul Ou Caractere;
	

	Fonction Optimiser(Invariant, NulAbsorbant) Compter(Modele : Nul Ou Caractere, Position : Nul Ou Entier=Nul) Retourner Nul Ou Entier;
	

	Fonction Optimiser(Invariant, NulAbsorbant) Remplacer(Modele : Nul Ou Caractere, Remplacant : Nul Ou Caractere, Position : Nul Ou Entier=Nul) Retourner Nul Ou Caractere;
	

	Fonction Optimiser(Invariant, NulAbsorbant) Ajouter(Taille : Nul Ou Entier, Modele : Nul Ou Caractere=" ") Retourner Nul Ou Caractere;
	

	Fonction Optimiser(Invariant, NulAbsorbant) AjouterGauche(Taille : Nul Ou Entier, Modele : Nul Ou Caractere=" ") Retourner Nul Ou Caractere;
	

	Fonction Optimiser(Invariant, NulAbsorbant) AjouterDroite(Taille : Nul Ou Entier, Modele : Nul Ou Caractere=" ") Retourner Nul Ou Caractere;
	

	Fonction Optimiser(Invariant, NulAbsorbant) Supprimer(Modele : Nul Ou Caractere=" ") Retourner Nul Ou Caractere;
	

	Fonction Optimiser(Invariant, NulAbsorbant) SupprimerGauche(Modele : Nul Ou Caractere=" ") Retourner Nul Ou Caractere;
	

	Fonction Optimiser(Invariant, NulAbsorbant) SupprimerDroite(Modele : Nul Ou Caractere=" ") Retourner Nul Ou Caractere;
	

	Fonction Optimiser(Invariant, NulAbsorbant) Rechercher(Modele : Nul Ou Caractere, Position : Nul Ou Entier=Nul) Retourner Nul Ou Entier;
	

	Fonction Optimiser(Invariant, NulAbsorbant) IdentiqueMajMinuscule() Retourner Nul Ou Booleen;
	

	Operateur Optimiser(Invariant, NulAbsorbant) Comme(C : Nul Ou Caractere) Retourner Nul Ou Booleen;
	

	Fonction Optimiser(Invariant, NulAbsorbant) IlExisteJoker() Retourner Nul Ou Booleen;
	

   Operateur =(C: Nul Ou ICollection(Nul Ou Entier));
	

   Fonction Optimiser(Invariant) VersObjet() Retourner Nul Ou Objet;

Prive :

	
   Destructeur(MettreEnAnteMemoire : Booleen) Retourner Booleen;

Fin Type

Le type Caractere modélise une chaîne de caractères Unicode dont les codes varient de 1 à 65535. La taille de la chaîne de caractères est calculée automatiquement et dynamiquement en fonction de son contenu.

Le caractère fin de chaîne a pour code 0.

Le type Caractere possède douze constructeurs :

Un constructeur implicite qui initialise la chaîne de caractères à la chaîne vide ".
Un constructeur à partir d'un Booleen. En ce cas, le booléen est converti en son libellé le représentant.
Un constructeur à partir d'une Date. En ce cas, la date est convertie en une chaîne de caractères le représentant. Il est possible de préciser un filtre de formatage composé de caractères jokers.
Deux constructeurs à partir d'un Entier. En ce cas, soit :
- L'entier est converti en une chaîne de caractères le représentant. Il est possible de préciser un filtre de formatage composé de caractères jokers et de spécifier les caractères servant de point et de virgule.
- L'entier est converti en une chaîne de caractères le représentant dans la base demandée. Les bases supportées sont 2, 4, 8, 10 et 16. Par défaut, la base décimale est utilisée.
Un constructeur à partir d'un Reel. En ce cas, le réel est converti en une chaîne de caractères le représentant. Il est possible de préciser un filtre de formatage composé de caractères jokers et de spécifier les caractères servant de point et de virgule.
Un constructeur à partir d'un Binaire. En ce cas, les octets du binaire est converti en une chaîne de caractères. Le binaire est supposé représenter une chaîne de caractères valide.

Si les paramètres optionnels des constructeurs sont omis, les valeurs par défaut correspondent aux valeurs des paramètres d'Up ! Natural Language Support.

Jokers admissibles

Voici la liste des jokers admissibles dans un filtre pour convertir un entier ou un réel en une chaîne de caractères :

# représente un chiffre obligatoire de la valeur. (Insertion de 0 en tête ou en queue si le chiffre correspondant à cette place est indéfini.)
& représente un chiffre optionnel de la valeur. (Si ce chiffre est 0, il est remplacé par le caractère espace.)
@ représente un chiffre obligatoire de la valeur. (Insertion de 0 en tête ou en queue si le chiffre correspondant à cette place est indéfini.). Il est utilisé à la place du dernier caractère de la partie décimale du filtre afin de spécifier que le nombre doit être arrondi.
, représente la virgule. Si aucun chiffre ne suit la virgule, celle-ci n'apparaît pas.
- représente le signe de l'expression. Si l'expression est positive, le signe est remplacé par le caractère espace.
+ représente le signe de l'expression. Il apparaît toujours.
. représente le séparateur de chiffres de l'expression. Il a pour valeur le caractère point s'il est encadré de deux chiffres, sinon il a pour valeur le caractère espace.

Lorsque le signe de l'expression (caractère plus + ou caractère moins -) est accolé à des caractères facultatifs de la partie entière, il sera accolé au premier de ces caractères correspondant à un chiffre du nombre.

Voici la liste des jokers admissibles dans un filtre pour convertir une date en une chaîne de caractères :

%j représente le numéro du jour dans le mois sur un ou deux caractères. (Pas de caractère 0 en tête.)
%jj représente le numéro du jour dans le mois sur deux caractères. (Eventuellement un caractère 0 est inséré en tête.)
%jjj représente le numéro du jour dans l'année.
%js représente le numéro du jour dans la semaine sur un caractère.
%J représente l'abréviation du nom du jour sur trois caractères.
%JJ représente le nom du jour complet.
%m représente le numéro du mois dans l'année sur un ou deux caractères. (Pas de caractère 0 en tête.)
%mm représente le numéro du mois sur deux caractères. (Eventuellement un caractère 0 est inséré en tête.)
%M représente l'abréviation du nom du mois sur trois caractères.
%MM représente le nom du mois complet.
%w représente le numéro de la semaine sur un ou deux caractères. (Pas de caractère 0 en tête.)
%ww représente le numéro de la semaine sur deux caractères.
%t représente le numéro du trimestre sur un caractère.
%a représente l'année en ne conservant que les deux derniers chiffres.
%A représente l'année sur quatre chiffres.
%h représente l'heure sur un ou deux caractères. (Pas de caractère 0 en tête et la péridocité est de 12 heures.)
%hh représente l'heure sur deux caractères. (Eventuellement un caractère 0 est inséré en tête et la périodicité est de 12 heures.)
%H représente l'heure sur un ou deux caractères. (Pas de caractère 0 en tête et la péridocité est de 24 heures.)
%HH représente l'heure sur deux caractères. (Eventuellement un caractère 0 est inséré en tête et la périodicité est de 24 heures.)
%mi représente les minutes sur un ou deux caractères. (Pas de caractère 0 en tête.)
%Mi représente les minutes sur deux caractères. (Eventuellement un caractère 0 est inséré en tête.)
%s représente les secondes sur un ou deux caractères. (Pas de caractère 0 en tête.)
%S représente les secondes sur deux caractères. (Eventuellement un caractère 0 est inséré en tête.)
%ms représente les millièmes de seconde sur un, deux ou trois caractères. (Pas de caractère 0 en tête.)
%Ms représente les millièmes de secondes sur trois caractères. (Eventuellement un ou deux caractères 0 est inséré en tête.)

Opérateurs

Le type Caractere possède les opérateurs standards suivant :

+ pour la concaténation de deux chaînes de caractères. Le résultat est une chaîne de caractères.
- pour l'inversion d'une chaîne de caractères. Le résultat est une chaîne de caractères.
= pour l'affectation d'une chaîne de caractères dans une autre.
= pour l'affectation d'une collection de code Unicode dans la chaîne de caractères. Le contenu de la chaîne de caractères est alors remplacé.
+= pour la concaténation suivie d'une chaîne de caractères puis l'affectation du résultat.
== pour l'égalité entre deux chaînes de caractères. Le résultat est un booléen.
!= pour l'inégalité entre deux chaînes de caractères. Le résultat est un booléen.
<= et >= pour respectivement l'infériorité large et la supériorité large entre deux chaînes de caractères. Le résultat est un booléen.
< et > pour respectivement l'infériorité stricte et la supériorité stricte entre deux chaînes de caractères. Le résultat est un booléen.
[] pour retrouver un code Unicode d'après son index dans la chaîne de caractères. L'index doit être compris entre 0 et Longueur()-1. Un numéro d'index incorrect provoque l'exception CollectionIndexImpossible.

Exemple

Pour un exemple complet, merci de se référer à Caractere.

Principal /*******/ Variable /******/


	Libelle : Caractere;

	Ville : Caractere;

	Libelle : Caractere;




Debut

/* Conversion d'un entier en une chaîne de caractères. */ 

Libelle=Caractere(1, "&&&#,#");

/* Conversion d'un entier en une chaîne de caractères avec un filtre. */ 

Libelle=Caractere(1.0);

/* Conversion d'un réel en une chaîne de caractères. */ 

Libelle=Caractere(1.0, "&&&#,#");

/* Conversion d'un réel en une chaîne de caractères avec un filtre. */ 

Libelle=Caractere(DateDuJour);

/* Conversion de la date du jour en une chaîne de caractères. */ 

Libelle=Caractere(DateDuJour, "Le %j/%m/%a a %h:%m:%s");

/* Conversion de la date du jour en une chaîne de caractères avec un filtre. */ 

Libelle=Caractere(Vrai);

/* Conversion d'un booléen en une chaîne de caractères. */ 

Libelle="La ville de : "+Ville;

/* Concaténation de deux chaînes de caractères. */

Libelle=-"Abcde";

/* Inversion de la chaîne de caractères 'abcde' ce qui donne 'edcba'. */

Si Ville=="Paris" Alors

/* Egalité entre deux chaînes de caractères. */ 

	...

Fin Si

Si Ville!="Paris" Alors

/* Inégalité entre deux chaînes de caractères. */ 

	...

Fin Si

Si Ville<="Paris" Alors

/* Infériorité large entre deux chaînes de caractères. */ 

	...

Fin Si

Si Ville<"Paris" Alors

/* Infériorité stricte entre deux chaînes de caractères. */ 

	...

Fin Si

Fin Principal

Traduction


-	-	-	-	-	-	-	-	-