IntlChar::charFromName

(PHP 7, PHP 8)

IntlChar::charFromName — Encontra um caractere Unicode pelo nome e retorna seu valor de ponto de código

Descrição

public static IntlChar::charFromName(string $name, int $type = IntlChar::UNICODE_CHAR_NAME): ?int

Encontra um caractere Unicode pelo nome e retorna seu valor de ponto de código.

O nome deve corresponder de forma exata e completa. Se o nome não corresponder a um ponto de código, null é retornado.

Um nome Unicode 1.0 é correspondido somente se ele for diferente do nome moderno. Os nomes Unicode são todos em letras maiúsculas. Nomes estendidos são em letras minúsculas seguidos por um número hexadecimal em maiúsculas, e dentro de colchetes angulares.

Parâmetros

name

Nome completo do caractere Unicode.

type

Informa qual deve ser o conjunto de nomes usados na pesquisa. Pode ser uma destas constantes:

IntlChar::UNICODE_CHAR_NAME (padrão)
IntlChar::UNICODE_10_CHAR_NAME
IntlChar::EXTENDED_CHAR_NAME
IntlChar::CHAR_NAME_ALIAS
IntlChar::CHAR_NAME_CHOICE_COUNT

Valor Retornado

O valor Unicode do ponto de código do nome fornecido (como um int), ou null se não houver tal ponto de código.

Exemplos

Exemplo #1 Testando diferentes pontos de código

<?php
var_dump(IntlChar::charFromName("LATIN CAPITAL LETTER A"));
var_dump(IntlChar::charFromName("SNOWMAN"));
var_dump(IntlChar::charFromName("RECYCLING SYMBOL FOR TYPE-1 PLASTICS"));
var_dump(IntlChar::charFromName("UM TEXTO ALEATÓRIO QUE NÃO CORRESPONDE A NENHUM CARACTERE UNICODE"));
?>

O exemplo acima produzirá:

int(65)
int(9731)
int(9843)
NULL

Veja Também

IntlChar::charName() - Obtém o nome de um caractere Unicode
IntlChar::enumCharNames() - Enumera todos os caracteres Unicode atribuídos dentro de um intervalo

add a note

User Contributed Notes 1 note

down

Daniel Klein ¶

5 years ago


This function returns null on failure, not false.

add a note