The percent-encoding Reference Manual

Table of Contents

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

The percent-encoding Reference Manual

This is the percent-encoding Reference Manual, version 0.1, generated automatically by Declt version 2.4 "Will Decker" on Wed Jun 20 12:23:04 2018 GMT+0.


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

1 Introduction

PERCENT-ENCODING

What is this?

Percent-encoding is a library for percent-encoding defined in RFC 3986 and varieties.

RFC 3986で定義されている パーセントエンコーディングとそ の亜種を処理するためのライブラリです。

License

It's licensed under the MIT license.

Requirements

API

Encoding And Decoding

Function: encode string &key test www-form encoding

Encodes string according to percent-encoding and returns it as a string.

stringをパーセントエンコーディングに従ってエンコードし、文字列として返します。

test is a function of one argument that returns a generalized boolean. It's used for determining whether each octet requires encoding. If it returns false, the octet is encoded. The default value is #'unreservedp.

testはひとつの引数を持ち、真偽値を返す関数です。それぞれのオクテットにエンコー ディングが必要かどうかを決めるために使われます。を返した場合、そのオクテッ トはエンコードされます。標準の値は#'unreservedpです。

If www-form is true, returns an application/x-www-form-urlencoded string instead of an RFC 3986 percent-encoded string.

www-formが真の場合、RFC 3986のパーセントエンコーディングの代わりに application/x-www-form-urlencodedを使ってエンコードした文字列を返します。

encoding is a character encoding scheme (CES). string is encoded using the CES before percent-encoding. This argument is passed to babel:string-to-octets without any change.

encodingは文字符号化方式(CES)です。stringはパーセントエンコーディングの前 にそのCESを使ってエンコードされます。この引数はbabel:string-to-octetsにそのま ま渡されます。

Function: decode string &key test www-form encoding

Decodes string according to percent-encoding and returns it as a string.

stringをパーセントエンコーディングに従ってデコードし、文字列として返します。

test is a function of one argument that returns a generalized boolean. It's used for determining whether each octet requires decoding. If it returns true, the octet is decoded. The default value is (constantly t).

testはひとつの引数を持ち、真偽値を返す関数です。それぞれのオクテットにデコー ディングが必要かどうかを決めるために使われます。真を返した場合、そのオクテットは デコードされます。標準の値は(constantly t)です。

If www-form is true, assumes that string is an application/x-www-form-urlencoded string.

www-formが真の場合、stringをapplication/x-www-form-urlencodedでエンコードさ れた文字列とみなします。

encoding is a character encoding scheme (CES). string is decoded according to the CES after percent-decoding. This argument is passed to babel:octets-to-string without any change.

encodingは文字符号化方式(CES)です。stringはパーセントエンコーディングをデ コードした後に、そのCESに従ってデコードされます。この引数は babel:octets-to-stringにそのまま渡されます。

Predicates

Function: gen-delims-p x

Function: sub-delims-p x

Function: reservedp x

Function: alphap x

Function: digitp x

Function: unreservedp x

Function: userinfop x

Function: reg-name-p x

Function: pcharp x

Function: queryp x

Function: fragmentp x

Returns true if the octet x is a member of each character set. See RFC 3986.

オクテットxがそれぞれの文字集合に属する場合に真を返します。RFC 3986を見てくだ さい。

Acknowledgements

The API of percent-encoding was inspired by Daniel Oliveira's do-urlencode and Franz's uri.

percent-encodingのAPIはDaniel Oliveiraさんの do-urlencodeとFranzの uriを参考にしています。

sile's url gave some important hints for speed to me.

sileさんのurlから速度面でのヒ ントをもらいました。


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 percent-encoding

Author

Manabu Takayama <learn.libra@gmail.com>

License

MIT License

Version

0.1

Dependencies
Source

percent-encoding.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 percent-encoding/src

Parent

percent-encoding (system)

Location

src/

Components

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 percent-encoding.asd

Location

percent-encoding.asd

Systems

percent-encoding (system)

Packages

percent.asd


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

4.1.2 percent-encoding/src/package.lisp

Parent

src (module)

Location

src/package.lisp

Packages

percent-encoding


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

4.1.3 percent-encoding/src/type.lisp

Dependency

package.lisp (file)

Parent

src (module)

Location

src/type.lisp

Internal Definitions

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

4.1.4 percent-encoding/src/var.lisp

Dependency

type.lisp (file)

Parent

src (module)

Location

src/var.lisp

Exported Definitions

*default-character-encoding* (special variable)

Internal Definitions

*optimize-qualities* (special variable)


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

4.1.5 percent-encoding/src/util.lisp

Dependency

var.lisp (file)

Parent

src (module)

Location

src/util.lisp

Internal Definitions

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

4.1.6 percent-encoding/src/condition.lisp

Dependency

util.lisp (file)

Parent

src (module)

Location

src/condition.lisp

Exported Definitions
Internal Definitions

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

4.1.7 percent-encoding/src/ascii.lisp

Dependency

condition.lisp (file)

Parent

src (module)

Location

src/ascii.lisp

Internal Definitions

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

4.1.8 percent-encoding/src/pred.lisp

Dependency

ascii.lisp (file)

Parent

src (module)

Location

src/pred.lisp

Exported Definitions

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

4.1.9 percent-encoding/src/encode.lisp

Dependency

pred.lisp (file)

Parent

src (module)

Location

src/encode.lisp

Exported Definitions

encode (function)


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

4.1.10 percent-encoding/src/decode.lisp

Dependency

encode.lisp (file)

Parent

src (module)

Location

src/decode.lisp

Exported Definitions

decode (function)


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

5 Packages

Packages are listed by definition order.


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

5.1 percent.asd

Source

percent-encoding.asd

Use List

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

5.2 percent-encoding

Source

package.lisp (file)

Nickname

percent

Use List
Exported Definitions
Internal Definitions

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: *default-character-encoding*
Package

percent-encoding

Source

var.lisp (file)


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

6.1.2 Functions

Function: alphap X
Package

percent-encoding

Source

pred.lisp (file)

Function: decode ()
Package

percent-encoding

Source

decode.lisp (file)

Function: digitp X
Package

percent-encoding

Source

pred.lisp (file)

Function: encode ()
Package

percent-encoding

Source

encode.lisp (file)

Function: fragmentp X
Package

percent-encoding

Source

pred.lisp (file)

Function: gen-delims-p X
Package

percent-encoding

Source

pred.lisp (file)

Function: pcharp X
Package

percent-encoding

Source

pred.lisp (file)

Function: queryp X
Package

percent-encoding

Source

pred.lisp (file)

Function: reg-name-p X
Package

percent-encoding

Source

pred.lisp (file)

Function: reservedp X
Package

percent-encoding

Source

pred.lisp (file)

Function: sub-delims-p X
Package

percent-encoding

Source

pred.lisp (file)

Function: unreservedp X
Package

percent-encoding

Source

pred.lisp (file)

Function: userinfop X
Package

percent-encoding

Source

pred.lisp (file)


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

6.1.3 Conditions

Condition: decode-error ()
Package

percent-encoding

Source

condition.lisp (file)

Direct superclasses

error (condition)

Direct subclasses
Direct methods

decode-error-position (method)

Direct slots
Slot: position
Initargs

:position

Readers

decode-error-position (generic function)

Condition: invalid-% ()
Package

percent-encoding

Source

condition.lisp (file)

Direct superclasses

decode-error (condition)

Condition: invalid-hexdig ()
Package

percent-encoding

Source

condition.lisp (file)

Direct superclasses

decode-error (condition)

Direct methods
Direct slots
Slot: c1
Initargs

:c1

Readers

invalid-hexdig-c1 (generic function)

Slot: c2
Initargs

:c2

Readers

invalid-hexdig-c2 (generic function)


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

6.2 Internal definitions


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

6.2.1 Special variables

Special Variable: *ascii-char-table*
Package

percent-encoding

Source

ascii.lisp (file)

Special Variable: *char-ascii-table*
Package

percent-encoding

Source

ascii.lisp (file)

Special Variable: *optimize-qualities*
Package

percent-encoding

Source

var.lisp (file)


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

6.2.2 Functions

Function: ascii-char X
Package

percent-encoding

Source

ascii.lisp (file)

Function: char-ascii X
Package

percent-encoding

Source

ascii.lisp (file)

Function: char-pair-octet C1 C2
Package

percent-encoding

Source

util.lisp (file)

Function: shrink-vector VECTOR SIZE
Package

percent-encoding

Source

util.lisp (file)


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

6.2.3 Generic functions

Generic Function: decode-error-position CONDITION
Package

percent-encoding

Methods
Method: decode-error-position (CONDITION decode-error)
Source

condition.lisp (file)

Generic Function: invalid-hexdig-c1 CONDITION
Package

percent-encoding

Methods
Method: invalid-hexdig-c1 (CONDITION invalid-hexdig)
Source

condition.lisp (file)

Generic Function: invalid-hexdig-c2 CONDITION
Package

percent-encoding

Methods
Method: invalid-hexdig-c2 (CONDITION invalid-hexdig)
Source

condition.lisp (file)


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

6.2.4 Types

Type: octet ()
Package

percent-encoding

Source

type.lisp (file)

Type: octets &optional SIZE
Package

percent-encoding

Source

type.lisp (file)


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

Appendix A Indexes


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

A.1 Concepts

Jump to:   F   L   M   P  
Index Entry  Section

F
File, Lisp, percent-encoding.asd: The percent-encoding<dot>asd file
File, Lisp, percent-encoding/src/ascii.lisp: The percent-encoding/src/ascii<dot>lisp file
File, Lisp, percent-encoding/src/condition.lisp: The percent-encoding/src/condition<dot>lisp file
File, Lisp, percent-encoding/src/decode.lisp: The percent-encoding/src/decode<dot>lisp file
File, Lisp, percent-encoding/src/encode.lisp: The percent-encoding/src/encode<dot>lisp file
File, Lisp, percent-encoding/src/package.lisp: The percent-encoding/src/package<dot>lisp file
File, Lisp, percent-encoding/src/pred.lisp: The percent-encoding/src/pred<dot>lisp file
File, Lisp, percent-encoding/src/type.lisp: The percent-encoding/src/type<dot>lisp file
File, Lisp, percent-encoding/src/util.lisp: The percent-encoding/src/util<dot>lisp file
File, Lisp, percent-encoding/src/var.lisp: The percent-encoding/src/var<dot>lisp file

L
Lisp File, percent-encoding.asd: The percent-encoding<dot>asd file
Lisp File, percent-encoding/src/ascii.lisp: The percent-encoding/src/ascii<dot>lisp file
Lisp File, percent-encoding/src/condition.lisp: The percent-encoding/src/condition<dot>lisp file
Lisp File, percent-encoding/src/decode.lisp: The percent-encoding/src/decode<dot>lisp file
Lisp File, percent-encoding/src/encode.lisp: The percent-encoding/src/encode<dot>lisp file
Lisp File, percent-encoding/src/package.lisp: The percent-encoding/src/package<dot>lisp file
Lisp File, percent-encoding/src/pred.lisp: The percent-encoding/src/pred<dot>lisp file
Lisp File, percent-encoding/src/type.lisp: The percent-encoding/src/type<dot>lisp file
Lisp File, percent-encoding/src/util.lisp: The percent-encoding/src/util<dot>lisp file
Lisp File, percent-encoding/src/var.lisp: The percent-encoding/src/var<dot>lisp file

M
Module, percent-encoding/src: The percent-encoding/src module

P
percent-encoding.asd: The percent-encoding<dot>asd file
percent-encoding/src: The percent-encoding/src module
percent-encoding/src/ascii.lisp: The percent-encoding/src/ascii<dot>lisp file
percent-encoding/src/condition.lisp: The percent-encoding/src/condition<dot>lisp file
percent-encoding/src/decode.lisp: The percent-encoding/src/decode<dot>lisp file
percent-encoding/src/encode.lisp: The percent-encoding/src/encode<dot>lisp file
percent-encoding/src/package.lisp: The percent-encoding/src/package<dot>lisp file
percent-encoding/src/pred.lisp: The percent-encoding/src/pred<dot>lisp file
percent-encoding/src/type.lisp: The percent-encoding/src/type<dot>lisp file
percent-encoding/src/util.lisp: The percent-encoding/src/util<dot>lisp file
percent-encoding/src/var.lisp: The percent-encoding/src/var<dot>lisp file

Jump to:   F   L   M   P  

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

A.2 Functions

Jump to:   A   C   D   E   F   G   I   M   P   Q   R   S   U  
Index Entry  Section

A
alphap: Exported functions
ascii-char: Internal functions

C
char-ascii: Internal functions
char-pair-octet: Internal functions

D
decode: Exported functions
decode-error-position: Internal generic functions
decode-error-position: Internal generic functions
digitp: Exported functions

E
encode: Exported functions

F
fragmentp: Exported functions
Function, alphap: Exported functions
Function, ascii-char: Internal functions
Function, char-ascii: Internal functions
Function, char-pair-octet: Internal functions
Function, decode: Exported functions
Function, digitp: Exported functions
Function, encode: Exported functions
Function, fragmentp: Exported functions
Function, gen-delims-p: Exported functions
Function, pcharp: Exported functions
Function, queryp: Exported functions
Function, reg-name-p: Exported functions
Function, reservedp: Exported functions
Function, shrink-vector: Internal functions
Function, sub-delims-p: Exported functions
Function, unreservedp: Exported functions
Function, userinfop: Exported functions

G
gen-delims-p: Exported functions
Generic Function, decode-error-position: Internal generic functions
Generic Function, invalid-hexdig-c1: Internal generic functions
Generic Function, invalid-hexdig-c2: Internal generic functions

I
invalid-hexdig-c1: Internal generic functions
invalid-hexdig-c1: Internal generic functions
invalid-hexdig-c2: Internal generic functions
invalid-hexdig-c2: Internal generic functions

M
Method, decode-error-position: Internal generic functions
Method, invalid-hexdig-c1: Internal generic functions
Method, invalid-hexdig-c2: Internal generic functions

P
pcharp: Exported functions

Q
queryp: Exported functions

R
reg-name-p: Exported functions
reservedp: Exported functions

S
shrink-vector: Internal functions
sub-delims-p: Exported functions

U
unreservedp: Exported functions
userinfop: Exported functions

Jump to:   A   C   D   E   F   G   I   M   P   Q   R   S   U  

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

A.3 Variables

Jump to:   *  
C   P   S  
Index Entry  Section

*
*ascii-char-table*: Internal special variables
*char-ascii-table*: Internal special variables
*default-character-encoding*: Exported special variables
*optimize-qualities*: Internal special variables

C
c1: Exported conditions
c2: Exported conditions

P
position: Exported conditions

S
Slot, c1: Exported conditions
Slot, c2: Exported conditions
Slot, position: Exported conditions
Special Variable, *ascii-char-table*: Internal special variables
Special Variable, *char-ascii-table*: Internal special variables
Special Variable, *default-character-encoding*: Exported special variables
Special Variable, *optimize-qualities*: Internal special variables

Jump to:   *  
C   P   S  

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

A.4 Data types

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

C
Condition, decode-error: Exported conditions
Condition, invalid-%: Exported conditions
Condition, invalid-hexdig: Exported conditions

D
decode-error: Exported conditions

I
invalid-%: Exported conditions
invalid-hexdig: Exported conditions

O
octet: Internal types
octets: Internal types

P
Package, percent-encoding: The percent-encoding package
Package, percent.asd: The percent<dot>asd package
percent-encoding: The percent-encoding system
percent-encoding: The percent-encoding package
percent.asd: The percent<dot>asd package

S
System, percent-encoding: The percent-encoding system

T
Type, octet: Internal types
Type, octets: Internal types

Jump to:   C   D   I   O   P   S   T