io.h

/* vim: set tabstop=8 shiftwidth=4 softtabstop=4 expandtab smarttab colorcolumn=80: */
/*
 * Copyright 2017 Red Hat, Inc.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

#pragma once

#include "cfg.h"
#include <stdbool.h>
#include <stdio.h>

#ifdef DOXYGEN

typedef jose_io_t jose_io_auto_t;

typedef struct {
    bool  (*feed)(jose_io_t *io, const void *in, size_t len);

    bool  (*done)(jose_io_t *io);
} jose_io_t;
#else
#define jose_io_auto_t jose_io_t __attribute__((cleanup(jose_io_auto)))

typedef struct jose_io jose_io_t;
struct jose_io {
    size_t  refs;
    bool  (*feed)(jose_io_t *io, const void *in, size_t len);
    bool  (*done)(jose_io_t *io);
    void  (*free)(jose_io_t *io); /* Don't call this. Use jose_io_decref(). */
};
#endif

void
jose_io_auto(jose_io_t **io);

jose_io_t *
jose_io_incref(jose_io_t *io);

void
jose_io_decref(jose_io_t *io);

jose_io_t *
jose_io_malloc(jose_cfg_t *cfg, void **buf, size_t *len);

void *
jose_io_malloc_steal(void **buf);

jose_io_t *
jose_io_buffer(jose_cfg_t *cfg, void *buf, size_t *len);

jose_io_t *
jose_io_file(jose_cfg_t *cfg, FILE *file);

jose_io_t *
jose_io_multiplex(jose_cfg_t *cfg, jose_io_t **nexts, bool all);