The nibbles-streams Reference Manual

This is the nibbles-streams Reference Manual, version 0.1, generated automatically by Declt version 4.0 beta 2 "William Riker" on Sun Dec 15 07:08:56 2024 GMT+0.

Table of Contents


1 Introduction


2 Systems

The main system appears first, followed by any subsystem dependency.


2.1 nibbles-streams

Proof of concept for lossless audio compressor

Author

Vasily Postnicov <>

License

2-clause BSD

Version

0.1

Dependencies
  • trivial-gray-streams (system).
  • nibbles (system).
  • serapeum (system).
Source

nibbles-streams.asd.

Child Components

3 Files

Files are sorted by type and then listed depth-first from the systems components trees.


3.1 Lisp


3.1.1 nibbles-streams/nibbles-streams.asd

Source

nibbles-streams.asd.

Parent Component

nibbles-streams (system).

ASDF Systems

nibbles-streams.


3.1.2 nibbles-streams/package.lisp

Source

nibbles-streams.asd.

Parent Component

nibbles-streams (system).

Packages

nibbles-streams.


3.1.3 nibbles-streams/signed-octets.lisp

Dependency

package.lisp (file).

Source

nibbles-streams.asd.

Parent Component

nibbles-streams (system).

Internals

3.1.4 nibbles-streams/nibbles-streams.lisp

Dependency

signed-octets.lisp (file).

Source

nibbles-streams.asd.

Parent Component

nibbles-streams (system).

Public Interface
Internals

4 Packages

Packages are listed by definition order.


4.1 nibbles-streams

Source

package.lisp.

Use List

common-lisp.

Public Interface
Internals

5 Definitions

Definitions are sorted by export status, category, package, and then by lexicographic order.


5.1 Public Interface


5.1.1 Generic functions

Generic Reader: nibbles-stream-element-type (object)
Package

nibbles-streams.

Methods
Reader Method: nibbles-stream-element-type ((nibbles-stream nibbles-stream))

Element type of nibble-stream. Setfable.

Source

nibbles-streams.lisp.

Target Slot

element-type.

Generic Function: (setf nibbles-stream-element-type) (object)
Package

nibbles-streams.

Methods
Writer Method: (setf nibbles-stream-element-type) :after ((stream nibbles-stream))
Source

nibbles-streams.lisp.

Target Slot

element-type.

Method: (setf nibbles-stream-element-type) :before ((stream nibbles-stream))
Source

nibbles-streams.lisp.

Method: (setf nibbles-stream-element-type) ((nibbles-stream nibbles-stream))

Element type of nibble-stream. Setfable.

Source

nibbles-streams.lisp.

Generic Reader: nibbles-stream-endianness (object)
Package

nibbles-streams.

Methods
Reader Method: nibbles-stream-endianness ((nibbles-stream nibbles-stream))

Endianness of the stream. Can be :LITTLE or :BIG

Source

nibbles-streams.lisp.

Target Slot

endianness.

Generic Function: (setf nibbles-stream-endianness) (object)
Package

nibbles-streams.

Methods
Writer Method: (setf nibbles-stream-endianness) :after ((stream nibbles-stream))
Source

nibbles-streams.lisp.

Target Slot

endianness.

Method: (setf nibbles-stream-endianness) :before ((stream nibbles-stream))
Source

nibbles-streams.lisp.

Method: (setf nibbles-stream-endianness) ((nibbles-stream nibbles-stream))

Endianness of the stream. Can be :LITTLE or :BIG

Source

nibbles-streams.lisp.


5.1.2 Standalone methods

Method: initialize-instance :after ((nibbles-stream nibbles-stream) &key element-type &allow-other-keys)
Source

nibbles-streams.lisp.

Method: make-load-form ((self db-entry) &optional env)
Source

nibbles-streams.lisp.

Method: print-object ((object db-entry) stream)
Source

nibbles-streams.lisp.

Method: stream-clear-input ((stream nibbles-input-stream))
Package

sb-gray.

Source

nibbles-streams.lisp.

Method: stream-clear-output ((stream nibbles-output-stream))
Package

sb-gray.

Source

nibbles-streams.lisp.

Method: stream-element-type ((stream nibbles-stream))
Source

nibbles-streams.lisp.

Method: stream-finish-output ((stream nibbles-output-stream))
Package

sb-gray.

Source

nibbles-streams.lisp.

Method: stream-force-output ((stream nibbles-output-stream))
Package

sb-gray.

Source

nibbles-streams.lisp.

Method: stream-read-byte ((stream nibbles-input-stream))
Package

sb-gray.

Source

nibbles-streams.lisp.

Method: stream-read-sequence ((stream nibbles-input-stream) sequence start end &key &allow-other-keys)
Package

trivial-gray-streams.

Source

nibbles-streams.lisp.

Method: stream-write-byte ((stream nibbles-output-stream) byte)
Package

sb-gray.

Source

nibbles-streams.lisp.

Method: stream-write-sequence ((stream nibbles-input-stream) sequence start end &key &allow-other-keys)
Package

trivial-gray-streams.

Source

nibbles-streams.lisp.


5.1.3 Conditions

Condition: nibbles-stream-error

Condition class realted to nibbles-stream.

Package

nibbles-streams.

Source

nibbles-streams.lisp.

Direct superclasses

simple-error.


5.1.4 Classes

Class: nibbles-input-stream

Input nibbles stream.

Package

nibbles-streams.

Source

nibbles-streams.lisp.

Direct superclasses
Direct methods
Direct slots
Slot: byte-reader

Function which is called to read a byte from the stream

Type

function

Readers

nibbles-stream-byte-reader.

Writers

(setf nibbles-stream-byte-reader).

Slot: sequence-reader

Function which is called to read a sequence of bytes from the stream

Type

function

Readers

nibbles-stream-sequence-reader.

Writers

(setf nibbles-stream-sequence-reader).

Class: nibbles-output-stream

Output nibbles stream.

Package

nibbles-streams.

Source

nibbles-streams.lisp.

Direct superclasses
Direct methods
Direct slots
Slot: byte-writer

Function which is called to write a byte to the stream

Type

function

Readers

nibbles-stream-byte-writer.

Writers

(setf nibbles-stream-byte-writer).

Slot: sequence-writer

Function which is called to write a sequence of bytes to the stream

Type

function

Readers

nibbles-stream-sequence-writer.

Writers

(setf nibbles-stream-sequence-writer).

Class: nibbles-stream

Generic nibbles stream. Not to be instantiated.

Package

nibbles-streams.

Source

nibbles-streams.lisp.

Direct superclasses

fundamental-binary-stream.

Direct subclasses
Direct methods
Direct slots
Slot: element-type

Element type of nibble-stream. Setfable.

Initargs

:element-type

Readers

nibbles-stream-element-type.

Writers

(setf nibbles-stream-element-type).

Slot: endianness

Endianness of the stream. Can be :LITTLE or :BIG

Type

(member :big :little)

Initform

:little

Initargs

:endianness

Readers

nibbles-stream-endianness.

Writers

(setf nibbles-stream-endianness).

Slot: stream

Underlying stream. Must be specified at creation time.

Package

common-lisp.

Type

stream

Initform

(error "specify underlying stream")

Initargs

:stream

Readers

nibbles-stream-stream.

Writers

This slot is read-only.


5.2 Internals


5.2.1 Special variables

Special Variable: *function-db*
Package

nibbles-streams.

Source

nibbles-streams.lisp.


5.2.2 Ordinary functions

Function: copy-db-entry (db-entry1 &key endianness element-type byte-reader sequence-reader byte-writer sequence-writer)

Copy an instance of DB-ENTRY, optionally overriding some or all of its slots.

Package

nibbles-streams.

Source

nibbles-streams.lisp.

Function: db-entry (endianness element-type byte-reader sequence-reader byte-writer sequence-writer)
Package

nibbles-streams.

Source

nibbles-streams.lisp.

Reader: db-entry-byte-reader (instance)
Package

nibbles-streams.

Source

nibbles-streams.lisp.

Target Slot

byte-reader.

Reader: db-entry-byte-writer (instance)
Package

nibbles-streams.

Source

nibbles-streams.lisp.

Target Slot

byte-writer.

Reader: db-entry-element-type (instance)
Package

nibbles-streams.

Source

nibbles-streams.lisp.

Target Slot

element-type.

Reader: db-entry-endianness (instance)
Package

nibbles-streams.

Source

nibbles-streams.lisp.

Target Slot

endianness.

Reader: db-entry-sequence-reader (instance)
Package

nibbles-streams.

Source

nibbles-streams.lisp.

Target Slot

sequence-reader.

Reader: db-entry-sequence-writer (instance)
Package

nibbles-streams.

Source

nibbles-streams.lisp.

Target Slot

sequence-writer.

Function: find-entry (endianness type)
Package

nibbles-streams.

Source

nibbles-streams.lisp.

Function: nibbles-functions ()
Package

nibbles-streams.

Source

nibbles-streams.lisp.

Function: read-sb8 (stream &optional eof-error-p eof-value)
Package

nibbles-streams.

Source

signed-octets.lisp.

Function: read-sb8-sequence (seq stream &key start end)
Package

nibbles-streams.

Source

signed-octets.lisp.

Function: sb8->ub8 (byte)
Package

nibbles-streams.

Source

signed-octets.lisp.

Function: typesequalp (t1 t2)
Package

nibbles-streams.

Source

nibbles-streams.lisp.

Function: ub8->sb8 (byte)
Package

nibbles-streams.

Source

signed-octets.lisp.

Function: write-sb8 (byte stream)
Package

nibbles-streams.

Source

signed-octets.lisp.

Function: write-sb8-sequence (seq stream &key start end)
Package

nibbles-streams.

Source

signed-octets.lisp.


5.2.3 Generic functions

Generic Reader: nibbles-stream-byte-reader (object)
Generic Writer: (setf nibbles-stream-byte-reader) (object)
Package

nibbles-streams.

Methods
Reader Method: nibbles-stream-byte-reader ((nibbles-input-stream nibbles-input-stream))
Writer Method: (setf nibbles-stream-byte-reader) ((nibbles-input-stream nibbles-input-stream))

Function which is called to read a byte from the stream

Source

nibbles-streams.lisp.

Target Slot

byte-reader.

Generic Reader: nibbles-stream-byte-writer (object)
Generic Writer: (setf nibbles-stream-byte-writer) (object)
Package

nibbles-streams.

Methods
Reader Method: nibbles-stream-byte-writer ((nibbles-output-stream nibbles-output-stream))
Writer Method: (setf nibbles-stream-byte-writer) ((nibbles-output-stream nibbles-output-stream))

Function which is called to write a byte to the stream

Source

nibbles-streams.lisp.

Target Slot

byte-writer.

Generic Reader: nibbles-stream-sequence-reader (object)
Generic Writer: (setf nibbles-stream-sequence-reader) (object)
Package

nibbles-streams.

Methods
Reader Method: nibbles-stream-sequence-reader ((nibbles-input-stream nibbles-input-stream))
Writer Method: (setf nibbles-stream-sequence-reader) ((nibbles-input-stream nibbles-input-stream))

Function which is called to read a sequence of bytes from the stream

Source

nibbles-streams.lisp.

Target Slot

sequence-reader.

Generic Reader: nibbles-stream-sequence-writer (object)
Generic Writer: (setf nibbles-stream-sequence-writer) (object)
Package

nibbles-streams.

Methods
Reader Method: nibbles-stream-sequence-writer ((nibbles-output-stream nibbles-output-stream))
Writer Method: (setf nibbles-stream-sequence-writer) ((nibbles-output-stream nibbles-output-stream))

Function which is called to write a sequence of bytes to the stream

Source

nibbles-streams.lisp.

Target Slot

sequence-writer.

Generic Reader: nibbles-stream-stream (object)
Package

nibbles-streams.

Methods
Reader Method: nibbles-stream-stream ((nibbles-stream nibbles-stream))

Underlying stream. Must be specified at creation time.

Source

nibbles-streams.lisp.

Target Slot

stream.

Generic Function: update-functions (stream)

Update reader or writer functions after a change of element-type or endiannes.

Package

nibbles-streams.

Source

nibbles-streams.lisp.

Methods
Method: update-functions ((stream nibbles-input-stream))
Method: update-functions ((stream nibbles-output-stream))

5.2.4 Standalone methods

Method: %constructor= ((o1 db-entry) (o2 db-entry))
Package

serapeum.

Source

nibbles-streams.lisp.

Method: constructor-values/generic ((x db-entry))
Package

serapeum.

Source

nibbles-streams.lisp.

Method: read-only-struct-slot-names append ((self db-entry))
Package

serapeum.

Source

nibbles-streams.lisp.


5.2.5 Structures

Structure: db-entry
Package

nibbles-streams.

Source

nibbles-streams.lisp.

Direct superclasses

%read-only-struct.

Direct methods
Direct slots
Slot: endianness
Type

(member :big :little)

Initform

(alexandria:required-argument (quote nibbles-streams::endianness))

Readers

db-entry-endianness.

Writers

This slot is read-only.

Slot: element-type
Initform

(alexandria:required-argument (quote nibbles-streams::element-type))

Readers

db-entry-element-type.

Writers

This slot is read-only.

Slot: byte-reader
Type

function

Initform

(alexandria:required-argument (quote nibbles-streams::byte-reader))

Readers

db-entry-byte-reader.

Writers

This slot is read-only.

Slot: sequence-reader
Type

function

Initform

(alexandria:required-argument (quote nibbles-streams::sequence-reader))

Readers

db-entry-sequence-reader.

Writers

This slot is read-only.

Slot: byte-writer
Type

function

Initform

(alexandria:required-argument (quote nibbles-streams::byte-writer))

Readers

db-entry-byte-writer.

Writers

This slot is read-only.

Slot: sequence-writer
Type

function

Initform

(alexandria:required-argument (quote nibbles-streams::sequence-writer))

Readers

db-entry-sequence-writer.

Writers

This slot is read-only.


Appendix A Indexes


A.1 Concepts


A.2 Functions

Jump to:   %   (  
C   D   F   G   I   M   N   P   R   S   T   U   W  
Index Entry  Section

%
%constructor=: Private standalone methods

(
(setf nibbles-stream-byte-reader): Private generic functions
(setf nibbles-stream-byte-reader): Private generic functions
(setf nibbles-stream-byte-writer): Private generic functions
(setf nibbles-stream-byte-writer): Private generic functions
(setf nibbles-stream-element-type): Public generic functions
(setf nibbles-stream-element-type): Public generic functions
(setf nibbles-stream-element-type): Public generic functions
(setf nibbles-stream-element-type): Public generic functions
(setf nibbles-stream-endianness): Public generic functions
(setf nibbles-stream-endianness): Public generic functions
(setf nibbles-stream-endianness): Public generic functions
(setf nibbles-stream-endianness): Public generic functions
(setf nibbles-stream-sequence-reader): Private generic functions
(setf nibbles-stream-sequence-reader): Private generic functions
(setf nibbles-stream-sequence-writer): Private generic functions
(setf nibbles-stream-sequence-writer): Private generic functions

C
constructor-values/generic: Private standalone methods
copy-db-entry: Private ordinary functions

D
db-entry: Private ordinary functions
db-entry-byte-reader: Private ordinary functions
db-entry-byte-writer: Private ordinary functions
db-entry-element-type: Private ordinary functions
db-entry-endianness: Private ordinary functions
db-entry-sequence-reader: Private ordinary functions
db-entry-sequence-writer: Private ordinary functions

F
find-entry: Private ordinary functions
Function, copy-db-entry: Private ordinary functions
Function, db-entry: Private ordinary functions
Function, db-entry-byte-reader: Private ordinary functions
Function, db-entry-byte-writer: Private ordinary functions
Function, db-entry-element-type: Private ordinary functions
Function, db-entry-endianness: Private ordinary functions
Function, db-entry-sequence-reader: Private ordinary functions
Function, db-entry-sequence-writer: Private ordinary functions
Function, find-entry: Private ordinary functions
Function, nibbles-functions: Private ordinary functions
Function, read-sb8: Private ordinary functions
Function, read-sb8-sequence: Private ordinary functions
Function, sb8->ub8: Private ordinary functions
Function, typesequalp: Private ordinary functions
Function, ub8->sb8: Private ordinary functions
Function, write-sb8: Private ordinary functions
Function, write-sb8-sequence: Private ordinary functions

G
Generic Function, (setf nibbles-stream-byte-reader): Private generic functions
Generic Function, (setf nibbles-stream-byte-writer): Private generic functions
Generic Function, (setf nibbles-stream-element-type): Public generic functions
Generic Function, (setf nibbles-stream-endianness): Public generic functions
Generic Function, (setf nibbles-stream-sequence-reader): Private generic functions
Generic Function, (setf nibbles-stream-sequence-writer): Private generic functions
Generic Function, nibbles-stream-byte-reader: Private generic functions
Generic Function, nibbles-stream-byte-writer: Private generic functions
Generic Function, nibbles-stream-element-type: Public generic functions
Generic Function, nibbles-stream-endianness: Public generic functions
Generic Function, nibbles-stream-sequence-reader: Private generic functions
Generic Function, nibbles-stream-sequence-writer: Private generic functions
Generic Function, nibbles-stream-stream: Private generic functions
Generic Function, update-functions: Private generic functions

I
initialize-instance: Public standalone methods

M
make-load-form: Public standalone methods
Method, %constructor=: Private standalone methods
Method, (setf nibbles-stream-byte-reader): Private generic functions
Method, (setf nibbles-stream-byte-writer): Private generic functions
Method, (setf nibbles-stream-element-type): Public generic functions
Method, (setf nibbles-stream-element-type): Public generic functions
Method, (setf nibbles-stream-element-type): Public generic functions
Method, (setf nibbles-stream-endianness): Public generic functions
Method, (setf nibbles-stream-endianness): Public generic functions
Method, (setf nibbles-stream-endianness): Public generic functions
Method, (setf nibbles-stream-sequence-reader): Private generic functions
Method, (setf nibbles-stream-sequence-writer): Private generic functions
Method, constructor-values/generic: Private standalone methods
Method, initialize-instance: Public standalone methods
Method, make-load-form: Public standalone methods
Method, nibbles-stream-byte-reader: Private generic functions
Method, nibbles-stream-byte-writer: Private generic functions
Method, nibbles-stream-element-type: Public generic functions
Method, nibbles-stream-endianness: Public generic functions
Method, nibbles-stream-sequence-reader: Private generic functions
Method, nibbles-stream-sequence-writer: Private generic functions
Method, nibbles-stream-stream: Private generic functions
Method, print-object: Public standalone methods
Method, read-only-struct-slot-names: Private standalone methods
Method, stream-clear-input: Public standalone methods
Method, stream-clear-output: Public standalone methods
Method, stream-element-type: Public standalone methods
Method, stream-finish-output: Public standalone methods
Method, stream-force-output: Public standalone methods
Method, stream-read-byte: Public standalone methods
Method, stream-read-sequence: Public standalone methods
Method, stream-write-byte: Public standalone methods
Method, stream-write-sequence: Public standalone methods
Method, update-functions: Private generic functions
Method, update-functions: Private generic functions

N
nibbles-functions: Private ordinary functions
nibbles-stream-byte-reader: Private generic functions
nibbles-stream-byte-reader: Private generic functions
nibbles-stream-byte-writer: Private generic functions
nibbles-stream-byte-writer: Private generic functions
nibbles-stream-element-type: Public generic functions
nibbles-stream-element-type: Public generic functions
nibbles-stream-endianness: Public generic functions
nibbles-stream-endianness: Public generic functions
nibbles-stream-sequence-reader: Private generic functions
nibbles-stream-sequence-reader: Private generic functions
nibbles-stream-sequence-writer: Private generic functions
nibbles-stream-sequence-writer: Private generic functions
nibbles-stream-stream: Private generic functions
nibbles-stream-stream: Private generic functions

P
print-object: Public standalone methods

R
read-only-struct-slot-names: Private standalone methods
read-sb8: Private ordinary functions
read-sb8-sequence: Private ordinary functions

S
sb8->ub8: Private ordinary functions
stream-clear-input: Public standalone methods
stream-clear-output: Public standalone methods
stream-element-type: Public standalone methods
stream-finish-output: Public standalone methods
stream-force-output: Public standalone methods
stream-read-byte: Public standalone methods
stream-read-sequence: Public standalone methods
stream-write-byte: Public standalone methods
stream-write-sequence: Public standalone methods

T
typesequalp: Private ordinary functions

U
ub8->sb8: Private ordinary functions
update-functions: Private generic functions
update-functions: Private generic functions
update-functions: Private generic functions

W
write-sb8: Private ordinary functions
write-sb8-sequence: Private ordinary functions