inifile(n) Parsing of Windows INI files inifile(n)

NAME
       inifile - Parsing of Windows INI files

SYNOPSIS
       package require TTccll  88..22

       package require iinniiffiillee  ??00..11??

       ::::iinnii::::ooppeenn file ?mode?

       ::::iinnii::::cclloossee ini

       ::::iinnii::::ccoommmmiitt ini

       ::::iinnii::::rreevveerrtt ini

       ::::iinnii::::ffiilleennaammee ini

       ::::iinnii::::sseeccttiioonnss ini

       ::::iinnii::::kkeeyyss ini section

       ::::iinnii::::ggeett ini section

       ::::iinnii::::eexxiissttss ini section ?key?

       ::::iinnii::::vvaalluuee ini section key

       ::::iinnii::::sseett ini section key value

       ::::iinnii::::ddeelleettee ini section ?key?

       ::::iinnii::::ccoommmmeenntt ini section ?key? ?text...?



DESCRIPTION
       This package provides an interface for easy manipulation of Windows INI
       files.


       ::::iinnii::::ooppeenn file ?mode?
              Opens an INI file and returns a handle that  is  used  by  other
              commands.   Mode  has  the  same  types as the ooppeenn command. The
              default mode is rr++.

       ::::iinnii::::cclloossee ini
              Close the specified handle. If any changes  were  made  and  not
              written by ccoommmmiitt they are lost.

       ::::iinnii::::ccoommmmiitt ini
              Writes  the file and all changes to disk. The sections are writ-
              ten in arbitrary order. The keys in a  section  are  written  in
              alphabetical order.

       ::::iinnii::::rreevveerrtt ini
              Rolls  all  changes  made to the inifile object back to the last
              committed state.

       ::::iinnii::::ffiilleennaammee ini
              Returns the name of the file the ini object is associated  with.

       ::::iinnii::::sseeccttiioonnss ini
              Returns  a list of all the names of the existing sections in the
              file handle specified.

       ::::iinnii::::kkeeyyss ini section
              Returns a list of all they key names in  the  section  and  file
              specified.

       ::::iinnii::::ggeett ini section
              Returns  a list of key value pairs that exist in the section and
              file specified.

       ::::iinnii::::eexxiissttss ini section ?key?
              Returns a boolean value indicating the existance of  the  speci-
              fied  section  as  a whole or the specified key within that sec-
              tion.

       ::::iinnii::::vvaalluuee ini section key
              Returns the value of the named key from the specified section.

       ::::iinnii::::sseett ini section key value
              Sets the value of the key in the specified section. If the  sec-
              tion does not exist then a new one is created.

       ::::iinnii::::ddeelleettee ini section ?key?
              Removes the key or the entire section and all its keys.

       ::::iinnii::::ccoommmmeenntt ini section ?key? ?text...?
              Reads and modifies comments for sections and keys.



inifile                               0.1                           inifile(n)