# << 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 );
#
f6b7949440cd735d0184c846aa2a3330f23&amp;follow=1'>commit</a><a href='/lcd4linux.git/diff/drv_picoLCDGraphic.c?id=e6f31f6b7949440cd735d0184c846aa2a3330f23&amp;follow=1'>diff</a><a href='/lcd4linux.git/stats/drv_picoLCDGraphic.c'>stats</a></td><td class='form'><form class='right' method='get' action='/lcd4linux.git/log/drv_picoLCDGraphic.c'>
<input type='hidden' name='id' value='e6f31f6b7949440cd735d0184c846aa2a3330f23'/><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=e6f31f6b7949440cd735d0184c846aa2a3330f23&amp;follow=1'>root</a>/<a href='/lcd4linux.git/log/drv_picoLCDGraphic.c?id=e6f31f6b7949440cd735d0184c846aa2a3330f23&amp;follow=1'>drv_picoLCDGraphic.c</a> (<a href='/lcd4linux.git/log/drv_picoLCDGraphic.c?id=e6f31f6b7949440cd735d0184c846aa2a3330f23'>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/drv_picoLCDGraphic.c?id=e6f31f6b7949440cd735d0184c846aa2a3330f23&amp;showmsg=1&amp;follow=1'>Expand</a>)</th><th class='left'>Author</th><th class='left'>Files</th><th class='left'>Lines</th></tr>
<tr><td><span title='2008-09-03 03:26:29 +0000'>2008-09-03</span></td><td><a href='/lcd4linux.git/commit/drv_D4D.c?id=1285008c5f75c28d6304ba984c432992c450ba3a&amp;follow=1'>indent</a></td><td>michael</td><td>1</td><td><span class='deletions'>-4</span>/<span class='insertions'>+4</span></td></tr>
<tr><td><span title='2008-08-31 18:27:53 +0000'>2008-08-31</span></td><td><a href='/lcd4linux.git/commit/drv_generic_serial.c?id=02b0138a4213eff843990f96531cf31918d6dfe2&amp;follow=1'>Increased the maximum bps to 230400, if defined in &lt;termios.h&gt;.</a></td><td>sonic74</td><td>1</td><td><span class='deletions'>-2</span>/<span class='insertions'>+7</span></td></tr>
<tr><td><span title='2008-08-27 22:32:47 +0000'>2008-08-27</span></td><td><a href='/lcd4linux.git/commit/drv_D4D.c?id=9e0932674b6e85098e3902f4c3083e80c9590be5&amp;follow=1'>git-svn-id: https://ssl.bulix.org/svn/lcd4linux/trunk@889 3ae390bd-cb1e-0410-...</a></td><td>sonic74</td><td>1</td><td><span class='deletions'>-18</span>/<span class='insertions'>+11</span></td></tr>
<tr><td><span title='2008-08-27 03:30:06 +0000'>2008-08-27</span></td><td><a href='/lcd4linux.git/commit/drv_D4D.c?id=b645e0908429a1ed5c61f2708931bfa026254d52&amp;follow=1'>D4D updates by Sven</a></td><td>michael</td><td>1</td><td><span class='deletions'>-38</span>/<span class='insertions'>+60</span></td></tr>
<tr><td><span title='2008-08-03 03:10:49 +0000'>2008-08-03</span></td><td><a href='/lcd4linux.git/commit/smoketest.sh?id=38367abf672c32015cacd8b469c390a048f2c97f&amp;follow=1'>driver for 4D Systems serial displays by Sven Killig</a></td><td>michael</td><td>9</td><td><span class='deletions'>-45</span>/<span class='insertions'>+846</span></td></tr>
<tr><td><span title='2008-08-03 02:44:22 +0000'>2008-08-03</span></td><td><a href='/lcd4linux.git/commit/drv_IRLCD.c?id=e91cbd072ab678b68095a5e81fc37df6ae44c975&amp;follow=1'>signed/unsigned mismatch</a></td><td>michael</td><td>1</td><td><span class='deletions'>-3</span>/<span class='insertions'>+3</span></td></tr>
<tr><td><span title='2008-07-26 14:41:51 +0000'>2008-07-26</span></td><td><a href='/lcd4linux.git/commit/plugin_mpd.c?id=58d42c80d71e628ddf8fc32cae477f17cb3a3f25&amp;follow=1'>added command functions</a></td><td>michux</td><td>1</td><td><span class='deletions'>-2</span>/<span class='insertions'>+130</span></td></tr>
<tr><td><span title='2008-07-15 10:22:19 +0000'>2008-07-15</span></td><td><a href='/lcd4linux.git/commit/svn_version.h?id=b243fddf0754e8d193febc0598941fd1638ff33b&amp;follow=1'>added IRLCD driver by Jean-Philippe Civade</a></td><td>michael</td><td>10</td><td><span class='deletions'>-5</span>/<span class='insertions'>+467</span></td></tr>
<tr><td><span title='2008-07-15 09:55:18 +0000'>2008-07-15</span></td><td><a href='/lcd4linux.git/commit/mkinstalldirs?id=38a69aee81b48e2df7714310c39b5cdf171b9123&amp;follow=1'>'autoreconf -f -i' run &amp; config.rpath added</a></td><td>michael</td><td>8</td><td><span class='deletions'>-370</span>/<span class='insertions'>+1617</span></td></tr>