Classes de référence du Smalltalk Squeak

From OFSET Wiki

Traduction de Squeak Smalltalk: Classes Reference

[edit] Classes et méthodes fondamentales

[edit] Classe Object (opérations qui concernent tous les objets)

[edit] Création d’instances (méthode de classe)

Notes :

• [1] - Le corps d’une méthode new est généralement ^super new. N’oubliez pas de le taper côté classe, et d’inclure le signe ^. Attention à utiliser super, et non self !
• [2] - Vous ne devez pas implémenter new si cela n’a pas de sens. Consultez par exemple Boolean class>>new ou MappedCollection class>>new
• [3] - basicNew est là pour vous permettre de continuer à produire des instances même si une superclasse a redéfini new. Vous ne devez donc jamais redéfinir basicNew tant que vous n’êtes pas devenu un gourou Squeak.
• [4] - Si vous avez besoin d’un paramètre autre que la taille, choisissez un nom plus évocateur que new: vous trouverez un exemple dans le protocole de création d’instances pour les classes Pen et Rectangle.

[edit] Comparer des objets

Notes :

• [1] - Normalement, aucune autre classe ne devrait redéfinir == et ~~ .
• [2] - Comme certaines classes (Set et Dictionary en particulier) utilisent le fait que hash renvoie la même valeur pour des objets égaux, vous devriez redéfinir hash chaque fois que vous redéfinissez =. (a=b) implique forcément (a hash = b hash). La réciproque n'est en général pas vraie.

[edit] Tester des objets

Notes :

• [1] - unObjet isNil est préférable à unObjet == nil ; de même pour unObjet notNil et unObjet ~~ nil.
• [2] - unObjet ifNil: [...] est préférable à unObjet isNil ifTrue: [...]
• [3] - ifNotNilDo: unBloc est utile lorsque le receveur est une expression complexe, par exemple :

self filsGauche filsDroit ifNotNilDo: [:noeud | noeud equilibrer]

[edit] Copier des objets

[edit] Envoyer des messages aux objets

Note :

• [1] - Avec Squeak, un objet reconnait aussi #perform:with:with: et #perform:with:with:with, qui sont des spécialisations de #perform:withArguments: pour des tableaux de deux ou trois éléments.

[edit] Indexer des objets

[edit] Afficher et enregistrer des objets

[edit] Interroger des objets

[edit] Messages divers auxquels répondent les objets

Notes :

• [1] - Le message yourself (littéralement: toi-même) est essentiellement utilisé comme dernier message dans une cascade, lorsque l'avant-dernier message renvoie un objet autre que le receveur. Par exemple, #(1 2 3 5) at: 4 put: 4 revoie 4, l'objet qui a été rangé, alors que #(1 2 3 5) at: 4 put: 4; yourself renvoie #(1 2 3 4), le receveur.
• [2] - self halt est la méthode usuelle pour forcer l'ouverture du débogueur. L'exécution peut ensuite reprendre.

[edit] Classe Boolean

Cette classe abstraite représente les valeurs logique et fournit des opérateur booléens ainsi que des structures de contrôle conditionnelles. Elle a deux sous-classes, True et False, chacune d'entre elles disposant d'instances singletons représentées par les mots-clefs true (vrai) et false (faux) respectivement.

[edit] Opérateurs booléens évaluant et non-évaluant

[edit] Classe Magnitude

Cette classe abstraite regroupe, entre autres classes, les nombres (Numbers), les caractères (Characters), les dates et l'heure (Date et Time). Elle sert à toutes les classes dont les instances peuvent être ordonnées linéairement.

[edit] Classe Character

Squeak utilise son propre jeu de 256 caractères, qui peut différer de celui de la plateforme hôte. Les instances de la classe Character contiennent un code de caractère codé en 8 bits.

• Les caractères entre 0 et 127 sont ceux correspondant à la norme ASCII, à part quelques exceptions: la flèche d'affectation remplace le tiret bas (underscore), et les caractères pour enter, insert (insertion), page up (page haut), page down (page bas), home (début) et les quatre flèches de direction remplacent certains caractères ASCII. Ces caractères sont accessibles sous Squeak en utilisant des méthodes de la classe Character.
• Les caractères entre 128 et 255 ne sont pas tous affectés. Divers symboles tels les puces, marques déposées (TM), copyrights (c), cents, euros et yen, diphtongues et un certain nombre de caractères accentués ainsi que l'espace insécable (caractère nbsp) correspondent au codage sous Macintosh, mais ils ne sont pas tous présents.
• Le jeu de caractères complet peut être visualisé en effectuant un printIt sur Character allCharacters.

[edit] Méthodes pour créer des instances (côté classe)

La plupart du temps, les caractères littéraux $a, $b, etc. sont utilisés de préférence aux méthodes de classe. Les exceptions notables sont dues aux caractères non imprimables listés ci-dessous. Un programme ne devrait jamais avoir à dépendre des détails d'encodage des caractères.

Note :

• [1] - L'invariant (Character value: n) asciiValue = n est vrai pour tout entier dans l'intervalle [0..255].

[edit] Méthodes pour accéder aux caractères

Note :

• [1] - Les instances de la classe Character ont une propriété d'unicité: les instances égales (au sens de "=") sont identiques (au sens de "=="). C'est-à-dire a asciiValue == b asciiValue si et seulement si a == b.

[edit] Méthodes pour tester les caractères

[edit] Méthodes de conversion de caractères

[edit] Classes et méthodes des nombres

[edit] Classe Number

Cette classe abstraite regroupe les entiers (Integer), les réels à virgule flottante (Float) et les fractions (Fraction). Number est une sous-classe de Magnitude.

[edit] Méthodes arithmétiques pour toutes les classes numériques

[edit] Méthodes implémentant les fonction mathématiques sur les nombres

[edit] Méthodes pour tester des nombres

[edit] Méthodes pour tronquer et arrondir les nombres

[edit] Méthodes pour la trigonométrie sur les nombres

[edit] Classe Integer

[edit] Méthodes pour l'arithmétique sur les entiers

[edit] Méthodes de manipulation de bits sur les entiers

Une panoplie d'opérateurs de manipulation de bits est disponible sur les entiers. Ils ne sont que rarement utilisés cependant, et ne sont par conséquent pas décrits ici. Il est possible de les examiner à l'aide d'un navigateur de classes.

[edit] Classes et méthodes des collections

[edit] La hiérarchie des collections

[edit] Classe Collection

[edit] Méthodes pour créer des collections (côté classe)

[edit] Méthodes pour tester les collections

[edit] Méthodes pour ajouter ou retirer des éléments d'une collection

[edit] Méthodes pour énumérer les collections

Note :

• [1] - Par exemple, pour calculer la somme des éléments d'une collection de nombres, utiliser uneCollection inject: 0 into: [:sousTotal :prochain | sousTotal + prochain].

[edit] Classe Bag

[edit] Méthodes pour accéder aux sacs (Bag)

[edit] Classes Dictionary et IdentityDictionary

[edit] Méthodes pour accéder aux dictionnaires

Les dictionnaires sont des ensembles (Set) homogènes de paires clef/valeur. Ces paires sont appelées des associations (type Association); les clefs et les valeurs peuvent être d'un type quelconque. Une association est crée en envoyant le message binaire clef -> valeur (-> est défini dans Object). Une propriété des dictionnaires est qu'une clef ne peut s'y trouver qu'une fois. Les IdentityDictionnary partagent cette propriété, mais déterminent l'unicité d'une clef en utilisant l'opérateur == plutôt que =. Pour tout usage ordinaire, les deux types de dictionnaires sont indexés en utilisant ces clefs uniques pour obtenir les valeurs correspondantes.

[edit] Collections séquentielles

[edit] Méthodes pour accéder aux collections séquentielles

[edit] Méthodes pour copier les collections séquentielles

Note :

• [1] - Par exemple, avec [:a :b | a > b], le tri se fait par ordre décroissant.

[edit] Méthodes pour énumérer les collections séquentielles

[edit] Collections ordonnées

[edit] Méthodes pour accéder aux collections ordonnées

[edit] Chaînes de caractères

Les chaînes de caractères (String) forment une classe intimidante, construite au fil du temps d'une manière ad hoc. Nous ne décrivons ici qu'une petite partie des méthodes disponibles (il y en a environ 300 !).

[edit] Méthodes pour accéder chaînes de caractères

Note :

• [1] - Tout comme pour #indexOf:, il y a des variations sur ce message: #indexOfAnyOf:ifAbsent:, #indexOfAnyOf:startingAt: et #indexOfAnyOf:startingAt:ifAbsent:.

[edit] Méthodes pour comparer des chaînes de caractères

Méthodes pour convertir des chaînes de caractères

[edit] Classes et méthodes des flots de données

[edit] La hiérarchie des flots de données

[edit] Classe Stream

Stream (flots de données) est une classe abstraite faisant office d'accesseur pour une séquence d'objets, appelés le contenu. On dit qu'on "avance" le long du flot lorsque celui-ci est configuré pour accéder à un des élément suivants du contenu.

[edit] Méthodes pour accéder aux flots

[edit] Méthodes pour tester les flots

[edit] Méthodes pour énumérer les flots

[edit] Classe PositionableStream

Un flot positionnable est une classe abstraite pour accéder à une séquence d'objets énumérables par des indices, de façon à ce que le point d'accès puisse être repositionné. Les classes concrètes correspondantes, ReadStream, WriteStream et ReadWriteStream sont généralement utilisées pour instancier un PositionableStream sur une collection d'objets, selon le mode d'accès désiré. Les classes StandardFileStream et CrLfFileStream sont quand à elles utilisées pour instancier des flots positionnables sur des fichiers.

[edit] Méthodes pour accéder à des flots positionnables

Note :

• [1] - Par exemple: "Ceci "" est un guillemet", où terminaison = $". Les deux guillemets "" seront lus comme un seul ", mais ne seront pas considérés comme une terminaison.

[edit] Messages pour tester des flots positionnables

[edit] Méthodes pour positionner les flots

[edit] Classe WriteStream

[edit] Méthodes pour écrire des caractères

[edit] Exceptions compatibles ANSI

[edit] Évaluer des bloc avec des exceptions

[edit] Méthodes pour traiter les exceptions déclenchées dans un contexte de bloc (BlocContext)

[edit] Exemples

["code cible, qui peut échouer"]
    ensure:
        ["code qui sera systématiquement évalué
          après le code cible,
          quoiqu'il puisse advenir"]

["code cible, qui peut échouer"]
    ifCurtailed:
        ["code qui sera exécuté si
          et seulement si le code cible
          échoue de manière anormale"]

["code cible, qui peut échouer"]
    on: Exception
    do: [ :exception |
            "code qui sera exécuté si et seulement si 
             l'exception Exception est déclenchée"]

[edit] Classe Exception

Exception est une classe abstraite; aucune instance ne devrait être créée ou attrapée (par unBloc on: Exception do: [...]). Il y a deux sous-classes usuelles d'Exception, Error et Notification, desquelles toutes les sous-classes descendent en général. L'exécution après une erreur ne peut pas être reprise; une notification indique qu'un événement intéressant s'est produit; s'il n'est pas traité, il sera ignoré sans aucun effet.

Les exceptions ont un double but: pour définir les exceptions elles-mêmes, et pour filtrer lors du traitement des exceptions.

[edit] Méthodes pour décrire des exceptions

[edit] Méthodes pour signaler des exceptions

[edit] Méthodes pour traiter une exception signalée

[edit] Classe ExceptionSet

Un ensemble d'exceptions (ExceptionSet) est utilisé pour spécifier un ensemble d'exception à filtrer pour un gestionnaire d'exceptions.

[