1. General

1.1. 64-bit data models

1.2. Addressable memory space

Ordinary storage implementation can address any Scheme object scattered on whole memory space. Both storage-fatty and storage-compact have no limitation on any 32 and 64-bit data models. But it may be limited if a storage implementation is designed to do so for some specific advantages, as like GNU Emacs' 28-bit tagged pointer does.

1.3. Integer range

Only supports fixnum, and its range is varied by the user-selected underlying storage implementation. The range can be known via SRFI-77 compatible (least-fixnum) and (greatest-fixnum).

2. R5RS conformance

2.1. Proper tail recursion

Supported.

2.2. Continuations

Limited to nested use due to its setjmp/longjmp implementation. If a continuation that is not an ancestor of current continuation called, all continuation objects lying between the curent and the common ancestor of the destination are invalidated. Calling an invalidated continuation object causes an error.

2.3. Macros

The hygienic macros are fully supported.

2.4. Numbers

Only integer part is implemented.

2.5. Characters

All character category-sensitive procedures and predicates (such as char-upcase) work correctly only in ASCII range. i.e. Neigher Unicode processing specified in SRFI-75 nor other non-Unicode multibyte character processing are supported in such procedures/predicates.

2.6. Case-insensitive character comparison

SigScheme's case-insensitive comparison conforms to the foldcase'ed comparison described in SRFI-75 and SRFI-13, although R5RS does not specify comparison between alphabetic and non-alphabetic char.

See the description in operations.c for further details.

2.7. Case-sensitive identifiers

SigScheme does distinguish letter case in indentifiers. Although case insensitivity is required in R5RS as follows, it is hard to accept for the our application.

  2. Lexical conventions

  Upper and lower case forms of a letter are never distinguished except
  within character and string constants. For example, `Foo' is the same
  identifier as `FOO', and #x1AB is the same number as #X1ab.

2.8. Constant string

SigScheme treats string literals as constant as specified in R5RS.

Example: constant string
sscm> (string-set! "foo" 0 #\F)
Error: in string-set!: attempted to modify immutable string: "foo"
sscm> (string-set! (string-copy "foo") 0 #\F)
"Foo"

2.9. Constant list

SigScheme inhibits modification of constant list object by default as specified in R5RS, if the storage implementation suports it. storage-fatty supports it, but storage-compact does not due to no bit space for pair object.

The behavior can be changed by SCM_CONST_LIST_LITERAL.

  4.1.2 Literal expressions

      `(quote <datum>)' may be abbreviated as '<datum>. The two notations
      are equivalent in all respects.

      'a                                     ==>  a
      '#(a b c)                              ==>  #(a b c)
      '()                                    ==>  ()
      '(+ 1 2)                               ==>  (+ 1 2)
      '(quote a)                             ==>  (quote a)
      ''a                                    ==>  (quote a)

      As noted in section 3.4 Storage model, it is an error to alter a
      constant (i.e. the value of a literal expression) using a mutation
      procedure like `set-car!' or `string-set!'.

  6.3.2 Pairs and lists

  procedure: set-car! pair obj

      Stores obj in the car field of pair. The value returned by `set-car!'
      is unspecified.

      (define (g) '(constant-list))
      (set-car! (g) 3)                       ==>  error

2.10. Constant vector

SigScheme inhibits modification of constant vector object by default as specified in R5RS, if the storage implementation suports it. storage-fatty supports it, but storage-compact is not yet.

The behavior can be changed by SCM_CONST_VECTOR_LITERAL.

  6.3.6 Vectors

  procedure: vector-set! vector k obj

      (vector-set! '#(0 1 2) 1 "doe")
                ==>  error  ; constant vector

2.11. Quote-less null list

SigScheme allows quote-less null list by default for convenience and performance. But it can be error as specified in R5RS, when SCM_STRICT_R5RS is enabled.

Example: SCM_STRICT_R5RS disabled
sscm> (null? ())
#t
Example: SCM_STRICT_R5RS enabled
sscm> (null? ())
Error: eval: () is not a valid R5RS form. use '() instead

2.12. Quote-less vector literal

Sigscheme inhibits quote-less vector literal by default, as specified in R5RS.

The behavior can be changed by SCM_STRICT_VECTOR_FORM.

  6.3.6 Vectors

  Vectors are written using the notation #(obj ...). For example, a vector
  of length 3 containing the number zero in element 0, the list `(2 2 2 2)'
  in element 1, and the string `"Anna"' in element 2 can be written as
  following:

  #(0 (2 2 2 2) "Anna")

  Note that this is the external representation of a vector, not an
  expression evaluating to a vector. Like list constants, vector constants
  must be quoted:

  '#(0 (2 2 2 2) "Anna")
            ==>  #(0 (2 2 2 2) "Anna")
Example: vector literals
sscm> #(1 2 3)
Error: eval: #() is not a valid R5RS form. use '#() instead
sscm> '#(1 2 3)
#(1 2 3)

2.13. Environment specifiers

(null-environment) and (scheme-report-environment) does not return correct environemnt specified in R5RS. Current implementation returns same object of (interaction-environment).

2.14. Internal definitions

SigScheme strictly conforms to the internal definitions defined in R5RS (cited below) if SCM_STRICT_DEFINE_PLACEMENT is enabled (default). It can be disabled to get the syntax loosen, shrink the footprint and reduce runtime cost.

  5.2.2 Internal definitions

  Definitions may occur at the beginning of a <body> (that is, the body of a
  lambda, let, let*, letrec, let-syntax, or letrec-syntax expression or that of
  a definition of an appropriate form). Such definitions are known as internal
  definitions as opposed to the top level definitions described above.

2.15. Superfluous arguments

Superfluous or dotted arguments are strictly rejected as an error if SCM_STRICT_ARGCHECK is enabled. Otherwise ignored. Resource-sensitive apprication could disable it.

Example: SCM_STRICT_ARGCHECK enabled
sscm> (car '(1 2) 3 4)
ERROR: in (function call): superfluous argument(s): (3 4)
sscm> (symbol? 'foo . #t)
ERROR: in (function call): improper argument list terminator: #t
sscm> (+ 3 4 . 5)
ERROR: in (reduction): improper argument list terminator: 5
Example: SCM_STRICT_ARGCHECK disabled
sscm> (car '(1 2) 3 4)
1
sscm> (symbol? 'foo . #t)
#t
sscm> (+ 3 4 . 5)
7

2.16. Syntaxes/procedures not implemented

Following R5RS syntaxes and procedures are not implemented (yet).

2.16.1. Numbers

2.16.2. System interface

3. SRFI conformance

3.1. SRFI-1 List Library

Although a C implementation module-srfi1.c is existing, it is still broken and should not use for production codes. To get SRFI-1 working with SigScheme, use SLIB version of the library (will made available after some preparations).

3.2. SRFI-23 Error Reporting Mechanism

The error procedure throws a SigScheme-specific error object in cooperate with "SRFI-34 Exception Handling for Programs". Since the error objects are represented as a list, be careful on catching an exception based on its type. If you want to distinguish the error objects from ordinary lists, use SigScheme-specific %%error-object? predicate.

Example: Error objects are also caught as a list
sscm> (guard (obj ((pair? obj) obj)) (error "reason" 1 2 3))
#<error "reason" 1 2 3>
Example: Error object internal
sscm> (define err (guard (err (#t err)) (error "reason" 1 2 3)))
err
sscm> err
#<error "reason" 1 2 3>
sscm> (pair? err)
#t
sscm> (car err)
(#<undef> . #<undef>)
sscm> (%%error-object? err)
#t

3.3. SRFI-38 External Representation for Data with Shared Structure

Only write-with-shared-structure is implemented and read-with-shared-structure is not. The optional alias write/ss described in SRFI-38 is also defined.

The shared index starts with #1 (not #0).

Example: Shared index starts with #1
sscm> (define lst (list 'a 'b))
lst
sscm> (set-cdr! lst lst)
#1=(a . #1#)
sscm> lst
#1=(a . #1#)

3.4. SRFI-48 Intermediate Format Strings

The d part of ~w,dF directive is acceptable, but completely ignored on output format. Since SigScheme only supports integer currently, number is always formatted as integer even if the d part is specified.

Example: proper behavior
(format "~3F"   3)  => "  3"
(format "~3,2F" 3)  => "3.00"
Example: SigScheme
(format "~3F"   3)  => "  3"
(format "~3,2F" 3)  => "  3"

3.5. SRFI-60 Integer as Bits

Only following procedures are implemented.

And the others listed below are not.

3.6. SRFI-75 R6RS Unicode data

FIXME

4. SIOD compatibility