outputDebugString

Escreve uma mensagem no console de debug.

Sintaxe

-- servidor
bool outputDebugString ( string mensagem [, number nivel = 3 ] )

-- cliente
bool outputDebugString ( string mensagem [, number nivel = 3, number r = 255, number g = 255, number b = 255 ] )

Parâmetros

Nome	Tipo	Padrão	Descrição
mensagem	string	—	Texto a registrar. Um número é convertido automaticamente; no cliente qualquer valor é, como faz o tostring.
nivel	number	3	Severidade da mensagem, de 0 a 4.
r, g, b	number	255	Só no cliente. Cor da linha nos níveis 0 e 4, cada um de 0 a 255. Ignorados nos outros níveis.

Nível	Servidor	Cliente
0	Erro.	Personalizado: sem prefixo, na cor r, g, b.
1	Erro.	Erro.
2	Aviso.	Aviso.
3	Informação.	Informação.
4	Informação.	Personalizado, como o 0.

No cliente uma mensagem com mais de 2047 caracteres é cortada nesse ponto.

Retorno

true quando a mensagem foi registrada. false, com um aviso, quando nivel está fora de 0–4 ou um argumento tem o tipo errado — no servidor isso inclui uma mensagem que não seja string nem número.

outputDebugString("conta carregada")
outputDebugString("configuração ausente, usando o padrão", 2)
outputDebugString("falha ao gravar o arquivo", 1)

O console prefixa a linha com o lugar de onde a chamada saiu, no formato resource/arquivo.lua:linha:, então você não precisa colocar isso na mensagem. Um script emprestado nomeia o resource ao qual ele pertence, não o que está rodando ele. O prefixo é acrescentado só no caminho para o console — o onDebugMessage e o onClientDebugMessage continuam recebendo o texto puro, com o arquivo e a linha como parâmetros separados.

Veja também

• getTickCount — Devolve um contador em milissegundos para medir tempo decorrido.
• getVersion — Devolve o que esta build do MTAX é.
• getRealTime — Quebra um instante de tempo real nos seus componentes.
• outputConsole — Escreve uma linha em um console.