The trivial-utf-8 Reference Manual

3.1.1 trivial-utf-8/trivial-utf-8.asd

Source

trivial-utf-8.asd.

Parent Component

trivial-utf-8 (system).

ASDF Systems

trivial-utf-8.

3.1.2 trivial-utf-8/trivial-utf-8.lisp

Source

trivial-utf-8.asd.

Parent Component

trivial-utf-8 (system).

Packages

trivial-utf-8.

Public Interface

• read-utf-8-string (function).
• string-to-utf-8-bytes (function).
• utf-8-byte-length (function).
• utf-8-bytes-to-string (function).
• utf-8-decoding-error (condition).
• utf-8-group-size (function).
• write-utf-8-bytes (function).

Internals

• *optimize* (special variable).
• as-utf-8-bytes (macro).
• get-utf-8-character (function).
• utf-8-string-length (function).

5.1.1 Ordinary functions

Function: read-utf-8-string (input &key null-terminated stop-at-eof char-length byte-length) ¶

Read UTF-8 encoded data from INPUT, a byte stream, and construct a string with the characters found. When NULL-TERMINATED is given, stop reading at a null character. If STOP-AT-EOF, then stop at END-OF-FILE without raising an error. The CHAR-LENGTH and BYTE-LENGTH parameters can be used to specify the max amount of characters or bytes to read, where -1 means no limit. May signal UTF-8-DECODING-ERROR.

Package

trivial-utf-8.

Source

trivial-utf-8.lisp.

Function: string-to-utf-8-bytes (string &key null-terminate) ¶

Convert STRING into an array of unsigned bytes containing its UTF-8 representation. If NULL-TERMINATE, add an extra 0 byte at the end.

Package

trivial-utf-8.

Source

trivial-utf-8.lisp.

Function: utf-8-byte-length (string) ¶

Calculate the amount of bytes needed to encode STRING.

Package

trivial-utf-8.

Source

trivial-utf-8.lisp.

Function: utf-8-bytes-to-string (bytes &key start end) ¶

Convert the START, END subsequence of the array of BYTES containing UTF-8 encoded characters to a [STRING][type]. The element type of BYTES may be anything as long as it can be ‘COERCE‘d into
an ‘(UNSIGNED-BYTES 8)‘ array. May signal UTF-8-DECODING-ERROR.

Package

trivial-utf-8.

Source

trivial-utf-8.lisp.

Function: utf-8-group-size (byte) ¶

Determine the amount of bytes that are part of the character whose encoding starts with BYTE. May signal UTF-8-DECODING-ERROR.

Package

trivial-utf-8.

Source

trivial-utf-8.lisp.

Function: write-utf-8-bytes (string byte-stream &key null-terminate) ¶

Write STRING to BYTE-STREAM, encoding it as UTF-8. If NULL-TERMINATE, write an extra 0 byte at the end.

Package

trivial-utf-8.

Source

trivial-utf-8.lisp.

5.1.2 Conditions

Condition: utf-8-decoding-error ¶

Package

trivial-utf-8.

Source

trivial-utf-8.lisp.

Direct superclasses

simple-error.

Direct slots

Slot: message ¶

Initargs

:message

Slot: byte ¶

Package

common-lisp.

Initform

(quote nil)

Initargs

:byte

5.2.1 Special variables

Special Variable: *optimize* ¶

Package

trivial-utf-8.

Source

trivial-utf-8.lisp.

5.2.2 Macros

Macro: as-utf-8-bytes (char writer) ¶

Given the character CHAR, call the WRITER for every byte in the UTF-8 encoded form of that character. WRITER may a function or a macro.

Package

trivial-utf-8.

Source

trivial-utf-8.lisp.

5.2.3 Ordinary functions

Function: get-utf-8-character (bytes group-size &optional start) ¶

Extract the character from an array of BYTES encoded in GROUP-SIZE number of bytes from the START position. May signal UTF-8-DECODING-ERROR.

Package

trivial-utf-8.

Source

trivial-utf-8.lisp.

Function: utf-8-string-length (bytes &key start end) ¶

Calculate the length of the string encoded by the subsequence of the array of BYTES bounded by START and END.

Package

trivial-utf-8.

Source

trivial-utf-8.lisp.