1
Fork 0
mirror of https://git.savannah.gnu.org/git/guile.git synced 2025-04-29 19:30:36 +02:00

Deprecate vector-ref, vector-length, vector-set! on weak vectors

* libguile/vectors.c (scm_vector_length, scm_c_vector_length):
  (scm_c_vector_ref, scm_c_vector_set_x): Deprecate the use of these
  procedures on weak vectors.

* test-suite/tests/guardians.test:
* test-suite/tests/weaks.test: Adapt test suites.
This commit is contained in:
Andy Wingo 2014-02-07 12:42:44 +01:00
parent 1e3fd6a0c8
commit 9b5da400dd
3 changed files with 59 additions and 43 deletions

View file

@ -1,5 +1,5 @@
/* Copyright (C) 1995,1996,1998,1999,2000,2001, 2006, 2008, 2009, 2010,
* 2011, 2012 Free Software Foundation, Inc.
* 2011, 2012, 2014 Free Software Foundation, Inc.
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public License
@ -117,7 +117,13 @@ SCM
scm_vector_length (SCM v)
{
if (SCM_I_IS_VECTOR (v))
return scm_from_size_t (SCM_I_VECTOR_LENGTH (v));
{
if (SCM_I_WVECTP (v))
scm_c_issue_deprecation_warning
("Using vector-length on weak vectors is deprecated. "
"Use weak-vector-length from (ice-9 weak-vectors) instead.");
return scm_from_size_t (SCM_I_VECTOR_LENGTH (v));
}
else if (SCM_I_ARRAYP (v) && SCM_I_ARRAY_NDIM (v) == 1)
{
scm_t_array_dim *dim = SCM_I_ARRAY_DIMS (v);
@ -130,7 +136,7 @@ scm_vector_length (SCM v)
size_t
scm_c_vector_length (SCM v)
{
if (SCM_I_IS_VECTOR (v))
if (SCM_I_IS_NONWEAK_VECTOR (v))
return SCM_I_VECTOR_LENGTH (v);
else
return scm_to_size_t (scm_vector_length (v));
@ -206,7 +212,7 @@ scm_vector_ref (SCM v, SCM k)
SCM
scm_c_vector_ref (SCM v, size_t k)
{
if (SCM_I_IS_VECTOR (v))
if (SCM_I_IS_NONWEAK_VECTOR (v))
{
register SCM elt;
@ -214,12 +220,15 @@ scm_c_vector_ref (SCM v, size_t k)
scm_out_of_range (NULL, scm_from_size_t (k));
elt = (SCM_I_VECTOR_ELTS(v))[k];
if (SCM_UNPACK (elt) == 0 && SCM_I_WVECTP (v))
/* ELT was a weak pointer and got nullified by the GC. */
return SCM_BOOL_F;
return elt;
}
else if (SCM_I_WVECTP (v))
{
scm_c_issue_deprecation_warning
("Using vector-ref on weak vectors is deprecated. "
"Instead, use weak-vector-ref from (ice-9 weak-vectors).");
return scm_c_weak_vector_ref (v, k);
}
else if (SCM_I_ARRAYP (v) && SCM_I_ARRAY_NDIM (v) == 1)
{
scm_t_array_dim *dim = SCM_I_ARRAY_DIMS (v);
@ -234,8 +243,12 @@ scm_c_vector_ref (SCM v, size_t k)
elt = (SCM_I_VECTOR_ELTS (vv))[k];
if (SCM_UNPACK (elt) == 0 && (SCM_I_WVECTP (vv)))
/* ELT was a weak pointer and got nullified by the GC. */
return SCM_BOOL_F;
{
scm_c_issue_deprecation_warning
("Weak arrays are deprecated. Use weak vectors instead.");
/* ELT was a weak pointer and got nullified by the GC. */
return SCM_BOOL_F;
}
return elt;
}
@ -270,17 +283,18 @@ scm_vector_set_x (SCM v, SCM k, SCM obj)
void
scm_c_vector_set_x (SCM v, size_t k, SCM obj)
{
if (SCM_I_IS_VECTOR (v))
if (SCM_I_IS_NONWEAK_VECTOR (v))
{
if (k >= SCM_I_VECTOR_LENGTH (v))
scm_out_of_range (NULL, scm_from_size_t (k));
(SCM_I_VECTOR_WELTS(v))[k] = obj;
if (SCM_I_WVECTP (v))
{
/* Make it a weak pointer. */
SCM *link = & SCM_I_VECTOR_WELTS (v)[k];
SCM_I_REGISTER_DISAPPEARING_LINK ((void **) link, SCM2PTR (obj));
}
}
else if (SCM_I_WVECTP (v))
{
scm_c_issue_deprecation_warning
("Using vector-set! on weak vectors is deprecated. "
"Instead, use weak-vector-set! from (ice-9 weak-vectors).");
scm_c_weak_vector_set_x (v, k, obj);
}
else if (SCM_I_ARRAYP (v) && SCM_I_ARRAY_NDIM (v) == 1)
{
@ -298,6 +312,8 @@ scm_c_vector_set_x (SCM v, size_t k, SCM obj)
/* Make it a weak pointer. */
SCM *link = & SCM_I_VECTOR_WELTS (vv)[k];
SCM_I_REGISTER_DISAPPEARING_LINK ((void **) link, SCM2PTR (obj));
scm_c_issue_deprecation_warning
("Weak arrays are deprecated. Use weak vectors instead.");
}
}
else

View file

@ -1,7 +1,7 @@
;;;; guardians.test --- test suite for Guile Guardians -*- scheme -*-
;;;; Jim Blandy <jimb@red-bean.com> --- July 1999
;;;;
;;;; Copyright (C) 1999, 2001, 2006 Free Software Foundation, Inc.
;;;; Copyright (C) 1999, 2001, 2006, 2014 Free Software Foundation, Inc.
;;;;
;;;; This library is free software; you can redistribute it and/or
;;;; modify it under the terms of the GNU Lesser General Public
@ -209,7 +209,7 @@
(gc)
(let ((p (cons #f #f)))
(g p)
(vector-set! v 0 p)
(weak-vector-set! v 0 p)
(set! p #f)) ;; clear refs left on the stack
(if (not (eq? (g) #f))
(throw 'unresolved)
@ -225,7 +225,7 @@
(gc)
(let ((p (cons #f #f)))
(g p)
(vector-set! v 0 p)
(weak-vector-set! v 0 p)
(set! p #f)) ;; clear refs left on the stack
(begin
(gc)
@ -233,7 +233,7 @@
(throw 'unresolved)
(begin
(gc)
(or (not (vector-ref v 0))
(or (not (weak-vector-ref v 0))
(throw 'unresolved))))))))
(with-test-prefix "guarding weak containers"
@ -243,11 +243,11 @@
(v (weak-vector #f)))
;; Note: We don't pass `(cons #f #f)' as an argument to `weak-vector'
;; otherwise references to it are likely to be left on the stack.
(vector-set! v 0 (cons #f #f))
(weak-vector-set! v 0 (cons #f #f))
(g v)
(gc)
(if (equal? (vector-ref v 0) (cons #f #f))
(if (equal? (weak-vector-ref v 0) (cons #f #f))
(throw 'unresolved)
#t))))

View file

@ -1,5 +1,5 @@
;;;; weaks.test --- tests guile's weaks -*- scheme -*-
;;;; Copyright (C) 1999, 2001, 2003, 2006, 2009, 2010, 2011 Free Software Foundation, Inc.
;;;; Copyright (C) 1999, 2001, 2003, 2006, 2009, 2010, 2011, 2014 Free Software Foundation, Inc.
;;;;
;;;; This library is free software; you can redistribute it and/or
;;;; modify it under the terms of the GNU Lesser General Public
@ -57,13 +57,13 @@
(pass-if "create"
(let* ((lst '(a b c d e f g))
(wv (list->weak-vector lst)))
(and (eq? (vector-ref wv 0) 'a)
(eq? (vector-ref wv 1) 'b)
(eq? (vector-ref wv 2) 'c)
(eq? (vector-ref wv 3) 'd)
(eq? (vector-ref wv 4) 'e)
(eq? (vector-ref wv 5) 'f)
(eq? (vector-ref wv 6) 'g))))
(and (eq? (weak-vector-ref wv 0) 'a)
(eq? (weak-vector-ref wv 1) 'b)
(eq? (weak-vector-ref wv 2) 'c)
(eq? (weak-vector-ref wv 3) 'd)
(eq? (weak-vector-ref wv 4) 'e)
(eq? (weak-vector-ref wv 5) 'f)
(eq? (weak-vector-ref wv 6) 'g))))
(pass-if-exception "bad-args"
exception:wrong-type-arg
(list->weak-vector 32)))
@ -99,11 +99,11 @@
(define global-weak (make-weak-vector 10 #f))
(begin
(vector-set! global-weak 0 (string-copy "string"))
(vector-set! global-weak 1 (string-copy "beans"))
(vector-set! global-weak 2 (string-copy "to"))
(vector-set! global-weak 3 (string-copy "utah"))
(vector-set! global-weak 4 (string-copy "yum yum"))
(weak-vector-set! global-weak 0 (string-copy "string"))
(weak-vector-set! global-weak 1 (string-copy "beans"))
(weak-vector-set! global-weak 2 (string-copy "to"))
(weak-vector-set! global-weak 3 (string-copy "utah"))
(weak-vector-set! global-weak 4 (string-copy "yum yum"))
(gc))
;;; Normal weak vectors
@ -113,17 +113,17 @@
"weak-vector"
(pass-if "lives"
(begin
(vector-set! x 0 bar)
(weak-vector-set! x 0 bar)
(gc)
(and (vector-ref x 0) (eq? bar (vector-ref x 0)))))
(and (weak-vector-ref x 0) (eq? bar (weak-vector-ref x 0)))))
(pass-if "dies"
(begin
(gc)
(or (and (not (vector-ref global-weak 0))
(not (vector-ref global-weak 1))
(not (vector-ref global-weak 2))
(not (vector-ref global-weak 3))
(not (vector-ref global-weak 4)))
(or (and (not (weak-vector-ref global-weak 0))
(not (weak-vector-ref global-weak 1))
(not (weak-vector-ref global-weak 2))
(not (weak-vector-ref global-weak 3))
(not (weak-vector-ref global-weak 4)))
(throw 'unresolved))))))