summary refs log tree commit diff stats
path: root/doc/lib.txt
blob: ccd97aa6e0457be2d96858253263386c31babfa9 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
=======================
Nimrod Standard Library
=======================

:Author: Andreas Rumpf
:Version: |nimrodversion|

Though the Nimrod Standard Library is still evolving, it is already quite
usable. It is divided into basic libraries that contains modules that virtually
every program will need and advanced libraries which are more heavy weight.
Advanced libraries are in the ``lib/base`` directory.

Basic libraries
===============

* `system <system.html>`_
  Basic procs and operators that every program needs. It also provides IO
  facilities for reading and writing text and binary files. It is imported
  implicitly by the compiler. Do not import it directly. It relies on compiler
  magic to work.

* `strutils <strutils.html>`_
  This module contains common string handling operations like converting a
  string into uppercase, splitting a string into substrings, searching for
  substrings, replacing substrings.

* `os <os.html>`_
  Basic operating system facilities like retrieving environment variables,
  reading command line arguments, working with directories, running shell
  commands, etc. This module is -- like any other basic library --
  platform independant.

* `math <math.html>`_
  Mathematical operations like cosine, square root.

* `complex <complex.html>`_
  This module implements complex numbers and their mathematical operations.

* `times <times.html>`_
  The ``times`` module contains basic support for working with time.

* `parseopt <parseopt.html>`_
  The ``parseopt`` module implements a command line option parser. This
  supports long and short command options with optional values and command line
  arguments.

* `parsecfg <parsecfg.html>`_
  The ``parsecfg`` module implements a high performance configuration file
  parser. The configuration file's syntax is similar to the Windows ``.ini``
  format, but much more powerful, as it is not a line based parser. String
  literals, raw string literals and triple quote string literals are supported
  as in the Nimrod programming language.

* `strtabs <strtabs.html>`_
  The ``strtabs`` module implements an efficient hash table that is a mapping
  from strings to strings. Supports a case-sensitive, case-insensitive and
  style-insensitive mode. An efficient string substitution operator  ``%``
  for the string table is also provided.

* `streams <streams.html>`_
  This module provides a stream interface and two implementations thereof:
  the `PFileStream` and the `PStringStream` which implement the stream
  interface for Nimrod file objects (`TFile`) and strings. Other modules
  may provide other implementations for this standard stream interface.

* `hashes <hashes.html>`_
  This module implements efficient computations of hash values for diverse
  Nimrod types.

* `lexbase <lexbase.html>`_
  This is a low level module that implements an extremely efficent buffering
  scheme for lexers and parsers. This is used by the ``parsecfg`` module.


Advanced libaries
=================

* `regexprs <regexprs.html>`_
  This module contains procedures and operators for handling regular
  expressions.

* `dialogs <dialogs.html>`_
  This module implements portable dialogs for Nimrod; the implementation
  builds on the GTK interface. On Windows, native dialogs are shown if
  appropriate.

* `zipfiles <zipfiles.html>`_
  This module implements a zip archive creator/reader/modifier.

Wrappers
========

Note that the generated HTML for some of these wrappers is so huge, that it is
not contained in the distribution. You can then find them on the website.

* `posix <posix.html>`_
  Contains a wrapper for the POSIX standard.
* `windows <windows.html>`_
  Contains a wrapper for the Win32 API.
* `shellapi <shellapi.html>`_
  Contains a wrapper for the ``shellapi.h`` header.
* `shfolder <shfolder.html>`_
  Contains a wrapper for the ``shfolder.h`` header.
* `mmsystem <mmsystem.html>`_
  Contains a wrapper for the ``mmsystem.h`` header.
* `ole2 <ole2.html>`_
  Contains GUIDs for OLE2 automation support.
* `nb30 <nb30.html>`_
  This module contains the definitions for portable NetBIOS 3.0 support.
* `cairo <cairo.html>`_
  Wrapper for the cairo library.
* `cairoft <cairoft.html>`_
  Wrapper for the cairoft library.
* `cairowin32 <cairowin32.html>`_
  Wrapper for the cairowin32 library.
* `cairoxlib <cairoxlib.html>`_
  Wrapper for the cairoxlib library.
* `atk <atk.html>`_
  Wrapper for the atk library.
* `gdk2 <gdk2.html>`_
  Wrapper for the gdk2 library.
* `gdk2pixbuf <gdk2pixbuf.html>`_
  Wrapper for the gdk2pixbuf library.
* `gdkglext <gdkglext.html>`_
  Wrapper for the gdkglext library.
* `glib2 <glib2.html>`_
  Wrapper for the glib2 library.
* `gtk2 <gtk2.html>`_
  Wrapper for the gtk2 library.
* `gtkglext <gtkglext.html>`_
  Wrapper for the gtkglext library.
* `gtkhtml <gtkhtml.html>`_
  Wrapper for the gtkhtml library.
* `libglade2 <libglade2.html>`_
  Wrapper for the libglade2 library.
* `pango <pango.html>`_
  Wrapper for the pango library.
* `pangoutils <pangoutils.html>`_
  Wrapper for the pangoutils library.
* `gl <gl.html>`_
  Part of the wrapper for OpenGL.
* `glext <glext.html>`_
  Part of the wrapper for OpenGL.
* `glu <glu.html>`_
  Part of the wrapper for OpenGL.
* `glut <glut.html>`_
  Part of the wrapper for OpenGL.
* `glx <glx.html>`_
  Part of the wrapper for OpenGL.
* `wingl <wingl.html>`_
  Part of the wrapper for OpenGL.
* `lua <lua.html>`_
  Part of the wrapper for Lua.
* `lualib <lualib.html>`_
  Part of the wrapper for Lua.
* `lauxlib <lauxlib.html>`_
  Part of the wrapper for Lua.
* `odbcsql <odbcsql.nim>`_
  interface to the ODBC driver. 
* `zlib <zlib.nim>`_
  Wrapper for the zlib library. 
* `sdl <sdl.html>`_
  Part of the wrapper for SDL.
* `sdl_gfx <sdl_gfx.html>`_
  Part of the wrapper for SDL.
* `sdl_image <sdl_image.html>`_
  Part of the wrapper for SDL.
* `sdl_mixer <sdl_mixer.html>`_
  Part of the wrapper for SDL.
* `sdl_net <sdl_net.html>`_
  Part of the wrapper for SDL.
* `sdl_ttf <sdl_ttf.html>`_
  Part of the wrapper for SDL.
* `smpeg <smpeg.html>`_
  Part of the wrapper for SDL.
* `cursorfont <cursorfont.html>`_
  Part of the wrapper for X11.
* `keysym <keysym.html>`_
  Part of the wrapper for X11.
* `x <x.html>`_
  Part of the wrapper for X11.
* `xatom <xatom.html>`_
  Part of the wrapper for X11.
* `xcms <xcms.html>`_
  Part of the wrapper for X11.
* `xf86dga <xf86dga.html>`_
  Part of the wrapper for X11.
* `xf86vmode <xf86vmode.html>`_
  Part of the wrapper for X11.
* `xi <xi.html>`_
  Part of the wrapper for X11.
* `xinerama <xinerama.html>`_
  Part of the wrapper for X11.
* `xkb <xkb.html>`_
  Part of the wrapper for X11.
* `xkblib <xkblib.html>`_
  Part of the wrapper for X11.
* `xlib <xlib.html>`_
  Part of the wrapper for X11.
* `xrandr <xrandr.html>`_
  Part of the wrapper for X11.
* `xrender <xrender.html>`_
  Part of the wrapper for X11.
* `xresource <xresource.html>`_
  Part of the wrapper for X11.
* `xshm <xshm.html>`_
  Part of the wrapper for X11.
* `xutil <xutil.html>`_
  Part of the wrapper for X11.
* `xv <xv.html>`_
  Part of the wrapper for X11.
* `xvlib <xvlib.html>`_
  Part of the wrapper for X11.
* `libzip <libzip.html>`_
  Interface to the `lib zip <http://www.nih.at/libzip/index.html>`_ library by
  Dieter Baron and Thomas Klausner.