api/streams_8h_source.html

/*

 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.

 *

 * Copyright 2021 Mike Becker, Olaf Wintermann All rights reserved.

 *

 * Redistribution and use in source and binary forms, with or without

 * modification, are permitted provided that the following conditions are met:

 *

 *   1. Redistributions of source code must retain the above copyright

 *      notice, this list of conditions and the following disclaimer.

 *

 *   2. Redistributions in binary form must reproduce the above copyright

 *      notice, this list of conditions and the following disclaimer in the

 *      documentation and/or other materials provided with the distribution.

 *

 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"

 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE

 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE

 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE

 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR

 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF

 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS

 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN

 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)

 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE

 * POSSIBILITY OF SUCH DAMAGE.

 */


#ifndef UCX_STREAMS_H

#define UCX_STREAMS_H


#include "common.h"


CX_EXTERN CX_NONNULL_ARG(1, 2, 3, 4)

CX_ACCESS_R(1) CX_ACCESS_W(2) CX_ACCESS_W(5)

size_t cx_stream_bncopy(void *src, void *dest,

        cx_read_func rfnc, cx_write_func wfnc,

        char *buf, size_t bufsize, size_t n);


#define cx_stream_bcopy(src, dest, rfnc, wfnc, buf, bufsize) \

    cx_stream_bncopy(src, dest, rfnc, wfnc, buf, bufsize, SIZE_MAX)


CX_EXTERN CX_NONNULL CX_ACCESS_R(1) CX_ACCESS_W(2)

size_t cx_stream_ncopy(void *src, void *dest,

        cx_read_func rfnc, cx_write_func wfnc, size_t n);


#define cx_stream_copy(src, dest, rfnc, wfnc) \

    cx_stream_ncopy(src, dest, rfnc, wfnc, SIZE_MAX)


#endif // UCX_STREAMS_H

common.h
Common definitions and feature checks.

cx_write_func
size_t(* cx_write_func)(const void *, size_t, size_t, void *)
Function pointer compatible with fwrite-like functions.
Definition common.h:325

cx_read_func
size_t(* cx_read_func)(void *, size_t, size_t, void *)
Function pointer compatible with fread-like functions.
Definition common.h:330

CX_NONNULL
#define CX_NONNULL
All pointer arguments must be non-NULL.
Definition common.h:141

CX_NONNULL_ARG
#define CX_NONNULL_ARG(...)
The specified pointer arguments must be non-NULL.
Definition common.h:146

CX_EXTERN
#define CX_EXTERN
Declares a function with external linkage.
Definition common.h:297

CX_ACCESS_R
#define CX_ACCESS_R(...)
Specifies that the function will only read through the given pointer.
Definition common.h:230

CX_ACCESS_W
#define CX_ACCESS_W(...)
Specifies that the function will only write through the given pointer.
Definition common.h:246

cx_stream_ncopy
size_t cx_stream_ncopy(void *src, void *dest, cx_read_func rfnc, cx_write_func wfnc, size_t n)
Reads data from a stream and writes it to another stream.

cx_stream_bncopy
size_t cx_stream_bncopy(void *src, void *dest, cx_read_func rfnc, cx_write_func wfnc, char *buf, size_t bufsize, size_t n)
Reads data from a stream and writes it to another stream.