The float-features Reference Manual

Table of Contents

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

The float-features Reference Manual

This is the float-features Reference Manual, version 1.0.0, generated automatically by Declt version 2.4 patchlevel 1 "Will Decker" on Mon Apr 08 14:02:18 2019 GMT+0.


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

1 Introduction

About Float-Features

This is a wrapper library for IEEE floating point features not present in the Common Lisp standard.

Implementation Support

The following implementations are currently partially or entirely supported:


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 float-features

Maintainer

Nicolas Hafner <shinmera@tymoon.eu>

Author

Nicolas Hafner <shinmera@tymoon.eu>

Home Page

https://github.com/Shinmera/float-features

License

Artistic

Description

A portability library for IEEE float features not covered by the CL standard.

Version

1.0.0

Dependency

documentation-utils

Source

float-features.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 float-features.asd

Location

float-features.asd

Systems

float-features (system)


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

3.1.2 float-features/float-features.lisp

Parent

float-features (system)

Location

float-features.lisp

Packages

float-features

Exported Definitions
Internal Definitions

keep (function)


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

3.1.3 float-features/documentation.lisp

Dependency

float-features.lisp (file)

Parent

float-features (system)

Location

documentation.lisp


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

4 Packages

Packages are listed by definition order.


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

4.1 float-features

Source

float-features.lisp (file)

Nickname

org.shirakumo.float-features

Use List

common-lisp

Exported Definitions
Internal Definitions

keep (function)


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

5 Definitions

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


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

5.1 Exported definitions


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

5.1.1 Constants

Constant: double-float-negative-infinity

The negative infinity for double-floats.

Supported on:
* ABCL
* ALLEGRO
* CCL
* CMUCL
* ECL
* MKCL
* SBCL

Defaults to MOST-NEGATIVE-DOUBLE-FLOAT on unsupported implementations.

Package

float-features

Source

float-features.lisp (file)

Constant: double-float-positive-infinity

The positive infinity for double-floats.

Supported on:
* ABCL
* ALLEGRO
* CCL
* CMUCL
* ECL
* MKCL
* SBCL

Defaults to MOST-POSITIVE-DOUBLE-FLOAT on unsupported implementations.

Package

float-features

Source

float-features.lisp (file)

Constant: long-float-negative-infinity

The negative infinity for long-floats.

Supported on:
* CMUCL
* ECL
* MKCL
* SBCL

Defaults to MOST-NEGATIVE-LONG-FLOAT on unsupported implementations.

Package

float-features

Source

float-features.lisp (file)

Constant: long-float-positive-infinity

The positive infinity for long-floats.

Supported on:
* CMUCL
* ECL
* MKCL
* SBCL

Defaults to MOST-POSITIVE-LONG-FLOAT on unsupported implementations.

Package

float-features

Source

float-features.lisp (file)

Constant: short-float-negative-infinity

The negative infinity for short-floats.

Supported on:
* CMUCL
* ECL
* MKCL
* SBCL

Defaults to MOST-NEGATIVE-SHORT-FLOAT on unsupported implementations.

Package

float-features

Source

float-features.lisp (file)

Constant: short-float-positive-infinity

The positive infinity for short-floats.

Supported on:
* CMUCL
* ECL
* MKCL
* SBCL

Defaults to MOST-POSITIVE-SHORT-FLOAT on unsupported implementations.

Package

float-features

Source

float-features.lisp (file)

Constant: single-float-negative-infinity

The negative infinity for single-floats.

Supported on:
* ABCL
* ALLEGRO
* CMUCL
* ECL
* MKCL
* SBCL

Defaults to MOST-NEGATIVE-SINGLE-FLOAT on unsupported implementations.

Package

float-features

Source

float-features.lisp (file)

Constant: single-float-positive-infinity

The positive infinity for single-floats.

Supported on:
* ABCL
* ALLEGRO
* CMUCL
* ECL
* MKCL
* SBCL

Defaults to MOST-POSITIVE-SINGLE-FLOAT on unsupported implementations.

Package

float-features

Source

float-features.lisp (file)


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

5.1.2 Macros

Macro: with-float-traps-masked TRAPS &body BODY

Attempts to mask the given floating point traps.

Masking a floating point trap causes the given floating point exception to not signal a condition in the lisp world, and instead lets the operation return a float that is either a NaN or an infinity.

The following traps are recognised:

:underflow
:overflow
:inexact
:invalid
:divide-by-zero
:denormalized-operand

The traps argument may be either a list of the above trap identifiers, or T to signify all maskable traps.

Note that not all implementations will signal conditions on all of the above floating point traps anyway, and some implementations may only support masking some of the above traps.

Supported on:
* ABCL (:overflow :underflow)
* CCL (:overflow :underflow :inexact :invalid :divide-by-zero)
* CLISP (:underflow)
* CMUCL T
* ECL (:underflow :overflow :inexact :invalid :divide-by-zero)
* SBCL T

Defaults to a progn on unsupported implementations and ignores unsupported traps.

Package

float-features

Source

float-features.lisp (file)


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

5.1.3 Functions

Function: float-infinity-p FLOAT

Returns T if the given float is an infinity, NIL otherwise.

Supported on:
* ABCL
* ALLEGRO
* CCL
* CMUCL
* ECL
* SBCL

Defaults to comparing against the individual constants on unsupported implementations.

Package

float-features

Source

float-features.lisp (file)

Function: float-nan-p FLOAT

Returns T if the given float is in not-a-number state, NIL otherwise.

Supported on:
* ABCL
* ALLEGRO
* CCL
* CMUCL
* ECL
* SBCL

Defaults to returning NIL on unsupported implementations.

Package

float-features

Source

float-features.lisp (file)


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

5.2 Internal definitions


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

5.2.1 Functions

Function: keep LIST &rest KEEPS
Package

float-features

Source

float-features.lisp (file)


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

Appendix A Indexes


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

A.1 Concepts

Jump to:   F   L  
Index Entry  Section

F
File, Lisp, float-features.asd: The float-features<dot>asd file
File, Lisp, float-features/documentation.lisp: The float-features/documentation<dot>lisp file
File, Lisp, float-features/float-features.lisp: The float-features/float-features<dot>lisp file
float-features.asd: The float-features<dot>asd file
float-features/documentation.lisp: The float-features/documentation<dot>lisp file
float-features/float-features.lisp: The float-features/float-features<dot>lisp file

L
Lisp File, float-features.asd: The float-features<dot>asd file
Lisp File, float-features/documentation.lisp: The float-features/documentation<dot>lisp file
Lisp File, float-features/float-features.lisp: The float-features/float-features<dot>lisp file

Jump to:   F   L  

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

A.2 Functions

Jump to:   F   K   M   W  
Index Entry  Section

F
float-infinity-p: Exported functions
float-nan-p: Exported functions
Function, float-infinity-p: Exported functions
Function, float-nan-p: Exported functions
Function, keep: Internal functions

K
keep: Internal functions

M
Macro, with-float-traps-masked: Exported macros

W
with-float-traps-masked: Exported macros

Jump to:   F   K   M   W  

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

A.3 Variables

Jump to:   C   D   L   S  
Index Entry  Section

C
Constant, double-float-negative-infinity: Exported constants
Constant, double-float-positive-infinity: Exported constants
Constant, long-float-negative-infinity: Exported constants
Constant, long-float-positive-infinity: Exported constants
Constant, short-float-negative-infinity: Exported constants
Constant, short-float-positive-infinity: Exported constants
Constant, single-float-negative-infinity: Exported constants
Constant, single-float-positive-infinity: Exported constants

D
double-float-negative-infinity: Exported constants
double-float-positive-infinity: Exported constants

L
long-float-negative-infinity: Exported constants
long-float-positive-infinity: Exported constants

S
short-float-negative-infinity: Exported constants
short-float-positive-infinity: Exported constants
single-float-negative-infinity: Exported constants
single-float-positive-infinity: Exported constants

Jump to:   C   D   L   S  

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

A.4 Data types

Jump to:   F   P   S  
Index Entry  Section

F
float-features: The float-features system
float-features: The float-features package

P
Package, float-features: The float-features package

S
System, float-features: The float-features system

Jump to:   F   P   S