summaryrefslogtreecommitdiff
path: root/src/util/index.h
blob: a8910a696db85e4395ada8400d2ff9d3a22774ea (plain)
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
/*********************                                                        */
/*! \file index.h
 ** \verbatim
 ** Top contributors (to current version):
 **   Tim King, Morgan Deters, Paul Meng
 ** This file is part of the CVC4 project.
 ** Copyright (c) 2009-2017 by the authors listed in the file AUTHORS
 ** in the top-level source directory) and their institutional affiliations.
 ** All rights reserved.  See the file COPYING in the top-level source
 ** directory for licensing information.\endverbatim
 **
 ** \brief [[ Add one-line brief description here ]]
 **
 ** [[ Add lengthier description here ]]
 ** \todo document this file
 **/

#include "cvc4_private.h"

#pragma once

#include <stdint.h>
#include <boost/static_assert.hpp>
#include <limits>

namespace CVC4 {

/**
 * Index is an unsigned integer used for array indexing.
 *
 * This gives a standardized type for independent pieces of code to use as an agreement.
 */
typedef uint32_t Index;

BOOST_STATIC_ASSERT(sizeof(Index) <= sizeof(size_t));
BOOST_STATIC_ASSERT(!std::numeric_limits<Index>::is_signed);

/* Discussion: Why is Index a uint32_t instead of size_t (or uint_fast32_t)?
 *
 * size_t is a more appropriate choice than uint32_t as the choice is dictated by
 * uniqueness in arrays and vectors. These correspond to size_t.
 * However, the using size_t with a sizeof == 8 on 64 bit platforms is noticeably
 * slower. (Limited testing suggests a ~1/16 of running time.)
 * (Interestingly, uint_fast32_t also has a sizeof == 8 on x86_64. Filthy Liars!)
 */

}/* CVC4 namespace */
generated by cgit on debian on lair
contact matthew@masot.net with questions or feedback