Aula 02 - As Funções INI

Na aula anterior, vimos do que consiste um arquivo.ini. Agora, nesta aula, você vai saber para que servem as 10 funções INI existentes. Apenas na próxima aula você irá aprender a usá-las, afinal, devemos saber o que estamos fazendo.

Com essas dez funções, podemos dividi-las em quatro grupos:

1-Abrir e Fechar
2-Carregar e Salvar
3-Checagem
4-Exclusão

Fique tranquilo caso não consiga absorver algumas informações, na terceira aula suas duvidas se dissiparão, pois você verá como usar tais funções.

Grupo 1 - Abrir e Salvar:
É neste grupo que você encontrará funções para abrir ou fechar um arquivo.ini (abrir e fechar não é a mesma coisa que carregar e salvar). Esse grupo é formado por duas funções, sendo que:

ini_open(“arquivo.ini”):

ini_close():

Grupo 2 – Carregar e Salvar:
Este é o grupo que mais será usado. É nele que existem as funções para poder gravar ou carregar dados (do tipo real ou string) no arquivo.ini atualmente aberto. Se você não leu a aula anterior, recomendo que volte e a leia, pois, agora você irá usar os conceitos nela adquiridos. Esse grupo é formado por quatro funções, sendo que:

Para carregar:

ini_read_string(Seção,Chave,Default):

ini_read_real(Seção,Chave,Default):

Para Salvar:

ini_write_string(Seção,Chave,Valor):

ini_write_real(Seção,Chave,Valor):

Grupo 3 – Checagem:
Neste grupo, você encontrará funções que serão usadas para saber se devemos criar ou carregar os valores de uma chave em uma variável. Por exemplo, se no create, declararmos uma variável, e, depois salvá-la no INI, será totalmente inútil, pois, quando iniciarmos o jogo novamente, mesmo que tenhamos salvado e carregado os valores, o create vai agir e inutilizar o que carregamos. Na próxima aula você entenderá melhor o que quero dizer. Este grupo é composto por duas funções, sendo que:

ini_key_exists(Seção,Chave):

ini_section_exists(Seção):

Grupo 4 – Exclusão:
Da mesma forma que criamos seções e chaves, também podemos exclui-las. É tipicamente usado para apagar informações que não usaremos mais, como por exemplo, a de um usuário que por algum motivo quis apagar a sua conta no jogo. Este grupo é composto por duas funções, sendo que:

ini_key_delete(Seção, Chave):

ini_section_delete(Seção):

Agora você já sabe para que servem as 10 funções INI, correto? Porém, você certamente não sabe como usá-las, principalmente as do Grupo 2. Não se preocupe, tudo no seu tempo... Na próxima aula, você será capaz de usar todas essas funções, e, por fim, finalmente criar um sistema de salvar e carregar informações .ini. Duvidas, criticas e elogios são bem vindos.

Oww cara, ta super bem explicado,
principalmente pra mim q num sabia como usar INI, tô ancioso pela próxima aula.

Muito legal cara, eu gosto muito quando alguém explica o que cada função faz, isso me ajudou muito na hora de aprender GML. Por isso fico sempre consultando os tópicos da Yoyo Games Wiki.

Parabéns!

Muito obrigado pelos comentários, já percebi que tem muita gente com dificuldade em usar os INIs, por isso resolvi criar as aulas. Assim que eu tiver uma oportunidade (e ideia para fazer um novo tutorial/aula) eu posto novos conteúdos.

Nota: Corrigi um erro na aula, tinha uma informação incorreta. Agora, a spoiler "ini_read_string(Seção,Chave,Default)" está da seguinte forma:

ini_read_string(Seção,Chave,Default):