A computation within the environment of metadata (in a particular language) stored on a CD. The options for affecting that environment from within are limited by design, as this library is intended for reading discs rather than authoring them.

Associates a well-typed error with human-readable context information.

Potential situations which may cause a computation to fail.

Textual metadata describing a single track on a disc, or the disc itself.

An Info object with values suitable as defaults.

Genres recognized in the CD Text standard.

Written languages recognized in the CD Text standard.

Run the given computation within the CdText data associated with the Cdio session. At this top level, a withIndex 0 specifically will almost always have the same effect as running the computation directly. Fails with NoCdText if the disc doesn't provide any metadata.

Given a binary stream, attempt to parse it as a CdText block and run the given computation. Returns Left BadBinaryRead if that parse fails. At this top level, a withIndex 0 specifically will almost always have the same effect as running the computation directly.

Note that binary CdText dumps will frequently include four bytes at the beginning indicating the size of the file; this implementation expects that those bytes are not included. If your dump does indeed begin with them, drop 4 before passing the ByteString to this function.

Before libcdio 0.94: Always returns Left BadBinaryRead

Try to use a specific language as the context for the given computation; as this will frequently fail with LanguageNotFound if given anything other than English, it is recommended that you provide a fallback with <|> or at least allow recovery with optional. Note that UnknownLanguage will always fail.

Run the given computation over the data in a specific block. Fails with InvalidBlock if the index can't be accessed.

Run the given computation over all of the accessible languages in the CdText data. When successful, the resulting list can be associated exactly with the list of languages:

>>> ls <- 'languages'
>>> Right ls' <- 'cdText' $ 'withAll' 'language'
>>> ls == ls'
True

Use a C-style Cdio object as the base to run a Haskell-style CdText computation.

Note that some invariants of the monadic interface may not work as expected when used with the mutable objects, usually due to changing the active language block:

l  <- language cdio
_  <- runCdText cdio $ withIndex i g
l' <- language cdio
(l == l') == undefined

Get the language in which any info is currently being retrieved.

List every language with associated data in the CdText data associated with the session. Drops any UnknownLanguage values from the end of the list. For a version which operates within the CdText monad, the construction withAll language will have an identical effect.

Before libcdio 2.1.0: Silently drops any Nothing or Just UnknownLanguage values, even in the middle of the list, and only lists any single language a maximum of one time.

The earliest track with any associated metadata in the current language. Note that this may differ from minTrack which gives the first track on the disk, CDTEXT or not.

The final track with any associated metadata in the current language. Note that this may differ from maxTrack which gives the last track on the disc, CDTEXT or not.

Retrieve the collection of data associated with a specific track, or if Nothing, the disc itself.

Publisher-specific catalogue number, or some other context-specific identifier. Note that this may be different than code $ info Nothing which is (assumed to be) the unambiguous bar code unique to this disc release.

The genre describing the music on this disc, and any associated human-readable name or subgenre.

Get the raw binary data making up the CdText data, if any exists on the disc.