Next: Introduction, Previous: (dir), Up: (dir) [Contents][Index]
This is the media-types Reference Manual, generated automatically by Declt version 4.0 beta 2 "William Riker" on Thu Sep 15 05:37:35 2022 GMT+0.
Next: Systems, Previous: The media-types Reference Manual, Up: The media-types Reference Manual [Contents][Index]
MEDIA-TYPES is a library for querying and comparing media types.
Probably the most useful function is extension-media-type:
(extension-media-type "txt") => "text/plain"
An unknown extension, or no extension, has a media type of
application/octet-stream:
(extension-media-type "my-fake-extension") => "application/octet-stream"
(extension-media-type nil) => "application/octet-stream"
(This is nonstandard, but reflects general practice.)
You can also use media-type-extension to query the extension (or
extensions) for a media type:
(media-type-extension "application/javascript") => "js"
If a media type has multiple extensions, they are returned as multiple values:
(media-type-extension "image/jpeg") => "jpeg", "jpg", "jpe"
Extensions are not case sensitive:
(extension-media-type "TXT") => "text/plain"
You may pass the extension with or without a leading dot:
(extension-media-type ".txt") => "text/plain"
You can get the extension of a file name with file-name-extension:
(file-name-extension "file.txt") => "txt"
Or just get the media type of the file directly:
(file-name-media-type "file.txt") => "text/plain"
(file-name-media-type #p"file.txt") => "text/plain"
A file name without an extension has a media type of application/octet-stream:
(file-name-media-type "file") => "application/octet-stream"
However, if you want to test whether a file is of a specific media
type, you should use file-name-media-typep.
(file-name-media-typep "file.xml" "application/xml") => t
(file-name-media-typep "file.svg" "application/xml") => t
file-name-media-typep uses media-subtypep, which has a
sophisticated understanding of media types:
(media-subtypep "text/plain" "*/*") => t
(media-subtypep "text/plain" "text/*") => t
;; All media types are effectively subtypes of application/octet-stream.
(media-subtypep "text/plain" "application/octet-stream") => t
;; Structured syntax suffixes.
(media-subtypep "image/svg+xml" "application/xml") => t
(media-subtypep "application/vnd.my-format+json" "application/json") => t
;; Media type parameters.
(media-subtypep "application/atom+xml;type=entry" "application/xml") => t
(media-subtypep "application/atom+xml" "application/atom+xml;type=entry") => nil
(media-subtypep "application/atom+xml;charset=UTF8;type=entry"
"application/atom+xml;type=entry")
=> t
;; The "q" pseudo-parameter is used in HTTP content negotiation.
(media-subtypep "application/json" "*/*;q=0.1") => t
MEDIA-TYPES uses the mime.types from the Apache sources.
Next: Files, Previous: Introduction, Up: The media-types Reference Manual [Contents][Index]
The main system appears first, followed by any subsystem dependency.
Query and compare media types.
Paul M. Rodriguez <pmr@ruricolist.com>
MIT
Next: Packages, Previous: Systems, Up: The media-types Reference Manual [Contents][Index]
Files are sorted by type and then listed depth-first from the systems components trees.
Next: media-types/package.lisp, Previous: Lisp, Up: Lisp [Contents][Index]
media-types (system).
Next: media-types/media-types.lisp, Previous: media-types/media-types.asd, Up: Lisp [Contents][Index]
media-types (system).
Next: media-types/file-extensions.lisp, Previous: media-types/package.lisp, Up: Lisp [Contents][Index]
package.lisp (file).
media-types (system).
Previous: media-types/media-types.lisp, Up: Lisp [Contents][Index]
mime.types (file).
media-types (system).
media-types.lisp (file).
media-types (system).
Next: Definitions, Previous: Files, Up: The media-types Reference Manual [Contents][Index]
Packages are listed by definition order.
Next: Indexes, Previous: Packages, Up: The media-types Reference Manual [Contents][Index]
Definitions are sorted by export status, category, package, and then by lexicographic order.
Next: Internals, Previous: Definitions, Up: Definitions [Contents][Index]
Next: Ordinary functions, Previous: Public Interface, Up: Public Interface [Contents][Index]
Next: Standalone methods, Previous: Compiler macros, Up: Public Interface [Contents][Index]
Next: Conditions, Previous: Ordinary functions, Up: Public Interface [Contents][Index]
Next: Structures, Previous: Standalone methods, Up: Public Interface [Contents][Index]
error.
common-lisp.
:type
Previous: Conditions, Up: Public Interface [Contents][Index]
%read-only-struct.
common-lisp.
string
(alexandria:required-argument (quote type))
This slot is read-only.
string
(alexandria:required-argument (quote media-types::subtype))
This slot is read-only.
list
This slot is read-only.
Previous: Public Interface, Up: Definitions [Contents][Index]
Next: Special variables, Previous: Internals, Up: Internals [Contents][Index]
Next: Symbol macros, Previous: Constants, Up: Internals [Contents][Index]
Next: Ordinary functions, Previous: Special variables, Up: Internals [Contents][Index]
Next: Standalone methods, Previous: Symbol macros, Up: Internals [Contents][Index]
Next: Types, Previous: Ordinary functions, Up: Internals [Contents][Index]
serapeum.
Previous: Standalone methods, Up: Internals [Contents][Index]
Previous: Definitions, Up: The media-types Reference Manual [Contents][Index]
| Jump to: | C D E F M P R S |
|---|
| Jump to: | C D E F M P R S |
|---|
Next: Data types, Previous: Functions, Up: Indexes [Contents][Index]
| Jump to: | *
+
A C M P S T |
|---|
| Jump to: | *
+
A C M P S T |
|---|
| Jump to: | B C D E F I M N P S T |
|---|
| Jump to: | B C D E F I M N P S T |
|---|