/usr/include/regina-normal/engine.h is in regina-normal-dev 5.1-2build1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 | /**************************************************************************
* *
* Regina - A Normal Surface Theory Calculator *
* Computational Engine *
* *
* Copyright (c) 1999-2016, Ben Burton *
* For further details contact Ben Burton (bab@debian.org). *
* *
* This program is free software; you can redistribute it and/or *
* modify it under the terms of the GNU General Public License as *
* published by the Free Software Foundation; either version 2 of the *
* License, or (at your option) any later version. *
* *
* As an exception, when this program is distributed through (i) the *
* App Store by Apple Inc.; (ii) the Mac App Store by Apple Inc.; or *
* (iii) Google Play by Google Inc., then that store may impose any *
* digital rights management, device limits and/or redistribution *
* restrictions that are required by its terms of service. *
* *
* This program 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 *
* General Public License for more details. *
* *
* You should have received a copy of the GNU General Public *
* License along with this program; if not, write to the Free *
* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, *
* MA 02110-1301, USA. *
* *
**************************************************************************/
/*! \file engine.h
* \brief Provides global routines for interfacing with the Regina
* calculation engine.
*/
#ifndef __ENGINE_H
#ifndef __DOXYGEN
#define __ENGINE_H
#endif
#include "regina-core.h"
/**
* Contains the entire Regina calculation engine.
*
* \todo \prob Derive from boost::noncopyable where appropriate.
* \todo \featurelong Enhance the test suite for the calculation engine.
*/
namespace regina {
/**
* \addtogroup engine Engine Structure
* Overall structure of the calculation engine.
* @{
*/
/**
* Returns the full version number of this calculation engine.
* For instance, version 2.3.1 would have full version <tt>"2.3.1"</tt>.
*
* @return the version of this calculation engine.
*/
REGINA_API const char* versionString();
/**
* Returns the major version number of this calculation engine.
* For instance, version 2.3.1 would have major version 2.
*
* @return the major version number of this calculation engine.
*/
REGINA_API int versionMajor();
/**
* Returns the minor version number of this calculation engine.
* For instance, version 2.3.1 would have minor version 3.
*
* @return the minor version number of this calculation engine.
*/
REGINA_API int versionMinor();
/**
* Did the given version of Regina consistently use UTF-8 in its data
* files?
*
* In Regina versions 4.4 and below, no particular attention was paid to
* character encodings. As a result, the GUI typically stored data in
* LATIN1 (the default for the Qt libraries).
*
* As of Regina 4.5, all strings are now stored in UTF-8 where possible.
*
* This routine allows programs to determine which regime a particular
* version of Regina belongs to. This can be useful when working with
* Regina data files on a low-level basis.
*
* Any whitespace in the version string will confuse the result, and the
* return value will be undefined.
*
* As a special case, an empty string is treated as belonging to the
* UTF-8 regime.
*
* @param version a version string from some release of Regina, such as "4.2".
* This must not contain any whitespace padding.
* @return \c true if the given version uses UTF-8 consistently, or
* \c false if the given version is an older version that did not pay
* attention to character encodings.
*/
REGINA_API bool versionUsesUTF8(const char* version);
/**
* Returns the version of SnapPy whose underlying SnapPea kernel is built
* into Regina.
*
* The SnapPea kernel is now maintained by the larger \e SnapPy project,
* and Regina sources its version of the SnapPea kernel from one of the
* recent SnapPy releases. See http://snappy.computop.org/ for details.
*
* In Regina, you can access the SnapPea kernel through the
* SnapPeaTriangulation class.
*
* @return the version of SnapPy whose underlying SnapPea kernel is
* built into Regina.
*/
REGINA_API const char* versionSnapPy();
/**
* An alias for versionSnapPy(), which returns the version of SnapPy whose
* underlying SnapPea kernel is built into Regina.
*
* See versionSnapPy() for details.
*
* @return the version of SnapPy whose underlying SnapPea kernel is
* built into Regina.
*/
REGINA_API const char* versionSnapPea();
/**
* Does this particular build of Regina support native 128-bit arithmetic?
*
* On those platforms that do support native 128-bit arithmetic, some
* expensive algorithms (in particular for normal surface enumeration)
* are optimised to run significantly faster in some cases.
*
* @return \c true if and only if this build supports native 128-bit arithmetic.
*/
REGINA_API bool hasInt128();
/**
* Tests to see if an interface can successfully communicate with the
* underlying C++ calculation engine.
*
* This routine simply uses the engine to return the same value that is
* passed to it; it can be used to test whether communications between
* the interface and the C++ engine are working properly.
*
* @param value any integer; this same integer will be returned.
* @return the same integer that was passed as \a value.
*/
REGINA_API int testEngine(int value);
/*@}*/
} // namespace regina
#endif
|