/*-
 * SPDX-FileCopyrightText: (c) 2003, 2004 Lev Walkin <vlm@lionet.info>. All rights reserved.
 * SPDX-License-Identifier: BSD-1-Clause
 */
#ifndef _XER_ENCODER_H
#define _XER_ENCODER_H

#include <asn_application.h>

#ifdef __cplusplus
extern "C"
{
#endif

    struct asn_TYPE_descriptor_s; /* Forward declaration */

    /* Flags used by the xer_encode() and (*xer_type_encoder_f), defined below
     */
    enum xer_encoder_flags_e
    {
        /* Mode of encoding */
        XER_F_BASIC = 0x01,    /* BASIC-XER (pretty-printing) */
        XER_F_CANONICAL = 0x02 /* Canonical XER (strict rules) */
    };

    /*
     * The XER encoder of any type. May be invoked by the application.
     */
    asn_enc_rval_t xer_encode(struct asn_TYPE_descriptor_s *td,
        void *sptr, /* Structure to be encoded */
        enum xer_encoder_flags_e xer_flags,
        asn_app_consume_bytes_f *consume_bytes_cb,
        void *app_key /* Arbitrary callback argument */
    );

    /*
     * The variant of the above function which dumps the BASIC-XER (XER_F_BASIC)
     * output into the chosen file pointer.
     * RETURN VALUES:
     *      0: The structure is printed.
     *     -1: Problem printing the structure.
     * WARNING: No sensible errno value is returned.
     */
    int xer_fprint(FILE *stream, struct asn_TYPE_descriptor_s *td, void *sptr);

    /*
     * Type of the generic XER encoder.
     */
    typedef asn_enc_rval_t(xer_type_encoder_f)(
        struct asn_TYPE_descriptor_s *type_descriptor,
        void *struct_ptr, /* Structure to be encoded */
        int ilevel,       /* Level of indentation */
        enum xer_encoder_flags_e xer_flags,
        asn_app_consume_bytes_f *consume_bytes_cb, /* Callback */
        void *app_key                              /* Arbitrary callback argument */
    );

#ifdef __cplusplus
}
#endif

#endif /* _XER_ENCODER_H_ */
