Aula 03 - Manipulando o arquivo.ini

Finalmente chegamos na parte interessante das aulas sobre arquivos.ini,  agora você vai aprender como usar as funções aprendidas anteriormente. Antes de começar, crie um novo projeto e salve em algum lugar. Se você não sabe o que são INIs, significa que você pulou algumas aulas, seu danadinho... Se achar necessário, consulte a primeira aula e também a segunda aula.

Primeiro passo - Abrir/Criar um INI:
Sempre que formos trabalhar com um INI, a primeira coisa que devemos fazer é carregar/criar um. Para isso, usamos a função ini_open(“nome.ini”).
Usar esta função é muito simples, basta definirmos um nome e uma extensão desejada. Você pode colocar qualquer nome e qualquer extensão, pois o resultado vai ser o mesmo, como por exemplo, “NomeDoJogo.sav”. Note que, você sempre deve escrever entre aspas(""). Se você executar o jogo, você não encontrará o arquivo.ini que você criou. Mas por quê? Saberemos disso posteriormente...

Segundo Passo – Criando variáveis carregáveis.
Se você quisesse criar uma variável normal em um objeto, você procederia da seguinte forma:

Create:
Variável=Valor

Mas, se quisermos criar uma variável “carregável”, ou seja, que será carregado do ini, deveremos proceder de uma forma um pouco diferente.

Create:
Variável=ini_read_real("Seção","Chave",Default)

Como vimos na aula anterior, existem dois tipos de valor, a do tipo real e a do tipo string, então, sempre preste atenção quando for criar uma variável com INI. No caso acima, estamos definindo o valor da “Variável” através do arquivo.ini. Default é o valor inicial dele, ou seja:

Pontos=0
É o mesmo que:
Pontos=ini_read_real(“Progresso”,”Pontos”,0)

Note que, quando nos referimos a uma seção ou a uma chave, sempre escrevemos entre aspas.

Terceiro Passo – Salvando o novo valor:
Agora que já sabemos como criar as variáveis, devemos saber como gravar os valores delas, para que depois, possamos iniciar o jogo com as variáveis do jeito que deixamos!
O procedimento é semelhante ao de carregar, fazemos da seguinte forma:
ini_write_real(“Progresso”,”Pontos”,Pontos)
O que fizemos acima é bem simples. Chamamos a função ini_write_real() e salvamos o valor de “Pontos” na chave “Pontos” pertencente a seção “Progresso”. Cuidado para não confundir a chave “Pontos” com a variável “Pontos”. Embora a escrita seja a mesma, uma não possui aspas, logo, é uma variável.

Agora que você salvou algo no INI, adivinha o que aconteceu? O arquivo que abrimos que, antes não existia agora existe, e está no mesmo lugar que a sua gmk! Seu arquivo.ini só será criado depois que você gravar algo nele. Agora você já sabe responder a pergunta do primeiro passo!

Pronto, isto é tudo o que você precisa saber para manipular dados de um arquivo.ini! As outras funções você raramente irá usar. A lógica é a mesma, basta informar qual chave/seção você gostaria de manipular. Por exemplo, para checar a existência de uma chave e exclui-la.

Código:

if ini_key_exists(“Perfil”,”Nome”){ //Checa se a chave existe...
ini_key_delete(“Perfil”,”Nome”)//...e a deleta!
}

Isto encerra as aulas sobre arquivos.ini. Agora, você já sabe como usar arquivos.ini! Seja criativo, bole soluções para seus problemas com save/load, tudo depende apenas de seu raciocínio. Duvidas, criticas e elogios são bem vindos!

Muito legal a série Willy. Como sugestão, vc poderia ensinar a utilizar um sistema bem simplificado de criptografia pra usar com um save em ini, já que "puro" ele pode ser editado livremente pelo jogador.

(Sei que há uma gama de DLLs pra criptografia mas em casos onde não se faz necessário um simples sistema de "chaves" substituindo caracteres é perfeitamente funcional)

Cara, bom tutorial(ou aula), ta tudo bem explicado e agora sei como usar ini, tava esperando logo esse tuto ainda bem q vc postou logo^^

Eu havia pensado em fazer isso também, mas acabei esquecendo...
Porém, já existe um tópico falando sobre isso (resposta do Kabeção).
Codificar e Descodificar INI

Se der tempo, talvez eu faça algo do tipo, mas ultimamente o tempo está meio corrido...

Muito bom, Willy. Explicou direitinho, passo-a-passo como se abre, carrega e se fecha um .ini, parabéns.

Gostaria de mais tutoriais como estes, são de ótima qualidade, e de grande ajuda ;D

Ei Willy, muito bom o tutorial, porém estou com um problema. Não sou nada bom em GML, mas tô tentando aprender, para isso criei uma engine bem simples pra aprender a usar os ini. Criei uma room, e um objeto.

Esse objeto tem um evento Create e tem o seguinte código (acho que está errado):

Código:


ini_open("config.ini");
global.Option = ini_read_string("Config","Tela-cheia",0);
ini_write_string("Config","Tela-cheia",0)


Quando executo o programa, ele cria o ini, e ele fica assim:

Código:



[Config]
Tela-cheia=


Porque ele não fica assim:

Código:


[Config]
Tela-cheia=0


??

O que eu fiz de errado?

Valeu Willy, mto bom o seu tutorial!

Isto acontece porque você está salvando um valor "real" em um campo onde deveria ser "string". Para isso, no ini_write_string, coloque o zero da seguinte forma: string(0); Isso converte real em string.
Ou se preferir, troque o ini_write_string por ini_write_real

Qualquer coisa é so falar.
flws...

Parabéns velho!

Nota 10 o teu tutorial. Fiz o que eu precisava rapidamente gastando 5 minutos lendo as três aulas.

Muito bom cara muito bom mesmo, eu precisava mesmo disso, bolei um belo sistema de save , valeu Willy, Parabens, otimo tutorial

Willy

Preciso carregar um valor de uma ini para as opções do jogador, porém não posso predefiní-la.

No caso está da seguinte forma

Código:

ini_read_real("options","tela",2)

O problema é: não quero que ele configure como 2, e sim que use o valor que está contido na ini... comofas?

Os valores default só entram em cena quando o INI não encontra a chave na seção. Portanto, se você está tentando carregar um valor do INI mas o mesmo não corresponde ao esperado, significa que o o INI não está carregando, logo, um erro na programação.

Se você não achar o erro, usa o file_exists() para ver se o caminho ao arquivo está certo! (lembrando que precisa estar na mesma pasta do jogo, no caso do GM8, e no included files no caso do GMS)

Ja verifiquei o arquivo, ele esta alterando corretamente.
Porém acho que não estou conseguindo fazer a variável lê-lo, pois mesmo mudando o default nada acontece.

Código:

escolha1=
ini_open("userconfig.cfg");
ini_read_real("options","tela",0);
ini_close()

É assim que se atribui o valor da ini a variavel?

Ah, é por isso... Me desculpe, eu não reparei isso no primeiro código.

ini_read_* retorna um valor, portanto, a variável que deve ser atualizada deve estar antes do comando da seguinte forma:

Código:

ini_open("userconfig.cfg");
escolha1 = ini_read_real("options","tela",0);
ini_close();

Se tiver apenas 1 arquivo ini no jogo, não terá a necessidade de fecha-lo?

DUDU951 escreveu:1 arquivo ini pode salvar apenas 1 seção, chave, valor por vez?

Se tiver apenas 1 arquivo ini no jogo, não terá a necessidade de fecha-lo?

1- Você pode salvar vários valores em uma seção, na chave somente um, a chave representa a variável que vai guardar o valor. Exemplo.

Código:

[Configuracao do server]//Seção
//Chave = valor
Porta = 888

2-O bom é sempre recolher seus valores e fechar, economizando assim memoria.