The com.google.base Reference Manual

Table of Contents

Next: , Previous: , Up: (dir)   [Contents][Index]

The com.google.base Reference Manual

This is the com.google.base Reference Manual, version 1.4, generated automatically by Declt version 2.4 "Will Decker" on Wed Jun 20 11:37:43 2018 GMT+0.


Next: , Previous: , Up: Top   [Contents][Index]

1 Introduction


Universally useful Lisp code that lives in package com.google.base.

The intent is that the base package only contains code that's highly likely to
be useful in every Lisp application.  Currently it contains:

    a nicer version of DEFCONSTANT
    a macro for generating simple PRINT-OBJECT methods
    a MISSING-ARGUMENT function for use in DEFCLASS forms
    functions for manipulating utf-8 strings stored as vectors of 8-bit octets
    common compiler optimization settings
    functions for extracting the prefix or suffix of a sequence
    Lisp type definitions for common C integer types


Next: , Previous: , Up: Top   [Contents][Index]

2 Systems

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


Previous: , Up: Systems   [Contents][Index]

2.1 com.google.base

Author

Robert Brown

License

New BSD license. See the copyright messages in individual files.

Description

Universally useful Lisp code.

Long Description

Code that should be useful for any Lisp application.

Version

1.4

Source

com.google.base.asd (file)

Components

Next: , Previous: , Up: Top   [Contents][Index]

3 Files

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


Previous: , Up: Files   [Contents][Index]

3.1 Lisp


Next: , Previous: , Up: Lisp files   [Contents][Index]

3.1.1 com.google.base.asd

Location

com.google.base.asd

Systems

com.google.base (system)


Next: , Previous: , Up: Lisp files   [Contents][Index]

3.1.2 com.google.base/package.lisp

Parent

com.google.base (system)

Location

package.lisp

Packages

com.google.base


Next: , Previous: , Up: Lisp files   [Contents][Index]

3.1.3 com.google.base/optimize.lisp

Dependency

package.lisp (file)

Parent

com.google.base (system)

Location

optimize.lisp

Exported Definitions

Next: , Previous: , Up: Lisp files   [Contents][Index]

3.1.4 com.google.base/syntax.lisp

Dependencies
Parent

com.google.base (system)

Location

syntax.lisp

Exported Definitions

Next: , Previous: , Up: Lisp files   [Contents][Index]

3.1.5 com.google.base/error.lisp

Dependencies
Parent

com.google.base (system)

Location

error.lisp

Exported Definitions

missing-argument (function)


Next: , Previous: , Up: Lisp files   [Contents][Index]

3.1.6 com.google.base/type.lisp

Dependencies
Parent

com.google.base (system)

Location

type.lisp

Exported Definitions

Next: , Previous: , Up: Lisp files   [Contents][Index]

3.1.7 com.google.base/octet.lisp

Dependencies
Parent

com.google.base (system)

Location

octet.lisp

Exported Definitions

Previous: , Up: Lisp files   [Contents][Index]

3.1.8 com.google.base/sequence.lisp

Dependencies
Parent

com.google.base (system)

Location

sequence.lisp

Exported Definitions

Next: , Previous: , Up: Top   [Contents][Index]

4 Packages

Packages are listed by definition order.


Previous: , Up: Packages   [Contents][Index]

4.1 com.google.base

Basic code used by all applications. The code in BASE should be universally useful, since most packages will import BASE symbols by including
(:USE #:COM.GOOGLE.BASE) in their DEFPACKAGE form.

Source

package.lisp (file)

Use List

common-lisp

Exported Definitions

Next: , Previous: , Up: Top   [Contents][Index]

5 Definitions

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


Previous: , Up: Definitions   [Contents][Index]

5.1 Exported definitions


Next: , Previous: , Up: Exported definitions   [Contents][Index]

5.1.1 Constants

Constant: +maximum-vector-index+

Largest valid vector index.

Package

com.google.base

Source

type.lisp (file)


Next: , Previous: , Up: Exported definitions   [Contents][Index]

5.1.2 Special variables

Special Variable: *optimize-default*

Compiler optimization settings that emphasize debugging over speed. Most code should use these settings.

Package

com.google.base

Source

optimize.lisp (file)

Special Variable: *optimize-fast-unsafe*

Compiler optimization settings that emphasize speed at the expense of debugging and run-time safety. Only low-level performance sensitive code that has been extensively tested should use these settings.

Package

com.google.base

Source

optimize.lisp (file)


Next: , Previous: , Up: Exported definitions   [Contents][Index]

5.1.3 Macros

Macro: defconst NAME VALUE &optional DOCUMENTATION

Identical to CL:DEFCONSTANT except that the global constant variable NAME is bound to VALUE at compile time so it can be used in #. reader forms. Additionally, if the DEFCONST form is evaluated a second time, the constant is not rebound if the new value is EQUALP to the old. CL:DEFCONSTANT requires that the two values be EQL to avoid undefined behavior.

Package

com.google.base

Source

syntax.lisp (file)

Macro: define-print-object CLASS-NAME ACCESSOR-INFO

Generates a CL:PRINT-OBJECT generic function for class CLASS-NAME using ACCESSOR-INFO, a list containing elements of the form
(accessor initarg [format-string]).

If a format-string is not provided for a slot, then the generated PRINT-OBJECT function outputs nothing for that slot when *PRINT-READABLY* is false.

Given a POINT class with slots X, Y, and HIDDEN. The following DEFINE-PRINT-OBJECT form:

(define-print-object point
((x :x "x is ~D")
(y :y "y is ~D")
(hidden :hidden)))

expands to a PRINT-OBJECT function similar to:

(defmethod print-object ((point point) stream)
(if *print-readably*
(progn (write-string "#." stream)
(write ‘(make-instance ’point
:x ,(x point)
:y ,(y point)
:hidden ,(hidden point))
:stream stream))
(print-unreadable-object (point stream :type t :identity t)
(format stream "x is ~D y is ~D" (x point) (y point)))))

Package

com.google.base

Source

syntax.lisp (file)


Next: , Previous: , Up: Exported definitions   [Contents][Index]

5.1.4 Functions

Function: make-octet-vector OCTET-COUNT &key INITIAL-CONTENTS

Create an OCTET-VECTOR containing OCTET-COUNT octets. If INITIAL-CONTENTS is not supplied, each element of the vector is initialized to zero. Otherwise, the vector is initialized to the contents of list INITIAL-CONTENTS.

Package

com.google.base

Source

octet.lisp (file)

Function: missing-argument ()

Signal an error indicating that an &OPTIONAL or &KEY argument is missing. Use (MISSING-ARGUMENT) as the default value of required &KEY function arguments and as the initform in DEFCLASS and DEFSTRUCT slot definition forms when the slot’s initform must always be supplied to MAKE-INSTANCE.

Package

com.google.base

Source

error.lisp (file)

Function: octet-vector &rest OCTETS
Package

com.google.base

Source

octet.lisp (file)

Function: prefixp PREFIX SEQUENCE &key TEST

Does PREFIX match a prefix of SEQUENCE?

Package

com.google.base

Source

sequence.lisp (file)

Function: string-to-utf8-octets STRING &key START END

Convert STRING into an OCTET-VECTOR by UTF-8 encoding each character.

Package

com.google.base

Source

octet.lisp (file)

Function: suffixp SUFFIX SEQUENCE &key TEST

Does SUFFIX match a suffix of SEQUENCE?

Package

com.google.base

Source

sequence.lisp (file)

Function: utf8-octets-to-string OCTETS &key START END

Convert OCTETS, a vector of UTF-8 encoded octets, into a string.

Package

com.google.base

Source

octet.lisp (file)


Previous: , Up: Exported definitions   [Contents][Index]

5.1.5 Types

Type: int16 ()

A signed 16-bit integer.

Package

com.google.base

Source

type.lisp (file)

Type: int32 ()

A signed 32-bit integer.

Package

com.google.base

Source

type.lisp (file)

Type: int64 ()

A signed 64-bit integer.

Package

com.google.base

Source

type.lisp (file)

Type: int8 ()

A signed 8-bit integer.

Package

com.google.base

Source

type.lisp (file)

Type: octet ()
Package

com.google.base

Source

octet.lisp (file)

Type: octet-vector &optional LENGTH
Package

com.google.base

Source

octet.lisp (file)

Type: uint16 ()

An unsigned 16-bit integer.

Package

com.google.base

Source

type.lisp (file)

Type: uint32 ()

An unsigned 32-bit integer.

Package

com.google.base

Source

type.lisp (file)

Type: uint64 ()

An unsigned 64-bit integer.

Package

com.google.base

Source

type.lisp (file)

Type: uint8 ()

An unsigned 8-bit integer.

Package

com.google.base

Source

type.lisp (file)

Type: vector-index ()

Integer that can be used as a subscript for accessing an array or vector element.

Package

com.google.base

Source

type.lisp (file)


Previous: , Up: Top   [Contents][Index]

Appendix A Indexes


Next: , Previous: , Up: Indexes   [Contents][Index]

A.1 Concepts

Jump to:   C   F   L  
Index Entry  Section

C
com.google.base.asd: The com<dot>google<dot>base<dot>asd file
com.google.base/error.lisp: The com<dot>google<dot>base/error<dot>lisp file
com.google.base/octet.lisp: The com<dot>google<dot>base/octet<dot>lisp file
com.google.base/optimize.lisp: The com<dot>google<dot>base/optimize<dot>lisp file
com.google.base/package.lisp: The com<dot>google<dot>base/package<dot>lisp file
com.google.base/sequence.lisp: The com<dot>google<dot>base/sequence<dot>lisp file
com.google.base/syntax.lisp: The com<dot>google<dot>base/syntax<dot>lisp file
com.google.base/type.lisp: The com<dot>google<dot>base/type<dot>lisp file

F
File, Lisp, com.google.base.asd: The com<dot>google<dot>base<dot>asd file
File, Lisp, com.google.base/error.lisp: The com<dot>google<dot>base/error<dot>lisp file
File, Lisp, com.google.base/octet.lisp: The com<dot>google<dot>base/octet<dot>lisp file
File, Lisp, com.google.base/optimize.lisp: The com<dot>google<dot>base/optimize<dot>lisp file
File, Lisp, com.google.base/package.lisp: The com<dot>google<dot>base/package<dot>lisp file
File, Lisp, com.google.base/sequence.lisp: The com<dot>google<dot>base/sequence<dot>lisp file
File, Lisp, com.google.base/syntax.lisp: The com<dot>google<dot>base/syntax<dot>lisp file
File, Lisp, com.google.base/type.lisp: The com<dot>google<dot>base/type<dot>lisp file

L
Lisp File, com.google.base.asd: The com<dot>google<dot>base<dot>asd file
Lisp File, com.google.base/error.lisp: The com<dot>google<dot>base/error<dot>lisp file
Lisp File, com.google.base/octet.lisp: The com<dot>google<dot>base/octet<dot>lisp file
Lisp File, com.google.base/optimize.lisp: The com<dot>google<dot>base/optimize<dot>lisp file
Lisp File, com.google.base/package.lisp: The com<dot>google<dot>base/package<dot>lisp file
Lisp File, com.google.base/sequence.lisp: The com<dot>google<dot>base/sequence<dot>lisp file
Lisp File, com.google.base/syntax.lisp: The com<dot>google<dot>base/syntax<dot>lisp file
Lisp File, com.google.base/type.lisp: The com<dot>google<dot>base/type<dot>lisp file

Jump to:   C   F   L  

Next: , Previous: , Up: Indexes   [Contents][Index]

A.2 Functions

Jump to:   D   F   M   O   P   S   U  
Index Entry  Section

D
defconst: Exported macros
define-print-object: Exported macros

F
Function, make-octet-vector: Exported functions
Function, missing-argument: Exported functions
Function, octet-vector: Exported functions
Function, prefixp: Exported functions
Function, string-to-utf8-octets: Exported functions
Function, suffixp: Exported functions
Function, utf8-octets-to-string: Exported functions

M
Macro, defconst: Exported macros
Macro, define-print-object: Exported macros
make-octet-vector: Exported functions
missing-argument: Exported functions

O
octet-vector: Exported functions

P
prefixp: Exported functions

S
string-to-utf8-octets: Exported functions
suffixp: Exported functions

U
utf8-octets-to-string: Exported functions

Jump to:   D   F   M   O   P   S   U  

Next: , Previous: , Up: Indexes   [Contents][Index]

A.3 Variables

Jump to:   *   +  
C   S  
Index Entry  Section

*
*optimize-default*: Exported special variables
*optimize-fast-unsafe*: Exported special variables

+
+maximum-vector-index+: Exported constants

C
Constant, +maximum-vector-index+: Exported constants

S
Special Variable, *optimize-default*: Exported special variables
Special Variable, *optimize-fast-unsafe*: Exported special variables

Jump to:   *   +  
C   S  

Previous: , Up: Indexes   [Contents][Index]

A.4 Data types

Jump to:   C   I   O   P   S   T   U   V  
Index Entry  Section

C
com.google.base: The com<dot>google<dot>base system
com.google.base: The com<dot>google<dot>base package

I
int16: Exported types
int32: Exported types
int64: Exported types
int8: Exported types

O
octet: Exported types
octet-vector: Exported types

P
Package, com.google.base: The com<dot>google<dot>base package

S
System, com.google.base: The com<dot>google<dot>base system

T
Type, int16: Exported types
Type, int32: Exported types
Type, int64: Exported types
Type, int8: Exported types
Type, octet: Exported types
Type, octet-vector: Exported types
Type, uint16: Exported types
Type, uint32: Exported types
Type, uint64: Exported types
Type, uint8: Exported types
Type, vector-index: Exported types

U
uint16: Exported types
uint32: Exported types
uint64: Exported types
uint8: Exported types

V
vector-index: Exported types

Jump to:   C   I   O   P   S   T   U   V