Class TString

java.lang.Object
  |
  +--TObject
        |
        +--TString

public class TString
extends TObject

La classe TString représente une chaîne de caractère. Il est recommendé d'instancier tous les littéraux (ex: "abc") en tant qu'objets de Type String pour en faciliter la manipulation.

Since:
Release 1.0

Field Summary
 char[] string
          La chaine de caractère (format ANSI)
 
Constructor Summary
TString()
           
 
Method Summary
 char charAt(long index)
          Cette méthode retourne le caractère à l'index spécifié.
 TString clone()
          Cette méthode retourne un objet de Type String qui est une copie de l'objet.
 boolean compareTo(TString string)
          Cette méthode compare deux chaînes de caractères lexicographiquement.
 TString concat(TString string)
          Cette méthode concatène deux objets de Type String.
static java.lang.String concatenateString(java.lang.String string0, java.lang.String string1)
          Cette méthode concatène deux chaînes de caractères ANSI.
static java.lang.String copyValueOf0(char[] charArray, long offset, long count)
          Cette méthode génère une chaîne de caractères ANSI à partir d'un vecteur de caractères.
static java.lang.String copyValueOf1(char[] charArray, long length)
          Cette méthode génère une chaîne de caractères ANSI à partir d'un vecteur de caractères.
static java.lang.String duplicateString(java.lang.String string)
          Cette méthode copie une chaîne de caractères ANSI.
 boolean endsWith(TString string)
          Cette méthode vérifie si la chaîne de caractères se termine avec le suffixe spécifié.
 boolean equals(TString anotherString)
          Cette méthode compare l'objet à un autre objet pour établir une égalité.
 boolean equalsIgnoreCase(TString string)
          Cette méthode compare lexicographiquement la chaîne de caractères avec une autre chaîne de caractères, mais en ignorant la case.
 void finalize()
          Cette méthode libère l'espace mémoire occupée par l'objet, détruisant ce dernier.
static java.lang.String generateEmptyString(long length)
          Cette méthode génère une chaîne de caractères vide ANSI.
 void getChars(long srcBegin, long srcEnd, char[] dst, long dstBegin)
          Cette méthode copie les caractères de la chaîne de caractère vers un vecteur de caractères.
 long indexOf0(TString string, long index)
          Cette méthode retourne l'index de la première occurence de la chaîne spécifiée dans la chaîne de caractères à partir de l'index spécifié.
 long indexOf1(TString string)
          Cette méthode retourne l'index de la première occurence de la chaîne spécifiée dans la chaîne de caractères.
 long lastIndexOf0(TString string, long index)
          Cette méthode retourne l'index de la dernière occurence de la chaîne spécifiée dans la chaîne de caractères cherchant à reculon à partir de l'index spécifié.
 long lastIndexOf1(TString string)
          Cette méthode retourne l'index de la dernière occurence de la chaîne spécifiée dans la chaîne de caractères cherchant à reculon à partir de l'index spécifié.
 long length()
          Cette méthode retourne la longueur de la chaîne de caractère.
 boolean regionMatches0(boolean ignoreCase, long toffset, TString string, long ooffset, long length)
          Cette méthode compare lexicographiquement une région de la chaîne de caractères avec celle d'une autre chaîne de caractères.
 boolean regionMatches1(long toffset, TString anotherString, long ooffset, long length)
          Cette méthode compare lexicographiquement une région de la chaîne de caractères avec celle d'une autre chaîne de caractères.
 TString replace(char oldChar, char newChar)
          Cette méthode remplace toutes les occurences du caractère spécifié dans la chaîne de caractères par un caractère spécifié.
 boolean startsWith0(TString string, long offset)
          Cette méthode vérifie si la chaîne de caractères commence avec le préfixe spécifié.
 boolean startsWith1(TString string)
          Cette méthode vérifie si la chaîne de caractères commence avec le préfixe spécifié.
 TString substring0(long beginIndex, long endIndex)
          Cette méthode retourne la sous-chaîne de caractères délimité par les index spécifiés.
 TString substring1(long beginIndex)
          Cette méthode retourne la sous-chaîne de caractères commençant par l'index spécifié.
 char[] toCharArray()
          Cette méthode retourne un vecteur de caractères composé des caractères de la chaîne de caractères.
 TString toLowerCase()
          Cette méthode change la case de la chaîne de caractères pour des minuscules.
 TString toString()
          Cette méthode retourne une chaîne de caractères représentant l'objet.
 TString toUpperCase()
          Cette méthode change la case de la chaîne de caractères pour des majuscules.
 TString trim()
          Cette méthode enlève les espaces des deux côtés de la chaîne de caractères.
 TString TString0()
          Ce constructeur instancie un objet de Type String.
 TString TString1(TString string)
          Ce constructeur instancie un objet de Type String à partir d'un autre objet de Type String.
 TString TString2(long num, TObject ellipse)
          Ce constructeur instancie un objet de Type String à partir d'un groupe d'objets.
 TString TString3(java.lang.String string)
          Ce constructeur instancie un objet de Type String à partir d'une chaîne de caractères.
 TString TString4(long num, java.lang.String ellipse)
          Ce constructeur instancie un objet de Type String à partir d'un groupe de chaines de caractères ANSI.
 TString TString5(char[] charArray, long length)
          Ce constructeur instancie un objet de Type String à partir d'un vecteur de caractères.
static TString valueOf0(char[] charArray, long offset, long count)
          Cette méthode génère un objet de Type String à partir d'un vecteur de caractères.
static TString valueOf1(char[] charArray, long length)
          Cette méthode génère un objet de Type String à partir d'un vecteur de caractères.
 
Methods inherited from class TObject
equals, TObject0
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

string

public char[] string
La chaine de caractère (format ANSI)

Constructor Detail

TString

public TString()
Method Detail

generateEmptyString

public static java.lang.String generateEmptyString(long length)
Cette méthode génère une chaîne de caractères vide ANSI.

Parameters:
length - Taille de la chaîne de caractères.
Returns:
string - La chaîne de caractères.
Since:
Release 1.0

concatenateString

public static java.lang.String concatenateString(java.lang.String string0,
                                                 java.lang.String string1)
Cette méthode concatène deux chaînes de caractères ANSI.

Parameters:
string0 - La première chaîne de caractères.
string1 - La deuxième chaîne de caractères.
Returns:
string - La chaîne de caractères concaténée.
Since:
Release 1.0

duplicateString

public static java.lang.String duplicateString(java.lang.String string)
Cette méthode copie une chaîne de caractères ANSI.

Parameters:
string - La chaîne de caractère à copier.
Returns:
copy - La copie de la chaîne.
Since:
Release 1.0

copyValueOf0

public static java.lang.String copyValueOf0(char[] charArray,
                                            long offset,
                                            long count)
Cette méthode génère une chaîne de caractères ANSI à partir d'un vecteur de caractères.

Parameters:
charArray - Le vecteur de caractères.
offset - L'index du premier caractère à copier.
count - Le nombre de caractères à copier.
Returns:
string - La chaîne de caractères.
Since:
Release 1.0

copyValueOf1

public static java.lang.String copyValueOf1(char[] charArray,
                                            long length)
Cette méthode génère une chaîne de caractères ANSI à partir d'un vecteur de caractères.

Parameters:
charArray - Le vecteur de caractères.
length - Le nombre de caractères à copier.
Returns:
string - La chaîne de caractères.
Since:
Release 1.0

valueOf0

public static TString valueOf0(char[] charArray,
                               long offset,
                               long count)
Cette méthode génère un objet de Type String à partir d'un vecteur de caractères.

Parameters:
charArray - Le vecteur de caractères.
offset - L'index du premier caractère à copier.
count - Le nombre de caractères à copier.
Returns:
string - La chaîne de caractères.
Since:
Release 1.0

valueOf1

public static TString valueOf1(char[] charArray,
                               long length)
Cette méthode génère un objet de Type String à partir d'un vecteur de caractères.

Parameters:
charArray - Le vecteur de caractères.
length - La taille du vecteur.
Returns:
string - La chaîne de caractères.
Since:
Release 1.0

TString0

public TString TString0()
Ce constructeur instancie un objet de Type String.

Since:
Release 1.0

TString1

public TString TString1(TString string)
Ce constructeur instancie un objet de Type String à partir d'un autre objet de Type String.

Since:
Release 1.0

TString2

public TString TString2(long num,
                        TObject ellipse)
Ce constructeur instancie un objet de Type String à partir d'un groupe d'objets.

Parameters:
num - Le nombre d'objets utilisés pour initialiser la chaîne de caractères.
Since:
Release 1.0

TString3

public TString TString3(java.lang.String string)
Ce constructeur instancie un objet de Type String à partir d'une chaîne de caractères.

Parameters:
string - La chaîne de caractères ANSI.
Since:
Release 1.0

TString4

public TString TString4(long num,
                        java.lang.String ellipse)
Ce constructeur instancie un objet de Type String à partir d'un groupe de chaines de caractères ANSI.

Parameters:
num - Le nombre de chaînes de caractères utilisées.
Since:
Release 1.0

TString5

public TString TString5(char[] charArray,
                        long length)
Ce constructeur instancie un objet de Type String à partir d'un vecteur de caractères.

Parameters:
charArray - Le vecteur de caractères.
length - Le nombre de caractères à copier.
Since:
Release 1.0

toString

public TString toString()
Cette méthode retourne une chaîne de caractères représentant l'objet. Dans le cas d'un objet de Type String, elle se retourne elle-même.

Overrides:
toString in class TObject
Returns:
string - La chaîne de caractère représentant l'objet.
Since:
Release 1.0

finalize

public void finalize()
Cette méthode libère l'espace mémoire occupée par l'objet, détruisant ce dernier.

Overrides:
finalize in class TObject
Since:
Release 1.0

length

public long length()
Cette méthode retourne la longueur de la chaîne de caractère.

Returns:
length - La longueur de la chaîne de caractères.
Since:
Release 1.0

compareTo

public boolean compareTo(TString string)
Cette méthode compare deux chaînes de caractères lexicographiquement.

Returns:
result - Vrai si les deux chaînes sont lexicographiquement identiques.
Since:
Release 1.0

equals

public boolean equals(TString anotherString)
Cette méthode compare l'objet à un autre objet pour établir une égalité. Dans le cas d'un objet de Type String, la comparaison se fait lexicographiquement.

Parameters:
anotherString - L'objet à comparer.
Returns:
result - Vrai si les deux chaînes de caractères sont lexicographiquement identiques.
Since:
Release 1.0

clone

public TString clone()
Cette méthode retourne un objet de Type String qui est une copie de l'objet.

Overrides:
clone in class TObject
Returns:
clone - Une copie de l'objet.
Since:
Release 1.0

charAt

public char charAt(long index)
Cette méthode retourne le caractère à l'index spécifié. L'index varie de 0 à length() - 1.

Parameters:
index - L'index.
Returns:
character - Le caractère à l'index spécifié(NULL si l'index est invalide).
Since:
Release 1.0

concat

public TString concat(TString string)
Cette méthode concatène deux objets de Type String.

Returns:
string - La nouvelle chaîne.
Since:
Release 1.0

indexOf0

public long indexOf0(TString string,
                     long index)
Cette méthode retourne l'index de la première occurence de la chaîne spécifiée dans la chaîne de caractères à partir de l'index spécifié.

Parameters:
index - L'index d'où commencer.
Returns:
result - L'index de la première occurence de la chaîne de caractères spécifiée.
Since:
Release 1.0

indexOf1

public long indexOf1(TString string)
Cette méthode retourne l'index de la première occurence de la chaîne spécifiée dans la chaîne de caractères.

Returns:
result - L'index de la première occurence de la chaîne de caractères spécifiée.
Since:
Release 1.0

endsWith

public boolean endsWith(TString string)
Cette méthode vérifie si la chaîne de caractères se termine avec le suffixe spécifié.

Returns:
result - Vrai si la chaîne de caractères se termine avec le suffixe spécifié.
Since:
Release 1.0

toLowerCase

public TString toLowerCase()
Cette méthode change la case de la chaîne de caractères pour des minuscules.

Returns:
string - La chaîne de caractères en minuscule.
Since:
Release 1.0

toUpperCase

public TString toUpperCase()
Cette méthode change la case de la chaîne de caractères pour des majuscules.

Returns:
string - La chaîne de caractères en majuscule.
Since:
Release 1.0

regionMatches0

public boolean regionMatches0(boolean ignoreCase,
                              long toffset,
                              TString string,
                              long ooffset,
                              long length)
Cette méthode compare lexicographiquement une région de la chaîne de caractères avec celle d'une autre chaîne de caractères.

Parameters:
ignoreCase - Spécifie s'il faut ignorer la case.
toffset - L'index du début de la région à comparer de cette chaîne.
ooffset - L'index du début de la région à comparer de l'autre chaîne.
length - La taille des régions à comparer.
Returns:
result - Vrai si les régions sont lexicographiquement identiques.
Since:
Release 1.0

regionMatches1

public boolean regionMatches1(long toffset,
                              TString anotherString,
                              long ooffset,
                              long length)
Cette méthode compare lexicographiquement une région de la chaîne de caractères avec celle d'une autre chaîne de caractères.

Parameters:
toffset - L'index du début de la région à comparer de cette chaîne.
anotherString - La chaîne à comparer.
ooffset - L'index du début de la région à comparer de l'autre chaîne.
length - La taille des régions à comparer.
Returns:
result - Vrai si les régions sont lexicographiquement identiques.
Since:
Release 1.0

equalsIgnoreCase

public boolean equalsIgnoreCase(TString string)
Cette méthode compare lexicographiquement la chaîne de caractères avec une autre chaîne de caractères, mais en ignorant la case.

Returns:
result - Vrai si les chaînes sont lexicographiquement identiques.
Since:
Release 1.0

getChars

public void getChars(long srcBegin,
                     long srcEnd,
                     char[] dst,
                     long dstBegin)
Cette méthode copie les caractères de la chaîne de caractère vers un vecteur de caractères.

Parameters:
srcBegin - Index du premier caractère à copier.
srcEnd - Index du dernier caractère à copier.
dst - Vecteur de caractères de destination.
dstBegin - Index du sous-vecteur de caractères.

lastIndexOf0

public long lastIndexOf0(TString string,
                         long index)
Cette méthode retourne l'index de la dernière occurence de la chaîne spécifiée dans la chaîne de caractères cherchant à reculon à partir de l'index spécifié.

Parameters:
index - L'index d'où commencer.
Returns:
result - L'index de la dernière occurence de la chaîne de caractères spécifiée.
Since:
Release 1.0

lastIndexOf1

public long lastIndexOf1(TString string)
Cette méthode retourne l'index de la dernière occurence de la chaîne spécifiée dans la chaîne de caractères cherchant à reculon à partir de l'index spécifié.

Returns:
result - L'index de la dernière occurence de la chaîne de caractères spécifiée.
Since:
Release 1.0

replace

public TString replace(char oldChar,
                       char newChar)
Cette méthode remplace toutes les occurences du caractère spécifié dans la chaîne de caractères par un caractère spécifié.

Parameters:
oldChar - Le caractère à remplacer.
newChar - Le caractère remplaçant.
Returns:
string - La chaîne de caractères modifiée.
Since:
Release 1.0

startsWith0

public boolean startsWith0(TString string,
                           long offset)
Cette méthode vérifie si la chaîne de caractères commence avec le préfixe spécifié.

Parameters:
offset - D'où commencer.
Returns:
result - Vrai si la chaîne de caractères commence avec le préfixe spécifié.
Since:
Release 1.0

startsWith1

public boolean startsWith1(TString string)
Cette méthode vérifie si la chaîne de caractères commence avec le préfixe spécifié.

Returns:
result - Vrai si la chaîne de caractères commence avec le préfixe spécifié.
Since:
Release 1.0

substring0

public TString substring0(long beginIndex,
                          long endIndex)
Cette méthode retourne la sous-chaîne de caractères délimité par les index spécifiés.

Parameters:
beginIndex - L'index où commence la sous-chaîne.
endIndex - L'index où finit la sous-chaîne.
Returns:
substring - La sous-chaîne de caractères.
Since:
Release 1.0

substring1

public TString substring1(long beginIndex)
Cette méthode retourne la sous-chaîne de caractères commençant par l'index spécifié.

Parameters:
beginIndex - L'index où commence la sous-chaîne.
Returns:
substring - La sous-chaîne de caractères.
Since:
Release 1.0

toCharArray

public char[] toCharArray()
Cette méthode retourne un vecteur de caractères composé des caractères de la chaîne de caractères.

Returns:
array - Le vecteur de caractères.
Since:
Release 1.0

trim

public TString trim()
Cette méthode enlève les espaces des deux côtés de la chaîne de caractères.

Returns:
string - La chaîne modifiée.
Since:
Release 1.0