The assoc-utils Reference Manual

Table of Contents

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

The assoc-utils Reference Manual

This is the assoc-utils Reference Manual, version 0.1, generated automatically by Declt version 2.3 "Robert April" on Tue Feb 20 07:41:17 2018 GMT+0.


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

1 Introduction

Assoc-Utils

Build Status Coverage Status Quicklisp dist

Utilities for manipulating association lists.

Usage

aget

(defvar *person*
  '(("name" . "Eitaro") ("email" . "e.arrows@gmail.com")))

(aget *person* "name")
;=> "Eitaro"

(aget *person* "address")
;=> NIL

(aget *person* "address" "Tokyo, Japan")
;=> "Tokyo, Japan"

(setf (aget *person* "name") "Eitaro Fukamachi")

*person*
;=> (("name" . "Eitaro") ("email" . "e.arrows@gmail.com"))

remove-from-alist & delete-from-alist

(defvar *person*
  '(("name" . "Eitaro") ("email" . "e.arrows@gmail.com")))

(remove-from-alist *person* "name")
;=> (("email" . "e.arrows@gmail.com"))

;; Destructive version
(delete-from-alist *person* "name")
;=> (("email" . "e.arrows@gmail.com"))

alist-plist & plist-alist

(defvar *person*
  '(("name" . "Eitaro") ("email" . "e.arrows@gmail.com")))

(alist-plist *person*)
;=> (:NAME "Eitaro" :EMAIL "e.arrows@gmail.com")

(plist-alist '(:name "Eitaro" :email "e.arrows@gmail.com"))
;=> (("name" . "Eitaro") ("email" . "e.arrows@gmail.com"))

alist-hash & hash-alist

(defvar *person*
  '(("name" . "Eitaro") ("email" . "e.arrows@gmail.com")))

(alist-hash *person*)
;=> #<HASH-TABLE :TEST EQUAL :COUNT 2 {1004329443}>

(hash-alist *)
;=> (("name" . "Eitaro") ("email" . "e.arrows@gmail.com"))

alist-keys & alist-values

(defvar *person*
  '(("name" . "Eitaro") ("email" . "e.arrows@gmail.com")))

(alist-keys *person*)
;=> ("name" "email")

(alist-values *person*)
;=> ("Eitaro" "e.arrows@gmail.com")

alistp

(alistp '(("name" . "Eitaro") ("email" . "e.arrows@gmail.com")))
;=> T

(alistp 1)
;=> NIL

(alistp nil)
;=> T

;; Type: alist is also available
(typep '(("name" . "Eitaro") ("email" . "e.arrows@gmail.com")) 'alist)
;=> T

alist=

(alist= '(("name" . "Eitaro") ("email" . "e.arrows@gmail.com"))
        '(("email" . "e.arrows@gmail.com") ("name" . "Eitaro")))
;=> T

Installation

(ql:quickload :assoc-utils)

Author

License

Assoc-Utils is free and unencumbered software released into the public domain.


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 assoc-utils

Author

Eitaro Fukamachi

License

Public Domain

Description

Utilities for manipulating association lists

Long Description

# Assoc-Utils

[![Build Status](https://travis-ci.org/fukamachi/assoc-utils.svg?branch=master)](https://travis-ci.org/fukamachi/assoc-utils) [![Coverage Status](https://coveralls.io/repos/fukamachi/assoc-utils/badge.svg?branch=master)](https://coveralls.io/r/fukamachi/assoc-utils) [![Quicklisp dist](http://quickdocs.org/badge/assoc-utils.svg)](http://quickdocs.org/assoc-utils/)

Utilities for manipulating association lists.

## Usage

### aget

“‘common-lisp
(defvar *person*
’(("name" . "Eitaro") ("email" . "e.arrows@gmail.com")))

(aget *person* "name")
;=> "Eitaro"

(aget *person* "address")
;=> NIL

(aget *person* "address" "Tokyo, Japan")
;=> "Tokyo, Japan"

(setf (aget *person* "name") "Eitaro Fukamachi")

*person*
;=> (("name" . "Eitaro") ("email" . "e.arrows@gmail.com"))
“‘

### remove-from-alist & delete-from-alist

“‘common-lisp
(defvar *person*
’(("name" . "Eitaro") ("email" . "e.arrows@gmail.com")))

(remove-from-alist *person* "name")
;=> (("email" . "e.arrows@gmail.com"))

;; Destructive version
(delete-from-alist *person* "name")
;=> (("email" . "e.arrows@gmail.com"))
“‘

### alist-plist & plist-alist

“‘common-lisp
(defvar *person*
’(("name" . "Eitaro") ("email" . "e.arrows@gmail.com")))

(alist-plist *person*)
;=> (:NAME "Eitaro" :EMAIL "e.arrows@gmail.com")

(plist-alist ’(:name "Eitaro" :email "e.arrows@gmail.com"))
;=> (("name" . "Eitaro") ("email" . "e.arrows@gmail.com"))
“‘

### alist-hash & hash-alist

“‘common-lisp
(defvar *person*
’(("name" . "Eitaro") ("email" . "e.arrows@gmail.com")))

(alist-hash *person*)
;=> #<HASH-TABLE :TEST EQUAL :COUNT 2 {1004329443}>

(hash-alist *)
;=> (("name" . "Eitaro") ("email" . "e.arrows@gmail.com"))
“‘

### alist-keys & alist-values

“‘common-lisp
(defvar *person*
’(("name" . "Eitaro") ("email" . "e.arrows@gmail.com")))

(alist-keys *person*)
;=> ("name" "email")

(alist-values *person*)
;=> ("Eitaro" "e.arrows@gmail.com")
“‘

### alistp

“‘common-lisp
(alistp ’(("name" . "Eitaro") ("email" . "e.arrows@gmail.com")))
;=> T

(alistp 1)
;=> NIL

(alistp nil)
;=> T

;; Type: alist is also available
(typep ’(("name" . "Eitaro") ("email" . "e.arrows@gmail.com")) ’alist)
;=> T
“‘

### alist=

“‘common-lisp
(alist= ’(("name" . "Eitaro") ("email" . "e.arrows@gmail.com"))
’(("email" . "e.arrows@gmail.com") ("name" . "Eitaro")))
;=> T
“‘

## Installation

“‘common-lisp
(ql:quickload :assoc-utils)
“‘

## Author

* Eitaro Fukamachi (e.arrows@gmail.com)

## License

Assoc-Utils is free and unencumbered software released into the public domain.

Version

0.1

Source

assoc-utils.asd (file)

Component

src (module)


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

3 Modules

Modules are listed depth-first from the system components tree.


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

3.1 assoc-utils/src

Parent

assoc-utils (system)

Location

src/

Component

assoc-utils.lisp (file)


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

4 Files

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


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

4.1 Lisp


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

4.1.1 assoc-utils.asd

Location

assoc-utils.asd

Systems

assoc-utils (system)

Packages

assoc-utils-asd


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

4.1.2 assoc-utils/src/assoc-utils.lisp

Parent

src (module)

Location

src/assoc-utils.lisp

Packages

assoc-utils

Exported Definitions
Internal Definitions

%aput (function)


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

5 Packages

Packages are listed by definition order.


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

5.1 assoc-utils-asd

Source

assoc-utils.asd

Use List

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

5.2 assoc-utils

Source

assoc-utils.lisp (file)

Use List

common-lisp

Exported Definitions
Internal Definitions

%aput (function)


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

6 Definitions

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


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

6.1 Exported definitions


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

6.1.1 Special variables

Special Variable: *assoc-test*
Package

assoc-utils

Source

assoc-utils.lisp (file)


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

6.1.2 Macros

Macro: delete-from-alistf PLACE &rest KEYS
Package

assoc-utils

Source

assoc-utils.lisp (file)

Macro: remove-from-alistf PLACE &rest KEYS
Package

assoc-utils

Source

assoc-utils.lisp (file)


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

6.1.3 Functions

Function: aget ALIST KEY &optional DEFAULT
Setf Expander: (setf aget) ALIST KEY
Package

assoc-utils

Source

assoc-utils.lisp (file)

Function: alist-hash ALIST &key RECURSIVEP
Package

assoc-utils

Source

assoc-utils.lisp (file)

Function: alist-keys ALIST
Package

assoc-utils

Source

assoc-utils.lisp (file)

Function: alist-plist ALIST
Package

assoc-utils

Source

assoc-utils.lisp (file)

Function: alist-values ALIST
Package

assoc-utils

Source

assoc-utils.lisp (file)

Function: alist= ALIST1 ALIST2
Package

assoc-utils

Source

assoc-utils.lisp (file)

Function: alistp VALUE
Package

assoc-utils

Source

assoc-utils.lisp (file)

Function: delete-from-alist ALIST &rest KEYS
Package

assoc-utils

Source

assoc-utils.lisp (file)

Function: hash-alist HASH &key RECURSIVEP
Package

assoc-utils

Source

assoc-utils.lisp (file)

Function: plist-alist PLIST
Package

assoc-utils

Source

assoc-utils.lisp (file)

Function: remove-from-alist ALIST &rest KEYS
Package

assoc-utils

Source

assoc-utils.lisp (file)


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

6.1.4 Types

Type: alist ()
Package

assoc-utils

Source

assoc-utils.lisp (file)


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

6.2 Internal definitions


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

6.2.1 Functions

Function: %aput ALIST KEY VALUE
Package

assoc-utils

Source

assoc-utils.lisp (file)


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

Appendix A Indexes


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

A.1 Concepts

Jump to:   A   F   L   M  
Index Entry  Section

A
assoc-utils.asd: The assoc-utils<dot>asd file
assoc-utils/src: The assoc-utils/src module
assoc-utils/src/assoc-utils.lisp: The assoc-utils/src/assoc-utils<dot>lisp file

F
File, Lisp, assoc-utils.asd: The assoc-utils<dot>asd file
File, Lisp, assoc-utils/src/assoc-utils.lisp: The assoc-utils/src/assoc-utils<dot>lisp file

L
Lisp File, assoc-utils.asd: The assoc-utils<dot>asd file
Lisp File, assoc-utils/src/assoc-utils.lisp: The assoc-utils/src/assoc-utils<dot>lisp file

M
Module, assoc-utils/src: The assoc-utils/src module

Jump to:   A   F   L   M  

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

A.2 Functions

Jump to:   %   (  
A   D   F   H   M   P   R   S  
Index Entry  Section

%
%aput: Internal functions

(
(setf aget): Exported functions

A
aget: Exported functions
alist-hash: Exported functions
alist-keys: Exported functions
alist-plist: Exported functions
alist-values: Exported functions
alist=: Exported functions
alistp: Exported functions

D
delete-from-alist: Exported functions
delete-from-alistf: Exported macros

F
Function, %aput: Internal functions
Function, aget: Exported functions
Function, alist-hash: Exported functions
Function, alist-keys: Exported functions
Function, alist-plist: Exported functions
Function, alist-values: Exported functions
Function, alist=: Exported functions
Function, alistp: Exported functions
Function, delete-from-alist: Exported functions
Function, hash-alist: Exported functions
Function, plist-alist: Exported functions
Function, remove-from-alist: Exported functions

H
hash-alist: Exported functions

M
Macro, delete-from-alistf: Exported macros
Macro, remove-from-alistf: Exported macros

P
plist-alist: Exported functions

R
remove-from-alist: Exported functions
remove-from-alistf: Exported macros

S
Setf Expander, (setf aget): Exported functions

Jump to:   %   (  
A   D   F   H   M   P   R   S  

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

A.3 Variables

Jump to:   *  
S  
Index Entry  Section

*
*assoc-test*: Exported special variables

S
Special Variable, *assoc-test*: Exported special variables

Jump to:   *  
S  

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

A.4 Data types

Jump to:   A   P   S   T  
Index Entry  Section

A
alist: Exported types
assoc-utils: The assoc-utils system
assoc-utils: The assoc-utils package
assoc-utils-asd: The assoc-utils-asd package

P
Package, assoc-utils: The assoc-utils package
Package, assoc-utils-asd: The assoc-utils-asd package

S
System, assoc-utils: The assoc-utils system

T
Type, alist: Exported types

Jump to:   A   P   S   T