PHP 8.4.0 RC4 available for testing

IntlChar::enumCharNames

(PHP 7, PHP 8)

IntlChar::enumCharNamesEnumère tous les caractères Unicode assignés dans une plage

Description

public static IntlChar::enumCharNames(
    int|string $start,
    int|string $end,
    callable $callback,
    int $type = IntlChar::UNICODE_CHAR_NAME
): bool

Enumère tous les caractères Unicode assignés entre les points de code de début et de fin (inclusivement le début, exclusivement la fin) et appelle une fonction pour chacun, passant la valeur du point de code et le nom du caractère.

Pour les noms Unicode 1.0, seuls ceux qui diffèrent des noms modernes sont énumérés.

Liste de paramètres

start

Le premier point de code dans la plage d'énumération.

end

Un ou plusieurs points de code de plus que le dernier point de code dans la plage d'énumération (le premier après la plage).

callback

La fonction qui doit être appelée pour chaque nom de caractère. Les trois arguments suivants lui seront passés :

  • int $codepoint - La valeur numérique du point de code
  • int $nameChoice - La même valeur que le paramètre type ci-dessous
  • string $name - Le nom du caractère

type

Un sélecteur pour le type de noms à énumérer. Peut être une des constantes suivantes :

Valeurs de retour

Cette fonction retourne true en cas de succès ou false si une erreur survient.

Historique

Version Description
8.3.0 Cette méthode retourne maintenant false en cas d'échec ; précédemment elle retournait null.

Exemples

Exemple #1 Enumère une plage d'exemples de points de code

<?php
IntlChar
::enumCharNames(0x2600, 0x2610, function($codepoint, $nameChoice, $name) {
printf("U+%04x %s\n", $codepoint, $name);
});
?>

L'exemple ci-dessus va afficher :

U+2600 BLACK SUN WITH RAYS
U+2601 CLOUD
U+2602 UMBRELLA
U+2603 SNOWMAN
U+2604 COMET
U+2605 BLACK STAR
U+2606 WHITE STAR
U+2607 LIGHTNING
U+2608 THUNDERSTORM
U+2609 SUN
U+260a ASCENDING NODE
U+260b DESCENDING NODE
U+260c CONJUNCTION
U+260d OPPOSITION
U+260e BLACK TELEPHONE
U+260f WHITE TELEPHONE

Voir aussi

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top