Coverage Report

Created: 2026-03-26 17:32

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
contrib/faiss/faiss/impl/io_macros.h
Line
Count
Source
1
/*
2
 * Copyright (c) Meta Platforms, Inc. and affiliates.
3
 *
4
 * This source code is licensed under the MIT license found in the
5
 * LICENSE file in the root directory of this source tree.
6
 */
7
8
#pragma once
9
10
#include <faiss/impl/maybe_owned_vector.h>
11
12
/*************************************************************
13
 * I/O macros
14
 *
15
 * we use macros so that we have a line number to report in abort
16
 * (). This makes debugging a lot easier. The IOReader or IOWriter is
17
 * always called f and thus is not passed in as a macro parameter.
18
 **************************************************************/
19
20
#define READANDCHECK(ptr, n)                         \
21
3.42k
    {                                                \
22
3.42k
        size_t ret = (*f)(ptr, sizeof(*(ptr)), n);   \
23
3.42k
        FAISS_THROW_IF_NOT_FMT(                      \
24
3.42k
                ret == (n),                          \
25
3.42k
                "read error in %s: %zd != %zd (%s)", \
26
3.42k
                f->name.c_str(),                     \
27
3.42k
                ret,                                 \
28
3.42k
                size_t(n),                           \
29
3.42k
                strerror(errno));                    \
30
3.42k
    }
31
32
2.11k
#define READ1(x) READANDCHECK(&(x), 1)
33
34
#define READ1_DUMMY(x_type) \
35
102
    {                       \
36
102
        x_type x = {};      \
37
102
        READ1(x);           \
38
102
    }
39
40
// will fail if we write 256G of data at once...
41
#define READVECTOR(vec)                                              \
42
532
    {                                                                \
43
532
        size_t size;                                                 \
44
532
        READANDCHECK(&size, 1);                                      \
45
532
        FAISS_THROW_IF_NOT(size >= 0 && size < (uint64_t{1} << 40)); \
46
532
        (vec).resize(size);                                          \
47
532
        READANDCHECK((vec).data(), size);                            \
48
532
    }
49
50
#define WRITEANDCHECK(ptr, n)                         \
51
2.24k
    {                                                 \
52
2.24k
        size_t ret = (*f)(ptr, sizeof(*(ptr)), n);    \
53
2.24k
        FAISS_THROW_IF_NOT_FMT(                       \
54
2.24k
                ret == (n),                           \
55
2.24k
                "write error in %s: %zd != %zd (%s)", \
56
2.24k
                f->name.c_str(),                      \
57
2.24k
                ret,                                  \
58
2.24k
                size_t(n),                            \
59
2.24k
                strerror(errno));                     \
60
2.24k
    }
61
62
1.38k
#define WRITE1(x) WRITEANDCHECK(&(x), 1)
63
64
#define WRITEVECTOR(vec)                   \
65
334
    {                                      \
66
334
        size_t size = (vec).size();        \
67
334
        WRITEANDCHECK(&size, 1);           \
68
334
        WRITEANDCHECK((vec).data(), size); \
69
334
    }
70
71
// read/write xb vector for backwards compatibility of IndexFlat
72
73
#define WRITEXBVECTOR(vec)                         \
74
61
    {                                              \
75
61
        FAISS_THROW_IF_NOT((vec).size() % 4 == 0); \
76
61
        size_t size = (vec).size() / 4;            \
77
61
        WRITEANDCHECK(&size, 1);                   \
78
61
        WRITEANDCHECK((vec).data(), size * 4);     \
79
61
    }
80
81
#define READXBVECTOR(vec)                                            \
82
106
    {                                                                \
83
106
        size_t size;                                                 \
84
106
        READANDCHECK(&size, 1);                                      \
85
106
        FAISS_THROW_IF_NOT(size >= 0 && size < (uint64_t{1} << 40)); \
86
106
        size *= 4;                                                   \
87
106
        (vec).resize(size);                                          \
88
106
        READANDCHECK((vec).data(), size);                            \
89
106
    }