La classe IntlBreakIterator

(PHP 5 >= 5.5.0, PHP 7, PHP 8)

Introduction

Un "délimiteur de rupture" est un objet ICU qui expose des méthodes pour localiser des délimitations dans du texte (par exemple, des délimitations de mots ou de phrases). La classe IntlBreakIterator de PHP sert de classe de base pour tous les types de délimiteurs de rupture ICU. Lorsqu'une fonctionnalité supplémentaire est disponible, l'extension intl peut exposer le délimiteur de rupture ICU avec des sous-classes appropriées, telles que IntlRuleBasedBreakIterator ou IntlCodePointBreakIterator .

Cette classe implémente IteratorAggregate . Parcourir un IntlBreakIterator produit des valeurs entières non négatives représentant les emplacements successifs des délimitations de texte, exprimées en tant que comptes d'unités de code UTF-8 (octets), pris depuis le début du texte (qui a l'emplacement 0). Les clés produites par l'itérateur forment simplement la séquence de nombres naturels {0, 1, 2, ...}.

Synopsis de la classe

class IntlBreakIterator implements IteratorAggregate {

/* Constantes */

public const int DONE ;

public const int WORD_NONE ;

public const int WORD_NONE_LIMIT ;

public const int WORD_NUMBER ;

public const int WORD_NUMBER_LIMIT ;

public const int WORD_LETTER ;

public const int WORD_LETTER_LIMIT ;

public const int WORD_KANA ;

public const int WORD_KANA_LIMIT ;

public const int WORD_IDEO ;

public const int WORD_IDEO_LIMIT ;

public const int LINE_SOFT ;

public const int LINE_SOFT_LIMIT ;

public const int LINE_HARD ;

public const int LINE_HARD_LIMIT ;

public const int SENTENCE_TERM ;

public const int SENTENCE_TERM_LIMIT ;

public const int SENTENCE_SEP ;

public const int SENTENCE_SEP_LIMIT ;

/* Méthodes */

private function __construct ()

public static function createCharacterInstance (? string $locale = null ): ? IntlBreakIterator

public static function createCodePointInstance (): IntlCodePointBreakIterator

public static function createLineInstance (? string $locale = null ): ? IntlBreakIterator

public static function createSentenceInstance (? string $locale = null ): ? IntlBreakIterator

public static function createTitleInstance (? string $locale = null ): ? IntlBreakIterator

public static function createWordInstance (? string $locale = null ): ? IntlBreakIterator

public function current (): int

public function first (): int

public function following (int $offset): int

public function getErrorCode (): int

public function getErrorMessage (): string

public function getLocale (int $type): string |false

public function getPartsIterator (int $type = IntlPartsIterator::KEY_SEQUENTIAL ): IntlPartsIterator

public function getText (): ? string

public function isBoundary (int $offset): bool

public function last (): int

public function next (? int $offset = null ): int

public function preceding (int $offset): int

public function previous (): int

public function setText (string $text): bool

}

Constantes pré-définies

IntlBreakIterator::DONE int
IntlBreakIterator::WORD_NONE int
IntlBreakIterator::WORD_NONE_LIMIT int
IntlBreakIterator::WORD_NUMBER int
IntlBreakIterator::WORD_NUMBER_LIMIT int
IntlBreakIterator::WORD_LETTER int
IntlBreakIterator::WORD_LETTER_LIMIT int
IntlBreakIterator::WORD_KANA int
IntlBreakIterator::WORD_KANA_LIMIT int
IntlBreakIterator::WORD_IDEO int
IntlBreakIterator::WORD_IDEO_LIMIT int
IntlBreakIterator::LINE_SOFT int
IntlBreakIterator::LINE_SOFT_LIMIT int
IntlBreakIterator::LINE_HARD int
IntlBreakIterator::LINE_HARD_LIMIT int
IntlBreakIterator::SENTENCE_TERM int
IntlBreakIterator::SENTENCE_TERM_LIMIT int
IntlBreakIterator::SENTENCE_SEP int
IntlBreakIterator::SENTENCE_SEP_LIMIT int

Historique

Version	Description
8.4.0	Les constantes de classe sont désormais typées.
8.0.0	IntlBreakIterator implémente désormais IteratorAggregate . Avant, Traversable était implémentée à la place.

Sommaire

IntlBreakIterator::__construct — Constructeur privé pour désactiver l'instantiation
IntlBreakIterator::createCharacterInstance — Crée un itérateur pour les limites des séquences de caractères combinés
IntlBreakIterator::createCodePointInstance — Crée un itérateur pour les limites de points de code
IntlBreakIterator::createLineInstance — Crée un itérateur pour les coupures de lignes
IntlBreakIterator::createSentenceInstance — Crée un itérateur pour les coupures de phrase
IntlBreakIterator::createTitleInstance — Crée un itérateur
IntlBreakIterator::createWordInstance — Crée un itérateur pour les coupures de mot
IntlBreakIterator::current — Récupère l'index de la position courante
IntlBreakIterator::first — Définit la position au premier caractère du texte
IntlBreakIterator::following — Avance l'itérateur à la première limite suivant la position spécifiée
IntlBreakIterator::getErrorCode — Récupère le code de la dernière erreur survenue sur l'objet
IntlBreakIterator::getErrorMessage — Récupère le message de la dernière erreur survenue sur l'objet
IntlBreakIterator::getLocale — Récupère la locale associée avec l'objet
IntlBreakIterator::getPartsIterator — Crée un itérateur pour naviguer dans les fragments entre les limites
IntlBreakIterator::getText — Récupère le texte analysé
IntlBreakIterator::isBoundary — Indique si une position est une position limite
IntlBreakIterator::last — Définit la position de l'itérateur à l'index après le dernier caractère
IntlBreakIterator::next — Avance l'itérateur à la prochaine limite
IntlBreakIterator::preceding — Définit la position de l'itérateur à la première limite avant la position
IntlBreakIterator::previous — Définit la position de l'itérateur à la limite immédiate avant la courante
IntlBreakIterator::setText — Définit le texte à analyser

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

+add a note

User Contributed Notes 1 note

down

SenseException ¶

12 years ago

Since there is no excample for the usage of the IntlBreakIterator yet, I made a small one:
<?php
$text = "Si contano i danni. Un morto a Roma, un treno ".
"deragliato e quattro feriti a Foggia, strade chiuse in tutto ".
"il sud, allagamenti e danni sulla costa ionica. A Pescara, ".
"1.500 sfollati per l'esondazione del Fosso Vallelunga. ".
"Dall'inizio dell'anno l'agricoltura ha subito un miliardo ".
"di euro di danni.";
$locale = 'it_IT';
$i = IntlBreakIterator::createSentenceInstance($locale);
$i->setText($text);
foreach($i->getPartsIterator() as $sentence) {
 echo $sentence . PHP_EOL . '----- next -----' . PHP_EOL;
}
?>

Result:
Si contano i danni. 
----- next -----
Un morto a Roma, un treno deragliato e quattro feriti a Foggia, strade chiuse in tutto il sud, allagamenti e danni sulla costa ionica. 
----- next -----
A Pescara, 1.500 sfollati per l'esondazione del Fosso Vallelunga. 
----- next -----
Dall'inizio dell'anno l'agricoltura ha subito un miliardo di euro di danni.
----- next -----

+add a note