Table of Contents

1. Introduction

1.1 Overview of Gauche
1.2 Notations

2. Concepts

2.1 Standard conformance
2.2 Multibyte Strings
2.3 Case-sensitivity
2.4 Integrated Object System
2.5 Module system
2.6 Compilation

3. Programming in Gauche

3.1 Invoking Gosh
3.2 Interactive development
3.3 Debugging
3.4 Writing Scheme scripts

3.4.1 Script compatibility before release 0.5

3.5 Writing Gauche modules

4. Core syntax

4.1 Lexical structure
4.2 Literals
4.3 Making Procedures
4.4 Assignments
4.5 Conditionals
4.6 Binding constructs
4.7 Sequencing
4.8 Iteration
4.9 Quasiquotation
4.10 Definitions
4.11 Modules

4.11.1 Module semantics
4.11.2 Defining and selecting modules
4.11.3 Using modules
4.11.4 Module inheritance
4.11.5 Module introspection
4.11.6 Predefined modules

5. Macros

5.1 Hygienic Macros
5.2 Traditional Macros
5.3 Macro expansion
5.4 Macro utilities

6. Core library

6.1 Equivalence
6.2 Numbers

6.2.1 Number classes
6.2.2 Numerical predicates
6.2.3 Numerical comparison
6.2.4 Arithmetics
6.2.5 Numerical conversions
6.2.6 Bitwise operations

6.3 Booleans
6.4 Pairs and Lists

6.4.1 Pair and null class
6.4.2 List predicates
6.4.3 List constructors
6.4.4 List accessors and modifiers
6.4.5 Other list procedures

6.5 Symbols
6.6 Keywords
6.7 Identifiers
6.8 Characters
6.9 Character Set
6.10 Strings

6.10.1 String syntax
6.10.2 String Predicates
6.10.3 String Constructors
6.10.4 String interpolation
6.10.5 String Accessors & Modifiers
6.10.6 String Comparison
6.10.7 String utilities
6.10.8 String Pointers
6.10.9 Incomplete strings

6.11 Regular expression
6.12 Vectors
6.13 Hashtables
6.14 Weak pointers
6.15 Control features

6.15.1 Procedures

6.15.1.1 Mapping
6.15.1.2 Combinators
6.15.1.3 Optional argument parsing
6.15.1.4 Procedure arity

6.15.2 Applicable objects
6.15.3 Continuation
6.15.4 Multiple values
6.15.5 Delayed Evaludation

6.16 Exceptions

6.16.1 Signalling errors
6.16.2 Handling errors
6.16.3 Exception object
6.16.4 Low-level exception mechanism

6.17 Eval and repl
6.18 Input and Output

6.18.1 Ports
6.18.2 Common port operations
6.18.3 File ports
6.18.4 String ports
6.18.5 Procedural ports
6.18.6 Input

6.18.6.1 Reading data
6.18.6.2 Read-time constructor
6.18.6.3 Input utility functions

6.18.7 Output

6.19 Loading Programs

6.19.1 Loading Scheme file
6.19.2 Load dynamic library
6.19.3 Require and provide
6.19.4 Autoload

6.20 Comparison and sorting
6.21 System interface

6.21.1 Program termination
6.21.2 Environment Inquiry
6.21.3 Filesystems

6.21.3.1 Directories
6.21.3.2 Directory manipulation
6.21.3.3 Pathnames
6.21.3.4 File stats
6.21.3.5 Other file operations

6.21.4 Unix groups and users

6.21.4.1 Unix Group
6.21.4.2 Unix users
6.21.4.3 Password encryption

6.21.5 Locale
6.21.6 Signal

6.21.6.1 Signals and signal sets
6.21.6.2 Sending signals
6.21.6.3 Handling signals
6.21.6.4 Masking and waiting signals
6.21.6.5 Signals and threads

6.21.7 System Inquiry
6.21.8 Time

6.21.8.1 POSIX time
6.21.8.2 SRFI time

6.21.9 Unix process management

6.21.9.1 Fork and exec
6.21.9.2 Wait

6.21.10 I/O multiplexing
6.21.11 Miscellaneous system calls

7. Object system

7.1 General Inquiry
7.2 Defining class

7.2.1 Multiple inheritance
7.2.2 Slot specification

7.3 Defining methods
7.4 Creating Instance
7.5 Accessing Instance
7.6 Metaobject procotol

7.6.1 System metaclasses
7.6.2 Class introspection

7.6.2.1 Class metaobject
7.6.2.2 Slot definition

7.6.3 Class instantiation
7.6.4 Customizing slot access
7.6.5 Method instantiation
7.6.6 Customizing method application

8. Library modules - Overview
9. Library modules - Gauche extensions

9.1 gauche.array - Arrays
9.2 gauche.charconv - Character Code Conversion

9.2.1 Supported character encoding schemes
9.2.2 Autodetecting the encoding scheme
9.2.3 Conversion ports
9.2.4 Extended port procedures

9.3 gauche.collection - Collection framework

9.3.1 Mapping over collection
9.3.2 Selection and searching in collection
9.3.3 Miscellaneous operations on collection
9.3.4 Fundamental iterator creators
9.3.5 Implementing collections

9.4 gauche.config - Configuration parameters
9.5 gauche.fcntl - Low-level file operations
9.6 gauche.interactive - Utilities for interactive session
9.7 gauche.listener - Listener
9.8 gauche.logger - User-level logging
9.9 gauche.mop.singleton - Singleton
9.10 gauche.mop.validator - Slot with validator
9.11 gauche.net - Networking

9.11.1 Socket address
9.11.2 High-level network functions
9.11.3 Low-level socket interface
9.11.4 Netdb interface

9.12 gauche.parameter - Parameters
9.13 gauche.parseopt - Parsing command-line options
9.14 gauche.process - High Level Process Interface

9.14.1 Process object
9.14.2 Process ports

9.15 gauche.regexp - Regular expression utilities
9.16 gauche.reload - Reloading modules
9.17 gauche.selector - Simple dispatcher
9.18 gauche.sequence - Sequence framework

9.18.1 Fundamental sequence accessors
9.18.2 Slicing sequence
9.18.3 Implementing sequence

9.19 gauche.syslog - Syslog
9.20 gauche.termios - Termios
9.21 gauche.test - Unit Testing
9.22 gauche.threads - Threads

9.22.1 Thread procedures
9.22.2 Synchronization primitives
9.22.3 Thread exceptions

9.23 gauche.time - Measure timings
9.24 gauche.uvector - Uniform vectors

9.24.1 Uvector basic operations
9.24.2 Uvector conversion operations
9.24.3 Uvector numeric operations
9.24.4 Uvector block I/O

9.25 gauche.version - Comparing version numbers

10. Library modules - SRFIs

10.1 srfi-0 - Feature conditional
10.2 srfi-1 - List library

10.2.1 List constructors
10.2.2 List predicates
10.2.3 List selectors
10.2.4 List miscellaneous routines
10.2.5 List fold, unfold & map
10.2.6 List filtering & partitioning
10.2.7 List searching
10.2.8 List deletion
10.2.9 Association lists
10.2.10 Lists as sets

10.3 srfi-2 - And-let*
10.4 srfi-4 - Homogeneous vectors
10.5 srfi-9 - Record types
10.6 srfi-11 - Let-values
10.7 srfi-13 - String library

10.7.1 General conventions
10.7.2 String predicates
10.7.3 String Constructors
10.7.4 String selection
10.7.5 String comparison
10.7.6 String Prefixes & Suffixes
10.7.7 String searching
10.7.8 String case mapping
10.7.9 String reverse & append
10.7.10 String mapping
10.7.11 String rotation
10.7.12 Other string operations
10.7.13 String filtering
10.7.14 Low-level string procedures

10.8 srfi-14 - Character-set library

10.8.1 Character-set constructors
10.8.2 Character-set comparison
10.8.3 Character-set iteration
10.8.4 Character-set query
10.8.5 Character-set algebra
10.8.6 Predefined character-set

10.9 srfi-19 - Time data types and procedures

10.9.1 Time types
10.9.2 Time queries
10.9.3 Time procedures
10.9.4 Date
10.9.5 Date reader and writer

10.10 srfi-27 - Sources of Random Bits

11. Library modules - Utilities

11.1 dbm - Generic DBM interface

11.1.1 Opening and closing a dbm database
11.1.2 Accessing a dbm database
11.1.3 Iterating on a dbm database

11.2 dbm.gdbm - GDBM interface
11.3 dbm.ndbm - NDBM interface
11.4 dbm.odbm - Original DBM interface
11.5 file.filter - Filtering file content
11.6 file.util - Filesystem utilities

11.6.1 Directory utilities
11.6.2 Pathname utilities
11.6.3 File attibute utilities
11.6.4 File operations

11.7 math.const - Mathematic constants
11.8 math.mt-random - Mersenne Twister Random number generator
11.9 rfc.822 - RFC822 message parsing
11.10 rfc.base64 - Base64 encoding/decoding
11.11 rfc.cookie - HTTP cookie handling
11.12 rfc.http - HTTP
11.13 rfc.quoted-printable - Quoted-printable encoding/decoding
11.14 rfc.uri - URI parsing and construction
11.15 slib - SLIB interface
11.16 text.csv - CSV tables
11.17 text.html-lite - Simple HTML document construction
11.18 text.parse - Parsing input stream
11.19 text.tr - Transliterate characters
11.20 text.tree - Lazy text construction
11.21 util.isomorph - Determine isomorphism
11.22 util.queue - Queue
11.23 util.toposort - Topological sort
11.24 www.cgi - CGI utility

A. References
B. C to Scheme mapping
C. Indices

C.1 Function and Syntax Index
C.2 Module Index
C.3 Class Index
C.4 Variable Index