Mostrar tudo

Ocultar tudo

Devolve um número inteiro (tipo de dados Número inteiro: tipo de dados fundamental que contém números inteiros. Uma variável Número inteiro é armazenada como um número de 16 bits (2-bytes) que varia entre -32.768 e 32.767.) que representa o código de carácter (código do carácter: número que representa um determinado carácter num conjunto como, por exemplo, o conjunto de caracteres ANSI.) correspondente à primeira letra de uma cadeia.

Sintaxe

Asc(cadeia)

O argumento (argumento: valor que fornece informações a uma acção, evento, método, propriedade, função ou procedimento.) cadeia obrigatório é qualquer cadeia de expressão (expressão de cadeia: expressão que equivale a uma sequência de caracteres contíguos. Os elementos da expressão podem ser: funções que devolvem uma cadeia ou uma Variante de cadeia (VarType 8); uma cadeia literal, uma constante, uma variável ou Variante.) válida. Se a cadeia não incluir caracteres, ocorre um erro de tempo de execução (erro durante a execução: erro que pode ser detectado apenas quando uma aplicação estiver a ser executada.).

Observações

O intervalo de valores devolvidos é de 0 a 255 em sistemas não DBCS e de 32768 a 32767 em sistemas DBCS (DBCS: conjunto de caracteres que utiliza 1 ou 2 bytes para representar um carácter, permitindo a representação de mais de 256 caracteres.).

 Nota   A função AscB é utilizada com dados de tipo byte incluídos numa cadeia. Em vez de devolver o código de carácter do primeiro carácter, a função AscB devolver o primeiro byte. A função AscW devolve o código de carácter de Unicode (Unicode: norma de codificação de caracteres desenvolvida pela Unicode Consortium. Ao utilizar mais do que um byte para representar cada carácter, o Unicode permite que quase todos os idiomas escritos do mundo sejam representados através da utilização de um único conjunto de caracteres.), excepto em plataformas que não suportam Unicode. Neste caso, o comportamento é idêntico ao da função Asc.

 Nota    O Visual Basic para Macintosh não suporta cadeias Unicode. Por esse motivo, não é possível à função AscW(n) devolver todos os caracteres Unicode para os valores n no intervalo de 128 a 65.535, como acontece no ambiente Windows. Em vez disso, a função AscW(n) tenta "adivinhar" os valores de Unicode n maiores que 127. Por conseguinte, não deverá utilizar a função AscW num ambiente Macintosh.

Exemplo

 Nota   Os exemplos que se seguem demonstram a utilização desta função num módulo do Visual Basic for Applications (VBA). Para mais informações sobre como trabalhar com VBA, seleccione Referência para Programadores na lista pendente junto a Procurar e introduza um ou mais termos na caixa de procura.

Este exemplo utiliza a função Asc para devolver um código de carácter correspondente à primeira letra da cadeia.

Dim MyNumber
MyNumber = Asc("A")        ' Returns 65.
MyNumber = Asc("a")        ' Returns 97.
MyNumber = Asc("Apple")    ' Returns 65.