guile/libguile/deprecated.c

/* Copyright 2003-2004,2006,2008-2018,2020,2021,2022,2025
     Free Software Foundation, Inc.

   This file is part of Guile.

   Guile 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.

   Guile 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.

   You should have received a copy of the GNU Lesser General Public
   License along with Guile.  If not, see
   <https://www.gnu.org/licenses/>.  */

#ifdef HAVE_CONFIG_H
# include <config.h>
#endif

#define SCM_BUILDING_DEPRECATED_CODE

#include "deprecation.h"
#include "eval.h"
#include "gsubr.h"
#include "modules.h"
#include "numbers.h"
#include "threads.h"
#include "variable.h"

#include "deprecated.h"

#if (SCM_ENABLE_DEPRECATED == 1)



/* Deprecated functions go here.  */
static SCM make_guardian_var;

static void
init_make_guardian_var (void)
{
  make_guardian_var = scm_c_public_lookup ("ice-9 guardians", "make-guardian");
}

SCM
scm_make_guardian (void)
{
  static scm_i_pthread_once_t once = SCM_I_PTHREAD_ONCE_INIT;
  scm_i_pthread_once (&once, init_make_guardian_var);

  scm_c_issue_deprecation_warning
    ("The scm_make_guardian C interface is deprecated.  Invoke the Scheme "
     "make-guardian procedure from (ice-9 guardians) instead.");

  return scm_call_0 (scm_variable_ref (make_guardian_var));
}



static SCM make_weak_vector_var;
static SCM weak_vector_var;
static SCM weak_vector_p_var;
static SCM weak_vector_length_var;
static SCM weak_vector_ref_var;
static SCM weak_vector_set_x_var;

static void
init_weak_vector_vars (void)
{
  make_weak_vector_var =
    scm_c_public_lookup ("ice-9 weak-vector", "make-weak-vector");
  weak_vector_var =
    scm_c_public_lookup ("ice-9 weak-vector", "weak-vector");
  weak_vector_p_var =
    scm_c_public_lookup ("ice-9 weak-vector", "weak-vector?");
  weak_vector_length_var =
    scm_c_public_lookup ("ice-9 weak-vector", "weak-vector-length");
  weak_vector_ref_var =
    scm_c_public_lookup ("ice-9 weak-vector", "weak-vector-ref");
  weak_vector_set_x_var =
    scm_c_public_lookup ("ice-9 weak-vector", "weak-vector-set!");
}

static void
init_weak_vectors (void)
{
  static scm_i_pthread_once_t once = SCM_I_PTHREAD_ONCE_INIT;
  scm_c_issue_deprecation_warning
    ("The weak vector C interface is deprecated.  Invoke the Scheme "
     "procedures from (ice-9 weak-vector) instead.");
  scm_i_pthread_once (&once, init_weak_vector_vars);
}

SCM
scm_make_weak_vector (SCM len, SCM fill)
{
  init_weak_vectors ();
  return scm_call_2 (scm_variable_ref (make_weak_vector_var), len,
                     SCM_UNBNDP (fill) ? SCM_BOOL_F : fill);
}

SCM
scm_weak_vector (SCM l)
{
  init_weak_vectors ();
  return scm_call_1 (scm_variable_ref (weak_vector_var), l);
}

SCM
scm_weak_vector_p (SCM x)
{
  init_weak_vectors ();
  return scm_call_1 (scm_variable_ref (weak_vector_p_var), x);
}

SCM
scm_weak_vector_length (SCM v)
{
  init_weak_vectors ();
  return scm_call_1 (scm_variable_ref (weak_vector_length_var), v);
}

SCM
scm_weak_vector_ref (SCM v, SCM k)
{
  init_weak_vectors ();
  return scm_call_2 (scm_variable_ref (weak_vector_ref_var), v, k);
}

SCM
scm_weak_vector_set_x (SCM v, SCM k, SCM x)
{
  init_weak_vectors ();
  scm_call_3 (scm_variable_ref (weak_vector_set_x_var), v, k, x);
  return SCM_UNSPECIFIED;
}

SCM
scm_c_make_weak_vector (size_t len, SCM fill)
{
  return scm_make_weak_vector (scm_from_size_t (len), fill);
}

int
scm_is_weak_vector (SCM obj)
{
  return scm_is_true (scm_weak_vector_p (obj));
}

size_t
scm_c_weak_vector_length (SCM vec)
{
  return scm_to_size_t (scm_weak_vector_length (vec));
}

SCM
scm_c_weak_vector_ref (SCM v, size_t k)
{
  return scm_weak_vector_ref (v, scm_from_size_t (k));
}

void
scm_c_weak_vector_set_x (SCM v, size_t k, SCM x)
{
  scm_weak_vector_set_x (v, scm_from_size_t (k), x);
}



void
scm_i_init_deprecated ()
{
#include "deprecated.x"
}

#endif /* SCM_ENABLE_DEPRECATED == 1 */