La clase IntlBreakIterator

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

Introducción

Un “iterador de ruptura” es un objeto ICU que expone métodos para localizar los límites de un texto (p.ej. límites de palabra o sentencia). La clase IntlBreakIterator de PHP sirve como la clase base para todos los tipos de iteradores de ruptura de ICU. Donde esté disponible funcionalidad extra, la extensión intl puede exponer el iterador de ruptura de ICU con subclases aptas, como IntlRuleBasedBreakIterator o IntlCodePointBreaIterator.

Esta clase implementa Traversable. Recorrer un IntlBreakIterator produce valores enteros no negativos que representan las ubicaciones sucesibas de los límites del texto, expresados como unidades de código UTF-8 (byte), tomados del inicio del texto (que tienen la ubicación 0). Las claves producidas pord el iterador simplemente forman la secuencia de números naturales {0, 1, 2, …}.

Sinopsis de la Clase

class IntlBreakIterator implements Traversable {

/* Constantes */

const integer DONE = -1;

const integer WORD_NONE = 0;

const integer WORD_NONE_LIMIT = 100;

const integer WORD_NUMBER = 100;

const integer WORD_NUMBER_LIMIT = 200;

const integer WORD_LETTER = 200;

const integer WORD_LETTER_LIMIT = 300;

const integer WORD_KANA = 300;

const integer WORD_KANA_LIMIT = 400;

const integer WORD_IDEO = 400;

const integer WORD_IDEO_LIMIT = 500;

const integer LINE_SOFT = 0;

const integer LINE_SOFT_LIMIT = 100;

const integer LINE_HARD = 100;

const integer LINE_HARD_LIMIT = 200;

const integer SENTENCE_TERM = 0;

const integer SENTENCE_TERM_LIMIT = 100;

const integer SENTENCE_SEP = 100;

const integer SENTENCE_SEP_LIMIT = 200;

/* Métodos */

private __construct()

public static createCharacterInstance(string $"locale" = ?): ReturnType

public static createCodePointInstance(): ReturnType

public static createLineInstance(string $"locale" = ?): ReturnType

public static createSentenceInstance(string $"locale" = ?): ReturnType

public static createTitleInstance(string $"locale" = ?): ReturnType

public static createWordInstance(string $"locale" = ?): ReturnType

public current(): ReturnType

public first(): ReturnType

public following(string $"offset"): ReturnType

public getErrorCode(): ReturnType

intl_get_error_code(): ReturnType

public getErrorMessage(): ReturnType

intl_get_error_message(): ReturnType

public getLocale(string $"locale_type"): ReturnType

public getPartsIterator(string $"key_type" = ?): ReturnType

public getText(): ReturnType

public isBoundary(string $"offset"): ReturnType

public last(): ReturnType

public next(string $"offset" = ?): ReturnType

public preceding(string $"offset"): ReturnType

public previous(): ReturnType

public setText(string $"text"): ReturnType

}

Constantes predefinidas

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

Tabla de contenidos

IntlBreakIterator::__construct — Constructor privado para denegar la instanciación
IntlBreakIterator::createCharacterInstance — Crear un iterador de ruptura para los límites de secuencias de caracters combinados
IntlBreakIterator::createCodePointInstance — Crear un iterador de ruptura para los límites de puntos de código
IntlBreakIterator::createLineInstance — Crear un iterador de ruptura para las lógicamente posibles saltos de línea
IntlBreakIterator::createSentenceInstance — Crear un iterador de ruptura para rupturas de sentencias
IntlBreakIterator::createTitleInstance — Crear un iterador de ruptura para rupturas de marcos de título
IntlBreakIterator::createWordInstance — Crear un iterador de ruptura para ruptura de palabras
IntlBreakIterator::current — Obtiene el índice de la posición actual
IntlBreakIterator::first — Coloca la posición al primer caracter en el texto
IntlBreakIterator::following — Avanza el iterador al primer límite siguiendo un offset específico
IntlBreakIterator::getErrorCode — Obtener el código del último error del objeto
IntlBreakIterator::getErrorMessage — Obtener el último mensaje de error del objeto
IntlBreakIterator::getLocale — Obtiene el locale asociado al objeto
IntlBreakIterator::getPartsIterator — Crear un iterador para fragmentos de navegación entre límites
IntlBreakIterator::getText — Obtiene el texto que está siendo escaneado
IntlBreakIterator::isBoundary — Indicar si un índice es un índice de límites
IntlBreakIterator::last — Establecer la posición del iterador al índice tras el último carácter
IntlBreakIterator::next — Avanzar el iterador al siguiente límite
IntlBreakIterator::preceding — Establecer la posición del iterador al primer límite antes de un índice
IntlBreakIterator::previous — Establecer la posición del iterador al límite inmediatamente anterior al actual
IntlBreakIterator::setText — Establecer el texto a escanear

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