6.12.18.2 UTF-8 string encoding condition types

Encoding strings into UTF-8 bytevectors

Condition Type: &utf8-string-encoding

Condition object type representing an error while encoding a string into a UTF-8 bytevector; it is derived from &string-encoding.

Function: make-utf8-string-encoding-error

Build and return a new condition object of type &utf8-string-encoding.

Function: utf8-string-encoding-error? obj

Return #t if obj is a condition object of type &utf8-string-encoding; otherwise return #f.

Decoding strings from UTF-8 bytevectors

Condition Type: &utf8-string-decoding

Condition object type representing an error while decoding a UTF-8 bytevector into a string; it is derived from &string-decoding.

Function: make-utf8-string-decoding-error

Build and return a new condition object of type &utf8-string-decoding.

Function: utf8-string-decoding-error? obj

Return #t if obj is a condition object of type &utf8-string-decoding; otherwise return #f.

Invalid octet in UTF-8 bytevector

Condition Type: &utf8-string-decoding-invalid-octet

Condition object type representing an invalid octet in a UTF-8 bytevector; it is derived from &utf8-string-decoding. It has the following fields:

bytevector

The UTF-8 bytevector.

index

The index in the bytevector of the offending octet.

octets

A list holding the offending octet.

Function: make-utf8-string-decoding-invalid-octet bytevector index octets

Build and return a condition object of type &utf8-string-decoding-invalid-octet.

Function: utf8-string-decoding-invalid-octet? obj

Return #t if obj is a condition object of type &utf8-string-decoding-invalid-octet; otherwise return #f.

Function: utf8-string-decoding-invalid-octet.bytevector cnd

Function: utf8-string-decoding-invalid-octet.index cnd

Function: utf8-string-decoding-invalid-octet.octets cnd

Field accessors for condition objects of type &utf8-string-decoding-invalid-octet.

Invalid 2-octets sequence in UTF-8 bytevector

Condition Type: &utf8-string-decoding-invalid-2-tuple

Condition object type representing an invalid 2-octets sequence in a UTF-8 bytevector: the first octet is valid, the second one is invalid. It is derived from &utf8-string-decoding. It has the following fields:

bytevector

The UTF-8 bytevector.

index

The index in the bytevector of the offending octet.

octets

A list holding the offending octets.

Function: make-utf8-string-decoding-invalid-2-tuple bytevector index octets

Build and return a condition object of type &utf8-string-decoding-invalid-2-tuple.

Function: utf8-string-decoding-invalid-2-tuple? obj

Return #t if obj is a condition object of type &utf8-string-decoding-invalid-2-tuple; otherwise return #f.

Function: utf8-string-decoding-invalid-2-tuple.bytevector cnd

Function: utf8-string-decoding-invalid-2-tuple.index cnd

Function: utf8-string-decoding-invalid-2-tuple.octets cnd

Field accessors for condition objects of type &utf8-string-decoding-invalid-2-tuple.

Invalid 3-octets sequence in UTF-8 bytevector

Condition Type: &utf8-string-decoding-invalid-3-tuple

Condition object type representing an invalid 3-octets sequence in a UTF-8 bytevector: the first octet is valid, the second and/or third ones are invalid. It is derived from &utf8-string-decoding. It has the following fields:

bytevector

The UTF-8 bytevector.

index

The index in the bytevector of the offending octet.

octets

A list holding the offending octets.

Function: make-utf8-string-decoding-invalid-3-tuple bytevector index octets

Build and return a condition object of type &utf8-string-decoding-invalid-3-tuple.

Function: utf8-string-decoding-invalid-3-tuple? obj

Return #t if obj is a condition object of type &utf8-string-decoding-invalid-3-tuple; otherwise return #f.

Function: utf8-string-decoding-invalid-3-tuple.bytevector cnd

Function: utf8-string-decoding-invalid-3-tuple.index cnd

Function: utf8-string-decoding-invalid-3-tuple.octets cnd

Field accessors for condition objects of type &utf8-string-decoding-invalid-3-tuple.

Invalid 4-octets sequence in UTF-8 bytevector

Condition Type: &utf8-string-decoding-invalid-4-tuple

Condition object type representing an invalid 4-octets sequence in a UTF-8 bytevector: the first octet is valid, one or more among the second, third and fourth ones are invalid. It is derived from &utf8-string-decoding. It has the following fields:

bytevector

The UTF-8 bytevector.

index

The index in the bytevector of the offending octet.

octets

A list holding the offending octets.

Function: make-utf8-string-decoding-invalid-4-tuple bytevector index octets

Build and return a condition object of type &utf8-string-decoding-invalid-4-tuple.

Function: utf8-string-decoding-invalid-4-tuple? obj

Return #t if obj is a condition object of type &utf8-string-decoding-invalid-4-tuple; otherwise return #f.

Function: utf8-string-decoding-invalid-4-tuple.bytevector cnd

Function: utf8-string-decoding-invalid-4-tuple.index cnd

Function: utf8-string-decoding-invalid-4-tuple.octets cnd

Field accessors for condition objects of type &utf8-string-decoding-invalid-4-tuple.

Incomplete 2-octets sequence in UTF-8 bytevector

Condition Type: &utf8-string-decoding-incomplete-2-tuple

Condition object type representing an incomplete 2-octets sequence in a UTF-8 bytevector: the first octet is present, the second one is missing because we are at the end of the bytevector. It is derived from &utf8-string-decoding. It has the following fields:

bytevector

The UTF-8 bytevector.

index

The index in the bytevector of the first octet in the incomplete sequence.

octets

A list holding the incomplete sequence of octets.

Function: make-utf8-string-decoding-incomplete-2-tuple bytevector index octets

Build and return a condition object of type &utf8-string-decoding-incomplete-2-tuple.

Function: utf8-string-decoding-incomplete-2-tuple? obj

Return #t if obj is a condition object of type &utf8-string-decoding-incomplete-2-tuple; otherwise return #f.

Function: utf8-string-decoding-incomplete-2-tuple.bytevector cnd

Function: utf8-string-decoding-incomplete-2-tuple.index cnd

Function: utf8-string-decoding-incomplete-2-tuple.octets cnd

Field accessors for condition objects of type &utf8-string-decoding-incomplete-2-tuple.

Incomplete 3-octets sequence in UTF-8 bytevector

Condition Type: &utf8-string-decoding-incomplete-3-tuple

Condition object type representing an incomplete 3-octets sequence in a UTF-8 bytevector: the first octet is present, the second and/or third ones are missing because we are at the end of the bytevector. It is derived from &utf8-string-decoding. It has the following fields:

bytevector

The UTF-8 bytevector.

index

The index in the bytevector of the first octet in the incomplete sequence.

octets

A list holding the incomplete sequence of octets.

Function: make-utf8-string-decoding-incomplete-3-tuple bytevector index octets

Build and return a condition object of type &utf8-string-decoding-incomplete-3-tuple.

Function: utf8-string-decoding-incomplete-3-tuple? obj

Return #t if obj is a condition object of type &utf8-string-decoding-incomplete-3-tuple; otherwise return #f.

Function: utf8-string-decoding-incomplete-3-tuple.bytevector cnd

Function: utf8-string-decoding-incomplete-3-tuple.index cnd

Function: utf8-string-decoding-incomplete-3-tuple.octets cnd

Field accessors for condition objects of type &utf8-string-decoding-incomplete-3-tuple.

Incomplete 4-octets sequence in UTF-8 bytevector

Condition Type: &utf8-string-decoding-incomplete-4-tuple

Condition object type representing an incomplete 4-octets sequence in a UTF-8 bytevector: the first octet is present, one or more among the second, third and fourth ones are missing because we are at the end of the bytevector. It is derived from &utf8-string-decoding. It has the following fields:

bytevector

The UTF-8 bytevector.

index

The index in the bytevector of the first octet in the incomplete sequence.

octets

A list holding the incomplete sequence of octets.

Function: make-utf8-string-decoding-incomplete-4-tuple bytevector index octets

Build and return a condition object of type &utf8-string-decoding-incomplete-4-tuple.

Function: utf8-string-decoding-incomplete-4-tuple? obj

Return #t if obj is a condition object of type &utf8-string-decoding-incomplete-4-tuple; otherwise return #f.

Function: utf8-string-decoding-incomplete-4-tuple.bytevector cnd

Function: utf8-string-decoding-incomplete-4-tuple.index cnd

Function: utf8-string-decoding-incomplete-4-tuple.octets cnd

Field accessors for condition objects of type &utf8-string-decoding-incomplete-4-tuple.