Fseek PT

From SA-MP Wiki

Jump to: navigation, search

fseek

Image:Farm-Fresh text lowercase.png Nota: O nome desta função começa com uma letra minúscula.


Descrição:

Altera a posição atual no arquivo. Você pode procurar para frente ou para trás no arquivo.


Parâmetros:
(File:handle, position, whence)
handleO identificador do arquivo. Retornado pela função fopen.
positionA nova posição no arquivo, relativo ao parâmetro whence (parâmetro abaixo).
whenceA posição inicial à qual se refere a posição do parâmetro.


Return Values:

A nova posição; relativo ao início do arquivo.


Image:32px-Circle-style-warning.png

Aviso

Usando um identificador inválido irá crashar seu servidor! Obtenha um identificador válido usando fopen ou ftemp.


Whences

seek_startSeta a posição em relação ao início do arquivo (esta posição deve ser um número positivo).
seek_currentSeta a posição tem relação a posição atual do arquivo, o parâmetro position é adicionado à posição atual (posição atual + posição desejada).
seek_endSeta a posição em relação ao final do arquivo (a posição informada deve ser zero ou um número negativo).


Exemplo de uso:

// Abre o arquivo "file.txt" no modo de leitura
new File:handle = fopen("file.txt", io_read);
 
// Verifica se o arquivo foi aberto
if(handle)
{
	// O arquivo foi aberto
 
	// Pula para o primeiro byte do arquivo e imprime a posição
	printf("Posição inicial do arquivo: %d", fseek(handle, 0, seek_start));
 
	// Pula para última posição do arquivo e imprime a posição
	printf("Posição final do arquivo: %d", fseek(handle, 0, seek_end));
 
	// Pula para o mesmo byte e imprime a posição
	printf("Posição atual: %d", fseek(handle, 0, seek_current));
 
	// Fecha o arquivo
	fclose(handle);
}
else
{
	// Falha ao abrir
	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.
  • ftemp: Cria um arquivo temporário.
  • fwrite: Escreve em um arquivo aberto.
  • fputchar: Coloca um caractere dentro do arquivo.
  • fgetchar: Pega um caractere de dentro do 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.
Personal tools
Navigation
Toolbox