Fgetchar PT
From SA-MP Wiki
fgetchar
| Nota: O nome desta função começa com uma letra minúscula. |
Descrição:
Lê um único caractere de um arquivo
 Aviso | Usando um identificador inválido irá crashar seu servidor! Obtenha um identificador válido usando fopen ou ftemp. |
(File: handle, value, bool: utf8=true)
| handle | O identificador do arquivo, retornado pela função fopen. |
| value | Este parâmetro não tem utilidade, basta manter com o valor 0. |
| utf8 | Se for usado true lê como UTF-8, caso contrário como ASCII estendido. |
Valores de retorno:
Se houver sucesso retorna o caractere que esta na posição atual do ponteiro do arquivo, caso contrário retorna EOF (end of file - fim do arquivo).
Exemplo de uso:
// Abre o arquivo "file.txt" no modo leitura new File:handle = fopen("file.txt", io_read), // Declara a variável "g_char" g_char; // Verifica se o arquivo foi aberto if(handle) { // Lê todos os caractere, ignorando UTF-8. while((g_char = fgetchar(handle, 0, false)) != EOF) { // Imprime o caractere no console printf("[ \"file.txt\" ] 0x%x", g_char); } // Fecha o arquivo fclose(handle); } else { // Falha ao abrir o arquivo print("falha ao tentar abrir o arquivo \"file.txt\"."); }
Funções Relacionadas
As seguintes funções podem ser úteis, pois estão de alguma forma, relacionadas a esta função.
- fopen: Abre um arquivo.
- fclose: Fecha um arquivo.
- ftemp: Cria um arquivo temporário.
- fremove: Deleta um arquivo.
- fwrite: Escreve em um arquivo aberto.
- fread: Lê um arquivo.
- fputchar: Coloca um caractere dentro do arquivo.
- fgetchar: Pega um caractere de dentro do arquivo.
- fblockwrite: Escreve blocos de dados em um arquivo.
- fblockread: Lê blocos de dados de dentro de um arquivo.
- fseek: Pula para uma determinada posição no arquivo.
- flength: Pega o tamanho de um arquivo.
- fexist: Verifica se um arquivo existe.
- fmatch: Verifica se os padrões com um nome de arquivo correspondem.
