# << Usage >>

# you can feed this README to irb and see the result
# $ irb README

# IMPORTANT NOTICE:
# be careful with big *fixnum* (plain int) values in configs
# int is 32 bit, but ruby fixnum is only 31!
# For example, 2100000000 will be read as -47483648.

require 'rconfig'
c = Config.new

c.read!('test.cfg')
# => IOError
c.read('test.cfg')
# => false

p c['some_var']
# => SettingNotFoundError
# note: Config#lookup is alias for Config#[]

c.append 'fixnum', Config::Fixnum.new(150)
# #<Config::Fixnum...>

f1 = Config::Fixnum.new(1)
c.append 'another_fixnum', f1

f2 = Config::Fixnum.new(256)
c.append 'next_fixnum', f2

p c.size
# => 3

c.delete(f1)            # by element
c.delete(0)             # by index
c.delete('next_fixnum') # by name
# note: (at now) you cannot delete nested elements by Config#delete
#       you can do c['nested.element'].parent.delete(c['nested.element'])

p c.size
# => 0

l = Config::List.new
c.append 'the_list', l

l.append Config::String.new("abcdef")
l << Config::Float.new(3.14)
# note: Config::List#append and Config::Array#append both have
#       aliases Config::[Aggregate]#<<

p l.name
# => "the_list"

p l.index
# => 0

p l.root?
# => false

p l.size
# => 3

l[0].format = Config::FORMAT_HEX

p l[1].value
# => 3.14

l[1].value = 2.71828

c.write 'test.cfg'

# you will get test.cfg with following contents:
#
# the_list = ( "abcdef", 2.71828, 0x2A );
#
ux.git/commit/lcd4linux.xpm?id=e6ee931ee5772eef9f18fe07bf6963c482a451f4&amp;follow=1'>commit</a><a href='/lcd4linux.git/diff/lcd4linux.xpm?id=e6ee931ee5772eef9f18fe07bf6963c482a451f4&amp;follow=1'>diff</a><a href='/lcd4linux.git/stats/lcd4linux.xpm'>stats</a></td><td class='form'><form class='right' method='get' action='/lcd4linux.git/log/lcd4linux.xpm'>
<input type='hidden' name='id' value='e6ee931ee5772eef9f18fe07bf6963c482a451f4'/><input type='hidden' name='showmsg' value='1'/><select name='qt'>
<option value='grep'>log msg</option>
<option value='author'>author</option>
<option value='committer'>committer</option>
<option value='range'>range</option>
</select>
<input class='txt' type='search' size='10' name='q' value=''/>
<input type='submit' value='search'/>
</form>
</td></tr></table>
<div class='path'>path: <a href='/lcd4linux.git/log/?id=e6ee931ee5772eef9f18fe07bf6963c482a451f4&amp;showmsg=1&amp;follow=1'>root</a>/<a href='/lcd4linux.git/log/lcd4linux.xpm?id=e6ee931ee5772eef9f18fe07bf6963c482a451f4&amp;showmsg=1&amp;follow=1'>lcd4linux.xpm</a> (<a href='/lcd4linux.git/log/lcd4linux.xpm?id=e6ee931ee5772eef9f18fe07bf6963c482a451f4&amp;showmsg=1'>unfollow</a>)</div><div class='content'><table class='list nowrap'><tr class='nohover'><th class='left'>Age</th><th class='left'>Commit message (<a href='/lcd4linux.git/log/lcd4linux.xpm?id=e6ee931ee5772eef9f18fe07bf6963c482a451f4&amp;follow=1'>Collapse</a>)</th><th class='left'>Author</th><th class='left'>Files</th><th class='left'>Lines</th></tr>
<tr class='logheader'><td><span title='2004-02-27 07:06:26 +0000'>2004-02-27</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/qprintf.h?id=485a26f6e3e2e84d7f9b8279fa6d7f440ea50a8b&amp;follow=1'>[lcd4linux @ 2004-02-27 07:06:24 by reinelt]</a></td><td>reinelt</td><td>5</td><td><span class='deletions'>-11</span>/<span class='insertions'>+200</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
new function 'qprintf()' (simple but quick snprintf() replacement)

git-svn-id: https://ssl.bulix.org/svn/lcd4linux/trunk@379 3ae390bd-cb1e-0410-b409-cd5a39f66f1f


</td></tr>
<tr class='logheader'><td><span title='2004-02-27 06:07:55 +0000'>2004-02-27</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/hash.h?id=af9193af58b39bf31ee8beabfac620b274da8b1c&amp;follow=1'>[lcd4linux @ 2004-02-27 06:07:55 by reinelt]</a></td><td>reinelt</td><td>2</td><td><span class='deletions'>-21</span>/<span class='insertions'>+40</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
hash improvements from Martin

git-svn-id: https://ssl.bulix.org/svn/lcd4linux/trunk@378 3ae390bd-cb1e-0410-b409-cd5a39f66f1f


</td></tr>
<tr class='logheader'><td><span title='2004-02-26 21:42:45 +0000'>2004-02-26</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/evaluator.c?id=3037be8a1e09d27d6150027b28e48738dbac0db1&amp;follow=1'>[lcd4linux @ 2004-02-26 21:42:45 by reinelt]</a></td><td>reinelt</td><td>1</td><td><span class='deletions'>-3</span>/<span class='insertions'>+12</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
memory leak fixes from Martin

git-svn-id: https://ssl.bulix.org/svn/lcd4linux/trunk@377 3ae390bd-cb1e-0410-b409-cd5a39f66f1f


</td></tr>