get-output-string -- r7rs Definition

§

Kind

§

procedure;

Implemented by

§

• get-output-string (from vonuvoli);

Procedure signature

§

Procedure variants:

• ((string-output-port) -> (string))
  • input: a value of type string-output-port;
  • output: a value of type string;

Exports

§

• scheme:base -- (scheme base);

Exports recursive

§

• scheme -- (scheme);

Description

§

(get-output-string port)

Domain: It is an error if port was not created with open-output-string.

Returns a string consisting of the characters that have been output to the port so far in the order they were output. If the result string is modified, the effect is unspecified.

(parameterize
    ((current-output-port
      (open-output-string)))
    (display "piece")
    (display " by piece ")
    (display "by piece.")
    (newline)
    (get-output-string (current-output-port)))
===> "piece by piece by piece.\n"

---

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

Referenced-types

§

• string-output-port;
• string;