[Dica] Batch com arquivo INI

INIFILE - ferramenta de 32 bits, Ver. 1.6 (c) 2006-2009, Horst Schaeffer
-------------------------------------------------------------

Esta ferramenta trabalha com arquivos do tipo INI de Windows com nomes de seção entre colchetes,
e as atribuições da forma: item=string (case ignorado por secção e nomes de item).
O arquivo INI deve existir!
Este programa utiliza as funções fornecidas pelo Microsoft Windows API.

Alterar ou adicionar um valor

Sintaxe: INIFileName INIFILE [seção] item=string

Exemplo: INIFILE c:\algum\lugar\programa.ini [perfil] Nome=John

Opcionalmente, a (inteira!) atribuição pode ser colocada entre (aspas) cotações.

Exemplo: INIFILE c:\algum\lugar\programa.ini [perfil] "Nome=John"

Se o item não for encontrado, uma nova linha será adicionada.
Se a secção não for encontrada, será criada.


Remover Valor

Para remover um item: omita o valor (o sinal de igualdade é obrigatório)

Sintaxe: INIFileName INIFILE [seção]=item

Exemplo: INIFILE c:\algum\lugar\programa.ini [Perfil] Nome=

O artigo completo (não apenas a seqüência de caracteres atribuído) é removido.
Se não houver itens restantes, a seção não será removida.
Nenhum erro será relatado (errorlevel), se o item não existe.

Limpar Valor

Se você quiser produzir um valor vazio sem removê-lo,
use dois sinais de igual.

Sintaxe: INIFileName INIFILE [seção] item==

Remover seção inteira

Para remover uma secção a opção de segurança /remover (case ignorado)
é necessária. Nenhum erro é relatado (errorlevel), se a secção não existe.

Sintaxe: INIFileName INIFILE [seção] /remover

Obter um valor

Sintaxe: INIFileName INIFILE [seção] item

(Note que um sinal adicional "igual" (=) iria remover o item!)

O programa irá gerar uma instrução SET, e enviá-lo para STDOUT.
Se você quiser produzir uma variável ambiental, redirecione a saída
para um arquivo de lote temporário e executá-lo.
Nota: O conjunto de caracteres é ANSI (Windows), não OEM (DOS).

Exemplo:
INIFile c:\algum\lugar\programa.ini [Perfil] Nome> temp.bat
call temp.bat

Se o valor não pôde ser encontrado por qualquer motivo,
a instrução SET estará vazia (set var=), que limpa a variável.


Obter todas os valores de uma seção

Sintaxe: INIFileName INIFILE [seção]

Instruções SET serão gerados para todos os itens da seção.


Errorlevels

Errorlevel > 0 indica um erro (mensagem para STDERR)
0 feito
1 arquivo INI não existe
2 nome da seção entre colchetes não foi dada
255 arquivo INI não especificado ou ajuda solicitada (/?)

As operações de arquivo INI é feito através da API do Windows que lida com espaços,
maiúsculas/minúsculas etc. Pode haver um limite de tamanho ou um problema com o arquivo longo em versões mais antigas do Windows. Por favor teste.

[Tens de ter uma conta e sessão iniciada para poderes visualizar este link]

O download acompanha o README (texto acima) em inglês.