print.h

Go to the documentation of this file.

/* -*- C -*-
 * Serene programming language
 * Copyright (C) 2019-2026 Sameer Rahmani <[email protected]>
 *
 * This library is free software: you can redistribute it and/or modify
 * it under the terms of the GNU Lesser General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU Lesser General Public License for more details.
 */
#pragma once
 
#include <stdio.h>
 
#include "serene/rt/core.h"
 
typedef struct srn_context_t srn_context_t;
 
/// Print a value to `out` in its S-expression form. Atoms round-trip with the
/// reader; compounds without a public iterator (VMap) print as opaque
/// placeholders for now.
[[gnu::nonnull(1, 2, 3)]]
void srn_value_print(FILE *out, srn_context_t *ctx, const srn_value_t *v);
 
/// Same as srn_value_print followed by '\n'.
[[gnu::nonnull(1, 2, 3)]]
void srn_value_println(FILE *out, srn_context_t *ctx, const srn_value_t *v);
 
/// Print a syntax node to `out` in its S-expression form. Numbers are
/// emitted from their stored raw text (no formatting normalization). Maps
/// print as `{k v k v}` because the syntax-level container is a flat seq.
[[gnu::nonnull(1, 2, 3)]]
void srn_syntax_print(FILE *out, srn_context_t *ctx, const srn_syntax_t *s);
 
/// Same as srn_syntax_print followed by '\n'.
[[gnu::nonnull(1, 2, 3)]]
void srn_syntax_println(FILE *out, srn_context_t *ctx, const srn_syntax_t *s);