A classe IntlBreakIterator

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

Introdução

Um “iterador de quebra” é um objeto ICU que expõe métodos para localização de limites no texto (ex.: início/fim de palavras ou frases). A classe IntlBreakIterator do PHP serve como classe base para todos os tipos de iteradores de quebra ICU. Onde existir funcionalidade extra, a extensão Intl pode expor o iterador de quebra ICU com subclasses convenientes, como IntlRuleBasedBreakIterator ou IntlCodePointBreakIterator.

Esta classe implementa a interface IteratorAggregate. Percorrer um IntlBreakIterator produz valores inteiros não negativos que representam as localizações sucessivas dos limites do texto, expressos como contagem de unidades de código (bytes) UTF-8, tomadas do início do texto (que tem a localização 0). As chaves geradas pelo iterador formam simplesmente a sequência de números naturais {0, 1, 2, …}.

Resumo da 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étodos */

private __construct()

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

public static createCodePointInstance(): IntlCodePointBreakIterator

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

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

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

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

public current(): int

public first(): int

public following(int $offset): int

public getErrorCode(): int

public getErrorMessage(): string

public getLocale(int $type): string|false

public getPartsIterator(string $type = IntlPartsIterator::KEY_SEQUENTIAL): IntlPartsIterator

public getText(): ?string

public isBoundary(int $offset): bool

public last(): int

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

public preceding(int $offset): int

public previous(): int

public setText(string $text): bool

}

Constantes pré-definidas

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

Registro de Alterações

Versão	Descrição
8.0.0	IntlBreakIterator agora implementa IteratorAggregate. Anteriormente, Traversable era implementado.

Índice

IntlBreakIterator::__construct — Construtor privado para não permitir instanciação
IntlBreakIterator::createCharacterInstance — Cria um iterador de quebra para limites de sequências de combinação de caracteres
IntlBreakIterator::createCodePointInstance — Cria um iterador de quebra para limites de pontos de código
IntlBreakIterator::createLineInstance — Cria um iterador de quebra para quebras de linha logicamente possíveis
IntlBreakIterator::createSentenceInstance — Cria um iterador de quebra para separação de sentenças
IntlBreakIterator::createTitleInstance — Cria um iterador para quebras de letras de título
IntlBreakIterator::createWordInstance — Cria um iterador de quebra para separação de palavras
IntlBreakIterator::current — Obtém o índice da posição atual
IntlBreakIterator::first — Define a posição para o primeiro caractere no texto
IntlBreakIterator::following — Avança o iterador para o primeiro limite após o deslocamento especificado
IntlBreakIterator::getErrorCode — Obtém o último código de erro no objeto
IntlBreakIterator::getErrorMessage — Obtém a última mensagem de erro no objeto
IntlBreakIterator::getLocale — Obtém a localidade associada com o objeto
IntlBreakIterator::getPartsIterator — Cria um iterador para navegar por fragmentos entre limites
IntlBreakIterator::getText — Obtém o texto sendo percorrido
IntlBreakIterator::isBoundary — Indica se uma posição é um posição de limite
IntlBreakIterator::last — Define a posição do iterador para um índice além do último caractere
IntlBreakIterator::next — Avança o iterador para o próximo limite
IntlBreakIterator::preceding — Define a posição do iterador para o primeiro limite depois de um deslocamento
IntlBreakIterator::previous — Define a posição do iterador para o limite imediatamente anterior ao atual
IntlBreakIterator::setText — Define o texto a ser percorrido

add a note

User Contributed Notes 1 note

down

SenseException ¶

10 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