IntlChar::toupper

(PHP 7, PHP 8)

IntlChar::toupper — Transforma um caractere Unicode em maiúscula

Descrição

public static IntlChar::toupper(int|string $codepoint): int|string|null

O caractere fornecido é mapeado para seu equivalente maiúsuculo. Se o caractere não tiver equivalente maiúsculo, o próprio caractere é retornado.

Parâmetros

codepoint

O valor int do ponto de código (por exemplo, 0x2603 para U+2603 SNOWMAN) ou o caractere codificado como uma string UTF-8 (por exemplo, "\u{2603}").

Valor Retornado

Retorna o mapeamento Simple_Uppercase_Mapping do ponto de código, se houver; caso contrário o próprio ponto de código.

O tipo do retorno é int, a menos que o ponto de código tenha sido passado como uma string UTF-8, caso em que uma string é retornada. Retorna null em caso de falha.

Exemplos

Example #1 Testando diferentes pontos de código

<?php
var_dump(IntlChar::toupper("A"));
var_dump(IntlChar::toupper("a"));
var_dump(IntlChar::toupper("Φ"));
var_dump(IntlChar::toupper("φ"));
var_dump(IntlChar::toupper("1"));
var_dump(IntlChar::toupper(ord("A")));
var_dump(IntlChar::toupper(ord("a")));
?>

O exemplo acima produzirá:

string(1) "A"
string(1) "A"
string(2) "Φ"
string(2) "Φ"
string(1) "1"
int(65)
int(65)

Veja Também