1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
|
//------------------------------------------------------------------------------
// GxB_Vector_unload: unload C array from a dense GrB_Vector
//------------------------------------------------------------------------------
// SuiteSparse:GraphBLAS, Timothy A. Davis, (c) 2017-2025, All Rights Reserved.
// SPDX-License-Identifier: Apache-2.0
//------------------------------------------------------------------------------
// This method is guaranteed to take O(1) time and space, if on input V is a
// non-iso vector in the full data format.
// On input, V is a GrB_Vector with nvals(V) == length(V), in any data format.
// That is, all entries of V must be present. If this condition does not hold,
// the method returns an error code, GrB_INVALID_OBJECT, indicating that the
// vector is not a valid input for this method.
// V is returned as valid full vector of length 0 with no content (V->x ==
// NULL). It type is not changed. If on input V was in the full data format,
// then no mallocs/frees are performed.
// If readonly is returned as true, then V was created as a "shallow" vector
// by GxB_Vector_load. Its numerical content, V->x = (*X), was "shallow" and
// thus treated as readonly by GraphBLAS. Its allocation/deallocation is the
// responsibility of the user application that created V via GxB_Vector_load.
// On output, *X is a pointer to the numerical contents of V. If V had length
// zero on input, *X may be returned as a NULL pointer (which is not an error).
// This method removes X from the debug memtable, since X is being returned
// to the user application.
#include "GB_container.h"
#define GB_FREE_ALL ;
GrB_Info GxB_Vector_unload
(
// input/output:
GrB_Vector V, // vector to unload
void **X, // numerical array to unload from V
// output:
GrB_Type *type, // type of X
uint64_t *n, // # of entries in X
uint64_t *X_size, // size of X in bytes (at least n*(sizeof the type))
int *handling, // see GxB_Vector_load
const GrB_Descriptor desc // currently unused; for future expansion
)
{
//--------------------------------------------------------------------------
// check inputs
//--------------------------------------------------------------------------
// just check V; other inputs are checked in GB_vector_unload
GB_RETURN_IF_NULL_OR_FAULTY (V) ;
GB_RETURN_IF_NULL (handling) ;
GB_WHERE_1 (V, "GxB_Vector_unload") ;
ASSERT_VECTOR_OK (V, "V to unload", GB0) ;
//--------------------------------------------------------------------------
// unload the vector
//--------------------------------------------------------------------------
bool readonly ;
GB_OK (GB_vector_unload (V, X, type, n, X_size, &readonly, Werk)) ;
GBMDUMP ("vector_unload, remove X from memtable %p\n", *X) ;
if (!readonly)
{
// *X is given to the user application, so remove it from the debug
// global memtable
GB_Global_memtable_remove (*X) ;
}
(*handling) = readonly ? GxB_IS_READONLY : GrB_DEFAULT ;
return (GrB_SUCCESS) ;
}
|
