Miscellaneous

All Known Implementing Classes:

Program
```
public interface Miscellaneous
```
Documentation des primitives disponibles en iJava

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method and Description
`char`	`charAt( String s, int idx)` Retourne le caractère de la chaîne `s` situé à l'indice `idx`.
`int`	`compare( String s1, String s2)` Compare deux chaînes de caractères selon l'ordre lexicographique (ie.
`boolean`	`equals( String s1, String s2)` Test l'égalité de deux chaînes de caractères.
`int`	`length( Object tab)` Retourne la taille (ie. le nombre de cases) du tableau `tab`.
`int`	`length( Object tab, int dim)` Retourne la taille (ie. le nombre de cases) de la dimension `dim` du tableau `tab`.
`int`	`length( String s)` Retourne le nombre de caractères que contient une chaîne de caractères.
`String`	`substring( String s, int start, int end)` Retourne une sous-chaîne copiée dans la chaîne `s` à partir de l'indice `start` inclus à l'indice `end` exclus.
`String`	`toLowerCase( String s)` Transforme l'ensemble des caractères d'une chaîne en minuscules (enfin, si tous les caractères sont des lettres !).
`String`	`toUpperCase( String s)` Transforme l'ensemble des caractères d'une chaîne en majuscules (enfin, si tous les caractères sont des lettres !).

- Method Detail
  - equals
```
boolean equals( String s1,
                String s2)
```
    Test l'égalité de deux chaînes de caractères. Attention, le langage Java est sensible à la casse (ie. à la différence entre une lettre minuscule et une lettre majuscule).
    
    Note:L'écriture if (s1 == s2), bien que ne provoquant pas d'erreur de compilation peut donner un résultat contraire à l'intuition (cela revient à comparer les contenants et pas les contenus ...).
    
    Parameters:
    
    s1 - la première chaîne à comparer.
    
    s2 - la deuxième chaîne à comparer.
    
    Returns:
    
    true si s1 et s2 sont identiques et false sinon.
  - toUpperCase
```
 String toUpperCase( String s)
```
    Transforme l'ensemble des caractères d'une chaîne en majuscules (enfin, si tous les caractères sont des lettres !). Le paramètre s n'est pas modifié sauf explicitement par une écriture de la forme s = toUpperCase(s) ;.
    
    Parameters:
    
    s - la chaîne à transformer en majuscules.
    
    Returns:
    
    une nouvelle chaîne de caractères ne contenant que des lettres majuscules (enfin, si il n'y avait que des lettres minuscules !).
  - toLowerCase
```
 String toLowerCase( String s)
```
    Transforme l'ensemble des caractères d'une chaîne en minuscules (enfin, si tous les caractères sont des lettres !). Le paramètre s n'est pas modifié sauf explicitement par une écriture de la forme s = toLowerCase(s) ;.
    
    Parameters:
    
    s - la chaîne à transformer en minuscules.
    
    Returns:
    
    une nouvelle chaîne de caractères ne contenant que des lettres minuscules (enfin, si il n'y avait que des lettres majuscules !).
  - compare
```
int compare( String s1,
             String s2)
```
    Compare deux chaînes de caractères selon l'ordre lexicographique (ie. celui de l'alphabet) et retourne un entier:
    - nul si les deux chaînes sont égales,
    - négatif si la chaîne s1 se place après la chaîne s2 selon l'ordre lexicographique,
    - positif si la chaîne s1 se place avant la chaîne s2 selon l'ordre lexicographique.
    L'ordre lexicographique est celui utilisé dans les dictionnaires, c'est l'ordre alphabétique des caractères, l'ordre des caractères de gauche étant prioritaires sur ceux de droite ("AB" < "BA") . Si un mot est le début d'un autre il est placé avant ("BA" < "BABAR").
    Parameters:
    
    s1 - la première chaîne à comparer.
    
    s2 - la deuxième chaîne à comparer.
    
    Returns:
    
    0 si s1 et s2 sont identiques, un nombre négatif si s1 est plus petit que s2 et un nombre positif sinon.
  - length
```
int length( String s)
```
    Retourne le nombre de caractères que contient une chaîne de caractères.
    
    Parameters:
    
    s - la chaîne de caractères dont on souhaite connaître le nombre de caractères.
    
    Returns:
    
    le nombre de caractères composant la chaîne s (et 0 si s est la chaîne vide).
  - substring
```
 String substring( String s,
                           int start,
                           int end)
```
    Retourne une sous-chaîne copiée dans la chaîne s à partir de l'indice start inclus à l'indice end exclus. Attention, le premier caractère de la chaîne se trouve à l'indice 0 (et donc, le dernier indice valide est la longueur de la chaîne moins un !).
    Si l'un des paramètres fournis est négatif ou supérieur à la longueur de la chaîne d'origine, une erreur StringIndexOutOfBoundsException se produit et le programme s'interrompt.
    Exemple: substring("ABCDEF", 2, 4) calculera "CDE".
    Exemple: substring("ABCDEF", 2, 6) calculera "CDE".
    Exemple: substring("ABCDEF", 2, 7) provoquera une erreur.
    note: Même si substring("ABCDEF", 2, 3) retourne "C", le résultat a pour type chaîne de caractère et non caractère. La fonction charAt( String, int) fournit un résultat de type caractère.
    
    Parameters:
    
    s - la chaîne dont on souhaite copier une partie.
    
    start - l'indice de début d'extraction (inclus).
    
    end - l'indice de fin d'extraction (exclus).
    
    Returns:
    
    une copie de la chaîne s contenant les caractères situés entre les indices start et end-1.
  - charAt
```
char charAt( String s,
            int idx)
```
    Retourne le caractère de la chaîne s situé à l'indice idx. Attention, le premier caractère d'une chaîne se trouve à l'indice 0 !
    Si la position fournie est négative ou supérieure ou égale à la taille de la chaîne, une erreur StringIndexOutOfBoundsException se produit.
    Exemple: charAt("ABCDEF", 1 fournira la valeur 'B' (de type caractère (ie. char).
    
    Parameters:
    
    s - la chaîne dont on souhaite copier un caractère.
    
    idx - l'indice du caractère que l'on souhaite copier.
    
    Returns:
    
    le caractère situé à l'indice idx dans la chaîne s.
  - length
```
int length( Object tab,
           int dim)
```
    Retourne la taille (ie. le nombre de cases) de la dimension dim du tableau tab. Cette fonction peut s'appliquer à tous les types manipulés en S1 (byte, short, int, long, float, double, boolean, char, String, ainsi que les types définis dans les extensions).
    
    Parameters:
    
    tab - le tableau dont on souhaite connaître le nombre de cases.
    
    dim - la dimension dont on souhaite connaître le nombre de cases.
    
    Returns:
    
    le nombre de cases de la dimension dim du tableau tab.
  - length
```
int length( Object tab)
```
    Retourne la taille (ie. le nombre de cases) du tableau tab. Cette fonction ne peut s'appliquer que sur les tableaux à une dimension ... mais accepte tous les types manipulés en S1 (byte, short, int, long, float, double, boolean, char, String, ainsi que les types définis dans les extensions).
    
    Parameters:
    
    tab - le tableau dont on souhaite connaître le nombre de cases.
    
    Returns:
    
    le nombre de cases du tableau tab.

Interface Miscellaneous

Method Summary

Method Detail

equals

toUpperCase

toLowerCase

compare

length

substring

charAt

length

length