String.fromCharCode()

Sintaxe

String.fromCharCode(num1[, ...[, numN]])

Parâmetros

num1, ..., numN

Uma sequência de números que devem ser valores UTF-16. O tamanho é entre 0 e 65535 (0xFFFF). Números maiores do que 0xFFFF são desconsiderados. Nenhuma verificação de vadalida é realizada.

Valor retornado

Uma string contendo os caracteres correspondentes à sequência de valores Unicode.

Descrição

Esse método retorna uma string e não um objeto String.

Como fromCharCode() é um método estático de String, você sempre o usará como String.fromCharCode(), ao invés de um método de um objeto String que você tenha criado.

Exemplos

Usando fromCharCode()

O seguinte exemplo retorna a string "ABC".

String.fromCharCode(65, 66, 67); // retorna "ABC"

Fazendo-o funcionar com valores maiores

Embora os valores Unicode mais comuns possam ser representados com um número de 16 bits (como esperado durante a padronização do JavaScript) e o fromCharCode() possa ser usado para retornar um único caracter dos valores mais comuns (por exemplo: valores UCS-2 que são os melhores subconjuntos do UTF-16 com os caractres mais comuns), a fim de resolver TODOS os valores Unicode legais (até 21 bits) o método fromCharCode() sozinho é inadequado. Como os caracteres de ponto de código mais alto usam 2 (valor menor) numeros "substitutos" para formar um único caracter, String.fromCodePoint() (parte do padrão ES2015) pode ser usado para retornar tal par e ainda representar adequadamente esses caracteres de valores altos.

Especificações

Navegadores compatíveis

Veja também

• String.fromCodePoint()
• String.prototype.charAt()
• String.prototype.charCodeAt()
• String.prototype.codePointAt()