utf8->string -- r7rs Definition

§

Kind

§

converter;

Implemented by

§

• utf8->string (from vonuvoli);

Procedure signature

§

Procedure variants:

• ((bytevector-empty) -> (string-empty))
  • input: a value of type bytevector-empty;
  • output: a value of type string-empty;
• ((bytevector-not-empty) -> (string-not-empty))
  • input: a value of type bytevector-not-empty;
  • output: a value of type string-not-empty;
• ((bytevector range-start) -> (string))
  • inputs:
    • a value of type bytevector;
    • a value of type range-start;
  • output: a value of type string;
• ((bytevector range-start range-end) -> (string))
  • inputs:
    • a value of type bytevector;
    • a value of type range-start;
    • a value of type range-end;
  • output: a value of type string;

Exports

§

• scheme:base -- (scheme base);

Exports recursive

§

• scheme -- (scheme);

Description

§

(utf8->string bytevector)
(utf8->string bytevector start)
(utf8->string bytevector start end)
(string->utf8 string)
(string->utf8 string start)
(string->utf8 string start end)

Domain: It is an error for bytevector to contain invalid UTF-8 byte sequences.

These procedures translate between strings and bytevectors that encode those strings using the UTF-8 encoding. The utf8->string procedure decodes the bytes of a bytevector between start and end and returns the corresponding string; the string->utf8 procedure encodes the characters of a string between start and end and returns the corresponding bytevector.

(utf8->string #u8(#x41)) ===> "A"
(string->utf8 "λ") ===> #u8(#xCE #xBB)

---

The text herein was sourced and adapted as described in the "R7RS attribution of various text snippets" appendix.

Referenced-types

§

• bytevector-empty;
• string-empty;
• bytevector-not-empty;
• string-not-empty;
• bytevector;
• range-start;
• string;
• range-end;