[Tutorial] Manual DOF2 - Printable Version

+- SA-MP Forums Archive (https://sampforum.blast.hk)
+-- Forum: Non-English (https://sampforum.blast.hk/forumdisplay.php?fid=9)
+--- Forum: Languages (https://sampforum.blast.hk/forumdisplay.php?fid=33)
+---- Forum: Português/Portuguese (https://sampforum.blast.hk/forumdisplay.php?fid=34)
+----- Forum: Lançamentos/Releases (https://sampforum.blast.hk/forumdisplay.php?fid=56)
+----- Thread: [Tutorial] Manual DOF2 (/showthread.php?tid=585807)

---

Manual DOF2 - Dayvison_ - 16.08.2015

Manual DOF2

Indice

• Introduзгo
• Onde encontrar?
• Configuraзхes
• Funзхes
• Exemplos
• Consideraзхes finais.

Introduзгo
Apуs ver muitas duvidas sobre o assunto, e ver que nгo hб nenhum tutorial completo sobre a mesma, decidi traze-lo mim mesmo.
DOF2 ou Double-O-Files, й uma inclde criada por Double-O-Seven, nгo й o operador de arquivos mais rбpido ultimamente, porй sua velocidade e facilidade de uso sгo incriveis.
Este й um tutoeial para aqueles que desejam ter conhecimento no operador INI DOF2.
Apesar deste tutorial se focar em DOF2, apуs vocк terб conhecimento de uma lуgica para usar quase todos Operadores INI.


Onde encontrar?
Vocк pode encontra-la a partir deste link.


Configuraзгo
O DOF2 tem algumas poucas configuraзхes que vocк pode ou nгo alterar.
2 destas configuraзхes podem ser alteradas dinвmicamente apуs a compilaзгo, Leia DOF2::SetCaseSensitivity e DOF2::SetUTF8 em funзхes.
Nesta parte falarei apeas das configuraзхes anteriores ao compilamento.
Elas sгo:

• MAX_SECTION_TAG - Defina para o mбximo tamanho permitido de uma seзгo. - Padrгo - 32
• MAX_LINE_SIZE - Defina para o tamanho mбximo da linha, inclui Key e Valor. - Padrгo - 128
• MAX_SECTIONS - Defina para o mбximo de seзхes que se pode usar. - Padrгo - 32
• MAX_ENTRIES - Defina para o numero mбximo de linhas que podem ser armazenadas no cache. - Padrгo - 256
• MAX_FILE_SIZE - Defina para o tamanho mбximo de arquivo que o DOF2 pode ler. - Padrгo - 64
• PACK_CONTENT - Defina isto para true ou false, caso queira (des)habilitar o packeamento de strings do DOF2. - Padrгo - false(Desativado)
• DUDB_CONVERT - Defina isto para 1 caso queira ligar a conversгo de DUDB para DOF2. - Padrгo - 0
• USER_FILE_PATH - Defina isto para o arquivo do player. - Padrгo - "%s.ini"
• USER_PW_HASH_KEY - Defina isto para o nome da Key que usara para guardar a senha do usuario. - Padrгo - "password"
• DINI_CONVERT - Defina isto para 1 caso queira ligar a conversгo de DINI para DOF2. - Padrгo - 0

Funзхes

Quote:

DOF2::SetFile Seta para o qual arquivo vocк estб editando. Й uma funзгo para uso interno, e nгo deve ser usada levianamente, pois pode causar defeitos em todo seu cуdigo. Parвmetros file[] - Arquivo para qual estaria setando.

Quote:

DOF2::LoadFile Й um macro para a funзгo DOF2::ParseFile, chamando-a com o arquivo atual aberto, parametro extraid = -1, e Callback = false. Parвmetros Nenhum Parвmetro.

Quote:

DOF2::SaveFile - DOF2::WriteFile - DOF2::Exit Salva todas alteraзхes feitas no arquivo atual,0. A funзгo original й WriteFile sendo as restantes apenas macros. Parвmetros Nenhum Parвmetro.

Quote:

DOF2::ParseFile Analisa/Carrega um arquivo, e pode chamar os resultados em callback(s). Parвmetros file[] - Arquivo a ser carrgado. extraid - Valor inteiro que pode ser passado ao chamar a callback. bool:callback=true - Se irб chamar uma callback com oa resultados ou nгo.

Quote:

DOF2::ReparseFile Refaz a funзгo DOF2::ParseFile, substituindo o antigo arquivo por um novo. Parвmetros file[] - Arquivo a ser carrgado. extraid - Valor inteiro que pode ser passado ao chamar a callback. bool:callback=true - Se irб chamar uma callback com oa resultados ou nгo.

Quote:

DOF2::PrintFile Imprime um texto no console com todo o conteudo do arquivo atual. Parвmetros Comment[]="" - Comentбrio a ser imprimido.

Quote:

DOF2::GetString Retorna string obtida de uma "key" no arquivo. Parвmetros file[] - Arquivo a obter string. key[] - Key para obter a string. tag="" - Seзгo para buscar a "key".

Quote:

DOF2::GetStringEx Formata a string inserida em result com a string obtida de uma "key" no arquivo. Parвmetros file[] - Arquivo a obter string. key[] - Key para obter a string. input[] - String que serб formatada com o valor obtido. size - Tamanho mбximo da string de input. tag="" - Seзгo para buscar a "key".

Quote:

Float:DOF2::GetFloat Retorna o valor flutuante obtido de uma "key" no arquivo. Parвmetros file[] - Arquivo a obter o valor flutuante. key[] - Key para obter o valor flutuante. tag="" - Seзгo para buscar a "key".

Quote:

DOF2::GetInt Retorna o valor inteiro obtido de uma "key" no arquivo. Parвmetros file[] - Arquivo a obter o valor inteiro. key[] - Key para obter o valor inteiro. tag="" - Seзгo para buscar a "key".

Quote:

DOF2::GetHex Retorna valor em Hex obtido de uma "key" no arquivo. Parвmetros file[] - Arquivo a obter valor em hex. key[] - Key para obter a obter valor em hex. tag="" - Seзгo para buscar a "key".

Quote:

DOF2::GetBin Retorna valor binбrio obtido de uma "key" no arquivo. Parвmetros file[] - Arquivo a obter valor binбrio. key[] - Key para obter valor binбrio. tag="" - Seзгo para buscar a "key".

Quote:

bool:DOF2::GetBool Retorna valor booleano obtido de uma "key" no arquivo. Parвmetros file[] - Arquivo a obter valor booleano. key[] - Key para obter valor booleano. tag="" - Seзгo para buscar a "key".

Quote:

DOF2::SetString Seta uma string em uma key no arquivo. Parвmetros file[] - Arquivo no qual a key serб alterada/criada com o valor. key[] - Key no qual serб setada a string. value[] - String a ser inserida na Key. tag="" - Seзгo para buscar e setar a "key".

Quote:

DOF2::SetFloat Seta um valor flutuante em uma key no arquivo. Parвmetros file[] - Arquivo no qual a key serб alterada/criada com o valor. key[] - Key no qual serб setada o valor flutuante. Float:value - Valor flutuante a ser inserido na Key. tag="" - Seзгo para buscar e setar a "key".

Quote:

DOF2::SetInt Seta um valor inteiro em uma key no arquivo. Parвmetros file[] - Arquivo no qual a key serб alterada/criada com o valor. key[] - Key no qual serб setada o valor inteiro. value - Valor inteiro a ser inserido na Key. tag="" - Seзгo para buscar e setar a "key".

Quote:

DOF2::SetHex Seta um valor Hexadecimal em uma key no arquivo. Parвmetros file[] - Arquivo no qual a key serб alterada/criada com o valor. key[] - Key no qual serб setada o valor Hexadecima. value - Valor hexadecimal a ser inserido na Key. tag="" - Seзгo para buscar e setar a "key".

Quote:

DOF2::SetBin Seta um valor binбrio em uma key no arquivo. Parвmetros file[] - Arquivo no qual a key serб alterada/criada com o valor. key[] - Key no qual serб setada o valor binбrio. value - Valor binбrio a ser inserido na Key. tag="" - Seзгo para buscar e setar a "key".

Quote:

DOF2::SetBool Seta um valor booleano em uma key no arquivo. Parвmetros file[] - Arquivo no qual a key serб alterada/criada com o valor. key[] - Key no qual serб setada o valor booleano. bool:value - Valor booleano a ser inserido na Key. tag="" - Seзгo para buscar e setar a "key".

Quote:

DOF2::IsSet Verifica se uma key existe em um arquivo. Parвmetros file[] - Arquivo no qual irб verificar se a key existe. key[] - Key para verificar se existe. tag="" - Seзгo para buscar e verificar a "key".

Quote:

DOF2::UnSet Deleta uma key no arquivo. Parвmetros file[] - Arquivo no qual irб buscar a key. key[] - Key a ser deleta. tag="" - Seзгo para buscar e deletar a "key".

Quote:

DOF2::FileExists Verifica se um arquivo existe. Parвmetros file[] - Arquivo que irб verificar se existe.

Quote:

DOF2::RemoveFile Deleta um arquivo. Parвmetros file[] - Arquivo que irб ser deletado.

Quote:

DOF2::CreateFile Cria um arquivo Parвmetros file[] - Arquivo que irб ser criado. password[]="" - Senha que pode ser inserida no arquivo, й um hash da string, setado como uma key.

Quote:

DOF2::RenameFile Renomeia o arquivo(Na verdade apaga o antigo, e cria um novo igual). Parвmetros oldfile[] - Arquivo a ser renomeado. newfile[] - Novo nome do arquivo.

Quote:

DOF2:: RenameKey Parвmetros file[] - Arquivo no qual q Key serб alterada. oldkey[] - Nome atual da Key. newkey[] - Novo nome para a key. tag[]="" - Seзгo em que a Key se encontra.

Quote:

DOF2::CopyFile Copia um arquivo. Parвmetros filetocopy[] - Arquivo a ser copiado. newfile[] - Nome do novo arquivo.

Quote:

bool:DOF2::CheckLogin Compara se o hash da string inserida em "password", se й igual com o encontrado no arquivo. Parвmetros file[] - Arquivo a ser no qual se encontra a senha. password[] - Senha para comparar com a armazenada no arquivo.

Quote:

DOF2::File Retorna o arquivo do usuario inserido. Parвmetros user[] - Nome do usuario para formatar seu arquivo.

Quote:

DOF2::ParseInt Macro para strval(value), geralmene usando em OnParseFile Parвmetros Nenhum parвmetro.

Quote:

DOF2::ParseFloat Macro para floatstr(value), geralmene usando em OnParseFile Parвmetros Nenhum parвmetro.

Quote:

DOF2::ParseBool Macro para uma operaзгo ternбria que transforma uma string em valor booleano, geralmene usando em OnParseFile Parвmetros Nenhum parвmetro.

Quote:

DOF2::ParseBin Macro para DOF2::strbin(value), geralmene usando em OnParseFile Parвmetros Nenhum parвmetro.

Quote:

DOF2::ParseHex Macro para DOF2::strhex(value), geralmene usando em OnParseFile Parвmetros Nenhum parвmetro.

Quote:

DOF2::SetUTF8 Seta a codificaзгo de caracteres do DOF2 para UTF8, usado nas funзхes fputchar. Parвmetros bool:set - True ou False, Usa ou nгo usa UTF8.

Quote:

bool:DOF2::GetUTF8 Obtйm a verificaзгo se estб ou nгo usando UTF8. Parвmetros Nenhum parвmetro.

Quote:

DOF2::GetFile Retorna o nome do arquivo atal que se estб editando. Parвmetros Nenhum parвmetro.

Quote:

DOF2::MakeBackup Faz backup de um arquivo, salva ele com extensao .bak e a data e horбrio atual. Parвmetros file[] - Arquivo a fazer o backup.

Quote:

DOF2::RemoveSection - DOF2::RemoveTag Remove uma seзгo do arquivo. Parвmetros file[] - Arquivo que a seзгo serб removida. tag[] - Seзгo a remover.

Quote:

DOF2::SectionExists - DOF2::TagExists Verifica se a seзгo existe no arquivo. Parвmetros file[] - Arquivo a verificar se a seзгo existe. tag[] - Seзгo a verificar.

Quote:

DOF2::SortSection Ordena todas Keys em uma seзгo. Parвmetros file[] - Arquivo a ser ordenado. tag[] - bool:ignorecase=true - Uma forma de "Case sensitive", para diferenciar Maiuscula de Minuscula. bool:ascending=true - Ordem do arquivo, crescente ou decrescente.

Quote:

DOF2::SetCaseSensitivity Seta se o DOF2 irб diferenciar letras Maiusculas de Minusculas. Parвmetros bool:set - Definiзгo, true ou false.

Quote:

DOF2::GetCaseSensitivity Obtйm se o status do Case Sensitivy do DOF2. Parвmetros Nenhum parвmetro.

Exemplos
Em breve quando eu voltar ao PC trarei exemplos de todas as funзхes, atй la trago apenas uma descriзгo das mesmas.

Consideraзхes Finais
Apуs este manual do DOF2, espero que muitos consigam entender sobre suas funзхes, em breve trarei exemplos para que possa facilitar.


Qualquer duvida, critica ou sugestгo comente abaixo.

---

Re: Manual DOF2 - GM_KoDi - 16.08.2015

Belo tutorial, bem explicado.
parabйns.

---

Re: Manual DOF2 - zPain - 16.08.2015

Bom tutorial. Vocк pode aprimorб-lo aos poucos, adicionando exemplos de uso para cada funзгo.

---

Re: Manual DOF2 - Dayvison_ - 16.08.2015

Vlw ae
Sim, os exemplos ja tгo atй prontos, porem quero ir no PC para ter certeza que todos terгo o resultado previsto.

---

Re: Manual DOF2 - FanonRiouDiou - 16.08.2015

Caramba, Eu uso DOF2 e nгo sabia quase nada. Esse tutorial vai me ajudar. Parabйns.

---

Re: Manual DOF2 - PT - 16.08.2015

Bom trabalho.

Estou vendo que ainda esta melhorando o tuto...

---

Re: Manual DOF2 - HaRdiiZin - 16.08.2015

Muito bom

---

Re: Manual DOF2 - iTakelot - 16.08.2015

Muito bom Day, podia colocar exemplos de uso. mas fico уtimo parabйns.

---

Re: Manual DOF2 - ImperioHosting - 16.08.2015

Parabйns, уtimo trabalho.

---

Re: Manual DOF2 - Artista - 16.08.2015

Bem completo, parabйns!

@Off
Notei que vc curte Tokyo Ghoul... Sabe se vai ter terceira temporada? '-'

---

Re: Manual DOF2 - Dayvison_ - 16.08.2015

Vlw galera, falta sу algumasmverificaзхes pra postar os exemplos, tipo saber se o DOF2 tambem imprime, copia, cometarios...

Ainda nгo tem data de lanзamento oficil, mas vai ter s

---

Re: Manual DOF2 - IgorLuiz - 16.08.2015

Уtimo tutorial Day, Parabйns!

---

Re: Manual DOF2 - Locky_ - 16.08.2015

Muito bom. Alguns scrips tem a oportunidade de ter suas funзхes na wiki. Dof2 poderia estar la tbm explicando detalhadamente e com exemplos... Aqui todos tem conta na wiki.

---

Re: Manual DOF2 - Dayvison_ - 16.08.2015

Eu tinha pensado nisto tбmbem, mas acontece que minha conta nгo entra na wiki por causa do anderlaine e o dugi nгo trocou meu nick ainda...

---