[Tutorial] Desvendando o DOF2
#1

Olб pessoal.

Muitas pessoas podem ter dъvidas de como usar a include dof2. Nesse tutorial estarei tirando esse misticismo de que й algo complicado, como vemos em muitas comunidade de SA-MP. Apуs ler e entender esse tutorial, vocк estarб apto a desenvolver qualquer tipo de sistema que queira armazenar dados.

O que й
DOF2 й uma include responsбvel por gerenciamento de dados armazenados em arquivos. Ele й muito utilizado em sistemas de registro, salvamento, empresas, etc...

Aonde encontrar
Infelizmente, nгo encontrei o tуpico oficial do DOF2, todavia vocк pode encontralo clicando aqui.

Como instalar
1) Faзa o download do arquivo. Click aqui.
2) Salve o arquivo na pasta pawno/includes com o nome de DOF2.inc. DOF2 em maiъsculo e a extensгo .inc.
3) Na parte de includes no seu gamemode, normalmente no topo, inclua a include inserindo o cуdigo abaixo:
Code:
#include DOF2
Pronto. Seguindo esses 3 passos vocк tem o DOF2 instalado e pronto para ser usado.

Funcionalidade
O sistema de armazenamento e identificaзгo dos dados em DOF2 funciona no formato:
CHAVE=VALOR

CHAVE: й o identificador de cada valor. Vocк nгo pode ter chaves com o mesmo nome. Vocк sempre se referencia a ela quando quer recuperar algum valor.

VALOR: й o valor propriamente dito.

Vocк pode imaginar esse sistema como um sistema de variбvel aonde a chave й o nome da variбvel e o valor й o valor da variбvel.

PS: Vocкs podem encontrar muito no cabeзalho das funзхes a palavra: key[], que se refere a chave;

Comandos bбsicos
Vamos agora entrar na parte dos comandos bбsicos. Nesse tutorial irei ensinar a vocкs o uso dos comandos que acho que vocкs tem a maior chance de usar. Existem diversos outros comandos, todavia, nгo os acho pertinentes.

DOF2_CreateFile(file[],password[]="")
Cria um arquivo.

Exemplo de uso:
Code:
new str[128], name[32];
GetPlayerName(playerid, name. sizeof(name));
format(str, sizeof(str), "contas/%s.ini", name);
DOF2_CreateFile(str);
DOF2_FileExists(file[])
Verifica se um arquivo existe. Retorna true se existir e false caso contrбrio.

Exemplo de uso:
Code:
new str[128], name[32];
GetPlayerName(playerid, name. sizeof(name));
format(str, sizeof(str), "contas/%s.ini", name);
if(!DOF2_FileExists(str) DOF2_CreateFile(str);
DOF2_RenameFile(oldfile[],newfile[])
Renomeia um arquivo.

Exemplo de uso:
Code:
new str[128], new[128];
format(str, sizeof(str), "contas/joao.ini");
format(new, sizeof(new), "contas/pedro.ini");
DOF2_CreateFile(str);
DOF2_RenameFile(str, new);
DOF2_RemoveFile(file[])
Deleta um arquivo.

Exemplo de uso:
Code:
new str[128];
format(str, sizeof(str), "contas/joao.ini");
DOF2_RemoveFile(str);
DOF2_CopyFile(filetocopy[],newfile[])
Copia o conteъdo de um arquivo e cria um novo arquivo a partir desse conteъdo.

Exemplo de uso:
Code:
new str[128], new[128];
format(str, sizeof(str), "contas/joao.ini");
format(new, sizeof(new), "contas/pedro.ini");
DOF2_CreateFile(str);
DOF2_CopyFile(str, new);
DOF2_SaveFile()
Salva o conteъdo do arquivo que estб sendo trabalhado.

Exemplo de uso:
Code:
new str[128];
format(str, sizeof(str), "contas/joao.ini");
DOF2_CreateFile(str);
DOF2_SaveFile();
DOF2_GetString(file[],key[],tag[]="")
DOF2_GetInt(file[],key[],tag[]="")
DOF2_GetFloat(file[],key[],tag[]="")
DOF2_GetBool(file[],key[],tag[]="")
Comandos que recebem um tipo de valor do arquivo: literal, numйrico, fracionбrio e booleano (string, int, float e boolean).

Exemplo de uso:
Code:
new str[128], nome[32], idade, Float:salario;
format(str, sizeof(str), "contas/joao.ini");
nome = DOF2_GetString(str, "name");
idade = DOF2_GetInt(str, "age");
salario = DOF2_GetFloat(str, "salary");
banido = DOF2_GetBool(str, "banned");
DOF2_SetString(file[],key[],tag[]="")
DOF2_SetInt(file[],key[],tag[]="")
DOF2_SetFloat(file[],key[],tag[]="")
Comando que inserem um valor no arquivo. Literal, numйrico, fracionбrio e booleano (string, int, float e boolean).

Exemplo de uso:
Code:
new str[128], nome[32], idade, Float:salario;
format(str, sizeof(str), "contas/joao.ini");
DOF2_SetString(str, "name", "Joao");
DOF2_SetInt(str, "age", 18);
DOF2_SetFloat(str, "salary", 0.0);
DOF2_SetBool(str, "banned", true);
Assim chegamos na parte final do nosso tutorial sobre DOF2. Com esse conteъdo vocкs estгo aptos a construir qualquer sistema de armazenamento de informaзхes que bem desejarem.

Abraзos e atй a prуxima.
Reply


Messages In This Thread
Desvendando o DOF2 - by Joao Pedro - 14.03.2013, 01:25
Re: Desvendando o DOF2 - by Sky™ - 14.03.2013, 01:27
Re: Desvendando o DOF2 - by smiiir - 14.03.2013, 01:27
Re: Desvendando o DOF2 - by Joao Pedro - 14.03.2013, 01:29
Re: Desvendando o DOF2 - by Gii - 14.03.2013, 01:30
Re: Desvendando o DOF2 - by Joao Pedro - 14.03.2013, 01:32
Re: Desvendando o DOF2 - by VenoN - 14.03.2013, 01:50
Re: Desvendando o DOF2 - by JapaN* - 14.03.2013, 02:49
Re: Desvendando o DOF2 - by Kuddy - 14.03.2013, 02:51
Re: Desvendando o DOF2 - by SeV_ - 14.03.2013, 02:53
Re: Desvendando o DOF2 - by zSuYaNw - 14.03.2013, 03:00
Re: Desvendando o DOF2 - by HumildadeAgain - 14.03.2013, 03:37
Re: Desvendando o DOF2 - by Jefferson Santos - 14.03.2013, 05:38
Re: Desvendando o DOF2 - by Jason` - 15.03.2013, 03:46
Re: Desvendando o DOF2 - by Schocc - 19.03.2013, 02:47
Re: Desvendando o DOF2 - by Maklister - 19.03.2013, 05:00
Re: Desvendando o DOF2 - by JhefTFJ - 23.03.2017, 18:31
Re: Desvendando o DOF2 - by vPunisheR - 23.03.2017, 18:41
Re: Desvendando o DOF2 - by JhefTFJ - 23.03.2017, 19:27
Re: Desvendando o DOF2 - by BLacksKrillex - 23.03.2017, 22:48
Re: Desvendando o DOF2 - by WoozieBRz - 21.05.2017, 16:13
Re: Desvendando o DOF2 - by DelK - 21.05.2017, 16:21
Re: Desvendando o DOF2 - by BrianD - 23.05.2017, 17:48
Re: Desvendando o DOF2 - by IlanZ - 23.05.2017, 20:42
Re: Desvendando o DOF2 - by LordMafia - 14.05.2018, 00:46
Re: Desvendando o DOF2 - by PaizaoPlays - 06.12.2018, 21:14
Re: Desvendando o DOF2 - by ipsLuan - 06.12.2018, 21:41
Re: Desvendando o DOF2 - by RiqueP - 07.12.2018, 00:19

Forum Jump:


Users browsing this thread: 5 Guest(s)