bytevector-append - append bytevectors

LIBRARY

(import (scheme base))              ;R7RS

SYNOPSIS

(bytevector-append bytevector ...)

DESCRIPTION

Returns a newly allocated bytevector whose elements are the concatenation of the elements in the given bytevectors.

RETURN VALUES

Returns a single bytevector object.

EXAMPLES

(bytevector-append #u8(0 1 2) #u8(3 4 5))
          => #u8(0 1 2 3 4 5)

COMPATIBILITY

This procedure is absent from R6RS. One possible implementation is shown below.
(define (bytevector-append . bvs)
  (call-with-bytevector-output-port
    (lambda (p)
      (for-each (lambda (bv) (put-bytevector p bv)) bvs))))

ERRORS

It is an error if one of the arguments is not a bytevector. Implementations may signal an error, extend the procedure's domain of definition to include such arguments, or fail catastrophically.

SEE ALSO

make-bytevector(3scm), append(3scm)

STANDARDS

R7RS

AUTHORS

This page is part of the scheme-manpages project. It includes materials from the RnRS documents. More information can be found at https://github.com/schemedoc/manpages/.


Markup created by unroff 1.0sc,    March 04, 2023.