[PROG] Aula 02 - As Funções INI

[Tutoriais & Aulas]

Autor original: Willy

As Funções INI
Aula 02/03
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”): Clique para ver o conteúdo

Serve para abrir (ou criar automaticamente, caso não exista) um arquivo.ini. Você só conseguirá usar essa função se você já tiver salvado um .gmk.

ini_close(): Clique para ver o conteúdo

Serve para fechar um arquivo.ini aberto. É importante notar que, você pode manter apenas um arquivo.ini aberto, portanto, se quiser abrir um, terá que fechar outro com essa função.

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): Clique para ver o conteúdo

Serve para ler (carregar) o valor de uma chave que se localiza em uma seção. Default é uma string (lembre-se, como é uma string, deve ser escrito entre aspas) usada quando não existe um valor, ou seja, é um “valor inicial”.

ini_read_real(Seção,Chave,Default): Clique para ver o conteúdo

Mesma coisa acima, porém, destinada a valores do tipo real (inclusive o valor do default).

Para Salvar:

ini_write_string(Seção,Chave,Valor): Clique para ver o conteúdo

Serve para escrever (salvar) em uma chave localizada em uma seção um determinado valor do tipo string.

ini_write_real(Seção,Chave,Valor): Clique para ver o conteúdo

Mesma coisa acima, porém destinada a valores do tipo real.

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): Clique para ver o conteúdo

Serve para sabermos se uma determinada chave pertencente a uma determinada seção existe.

ini_section_exists(Seção): Clique para ver o conteúdo

Serve para sabermos se uma determinada seção existe.

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): Clique para ver o conteúdo

Deleta uma determinada chave pertencente a uma determinada Seção.

ini_section_delete(Seção): Clique para ver o conteúdo

Deleta uma seção por completo, ou seja, também deleta todas as chaves a ela pertencente.

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.

Espero que tenha gostado!
Até a próxima aula!