Regina - Moving from 6.x to 7.x

This page relates only to C++ and Python programmers.

Over time, Regina makes changes and improvements to its C++ and Python interfaces. This page explains how you will need to update your C++ code and/or Python scripts to work with Regina 7.0.

Many of the old classes and routines have been kept around but marked as deprecated, so that your old code will still work.

All of this deprecated code will be removed in Regina 7.1.

If you have very old code, you can also read the separate pages on moving from Regina 4.x to 5.x and moving from Regina 5.x to 6.x.

Changes from Regina 6.x to 7.x

First, you should read the summary of the major behavioural changes, available here online. This discusses some sweeping changes across the entire API, such as:

adopting the C++17 standard;
returning objects by value instead of by newly-allocated pointer, and likewise passing objects by reference or value instead of by pointer;
returning multiple values using tuples instead of passing extra "output arguments";
allowing mathematical objects such as triangulations or normal surface lists to live outside the packet tree;
managing packets exclusively by shared pointers.

If you have not read that summary, you should stop and read it now before continuing here.

Beyond this, there are a few general rules that have been applied across the API:

Functions that take callbacks (e.g., Triangulation<3>::retriangulate() or FacetPairing<dim>::findAllPairings()) have been redesigned in a way that is safer and more flexible. They now support lambdas, and no longer take function pointers involving untyped (void*) arguments. "Sentinel" callbacks (i.e., a final callback with a null argument once some algorithm has finished) have also been removed. You should read the API documentation to see exactly how these new interfaces work.
Most routines that used to take output iterators (e.g., Triangulation<dim>::findAllIsomorphisms()) have been redesigned to use these more flexible callbacks also.
Some routines that used to take optional output arguments (e.g., Triangulation<dim>::isoSig()) now have separate versions (e.g., isoSig() vs isoSigDetail()).
Cloning routines of the form Class::clone() have generally been replace by copy constructors.
Routines that take progress trackers no longer run in the background; instead the user is responsible for creating, joining and/or detaching threads.
In the subcomplex code (i.e., StandardTriangulation and its subclasses), the isXXX() and formsXXX() routines are now all called recognise(). For example, StandardTriangulation::isStandardTriangulation() is now StandardTriangulation::recognise(), and TriSolidTorus::formsTriSolidTorus() is now TriSolidTorus::recognise().
For C++ functions that take an output stream (e.g., Link::writePACE()), the Python bindings have been removed (since these bindings always assumed standard output). In all such cases there is a new function that returns a string instead (e.g., Link::pace()).

Errors and "unsolved scenarios" used to be handled using null/zero/empty return values, or sometimes using optional "error arguments" (e.g., a bool pointer argument that would return success or failure). Now Regina handles such scenarios using std::optional and exceptions:

Regina typically uses std::optional for ordinary scenarios where there is no solution (e.g., Triangulation<dim>::isIsomorphicTo(), or Triangulation<3>::nonTrivialSphereOrDisc()).
Regina typically uses exceptions for rare or unexpected failures, or genuine errors; for example:
- when preconditions are not met (though in most cases Regina does not test preconditions, since this is considered the user's responsibility);
- when some argument is allowed but explicitly unsupported (e.g., calling Triangulation<3>::dehydrate() on a triangulation with boundary faces);
- out-of-range errors (e.g., Rational::doubleApprox());
- parsing errors (e.g., the string-based Integer constructor, or the input stream constructor for GluingPerms<dim>);
- object reconstruction errors (e.g., Link::fromKnotSig());
- specific cases of a more general function that are not yet implemented (e.g., some cases of Manifold::construct());
- algorithms that talk with the SnapPea kernel, where SnapPea could theoretically fail (e.g., NormalSurface::boundaryIntersections());
- member functions of SnapPeaTriangulation, in cases where you have a null SnapPea triangulation.
Whenever a function might throw an exception, the type of exception and the circumstances in which it is thrown will be clearly marked in Regina's API documentation.

These notes above cover most of the widespread API changes. However, there are many additional changes to specific headers, classes, functions and and constants. These are listed in the table below, along with suggestions for how you should change your code. Any changes in the behaviour of these routines or classes are noted in the comments column.

The blue cells indicate code that is still present in Regina, but is now deprecated (i.e., marked for removal in a future release). The red cells indicate code that has already been removed from Regina.

Deprecated code Replacement Comments

Headers

file/xml*.h
Removed in Regina 7.0 — All low-level XML parsing code is now private to Regina's engine, and so these XML parsing headers are no longer installed. The only public access to Regina's XML parsing code is via regina::open().

surfaces/*.h surface/*.h Renamed to match angle/*.h and hypersurface/*.h, which also use the singular (not the plural).

triangulation/homologicaldata.h
Removed in Regina 7.0 triangulation/dim3/homologicaldata.h

hypersurface/hscoordregistry.h,
hypersurface/hscoordregistry-impl.h,
packet/packetregistry.h,
packet/packetregistry-impl.h,
surfaces/coordregistry.h,
surfaces/coordregistry-impl.h,
surfaces/filterregistry.h,
surfaces/filterregistry-impl.h
Removed in Regina 7.0 — The old type registries have been removed. Normal surfaces and hypersurfaces no longer have different subclasses for different coordinate systems; instead each surface or hypersurface stores a NormalEncoding or HyperEncoding. Most of the remaining registry functionality is still available through virtual functions and/or the redesigned PacketInfo, NormalInfo and HyperInfo classes.

utilities/memutils.h,
utilities/property.h,
utilities/ptrutils.h,
utilities/registryutils.h
Removed in Regina 7.0 — Since the move to C++17, these utilities have either become unnecessary or been replaced with simpler alternatives.

Classes, Enums and Type Aliases

AngleStructureVector
Removed in Regina 7.0 — Angle structures now hold their coordinates using a plain Vector<Integer>.

BitmaskLenN, for all N Bitmask1<uint8_t>, Bitmask1<uint16_t>, etc.

CensusHits, CensusHitIterator
Removed in Regina 7.0 std::list<CensusHit>, std::list<CensusHit>::const_iterator

DiscSetTetData<T>::DataPtr DiscSetTetData<T>::Data*

EnumConstraints
Removed in Regina 7.0 ValidityConstraints This class has been completely redesigned (hence the rename); you will need to read the ValidityConstraints documentation before using it.

FuncDelete, FuncNew, FuncNewCopyPtr, FuncNewCopyRef, FuncNewCopyClonePtr
Removed in Regina 7.0 — C++ provides good alternatives for these nowadays.

GluingPermSearcher<3>::PurgeFlags regina::CensusPurge, regina::CensusPurgeFlags

Handlebody (non-orientable case)
Removed in Regina 7.0 — The Handlebody class now only represents orientable handlebodies, since the non-orientable case was never fully implemented.

HasReturnType
Removed in Regina 7.0 —

HyperInfo<coords>
Removed in Regina 7.0 HyperInfo (non-templated) Most of the old templated HyperInfo functionality is now accessible through HyperEncoding(coords). The new non-templated HyperInfo class just has some descriptive name functions, accessible at both compile time and runtime.

L31Pillow
Removed in Regina 7.0 TrivialTri The old L31Pillow is now one of the many ad-hoc cases handled by TrivialTri.

LessDeref
Removed in Regina 7.0 — Just use a lambda if you need to.

LightweightSequence<T>::Less
Removed in Regina 7.0 —

LightweightSequence<T>::SubsequenceCompareFirstPtr
Removed in Regina 7.0 LightweightSequence<T>::SubsequenceCompareFirst This inner class has been significantly redesigned, and now works with containers whose keys are sequences (not pointers to sequences).

ListOnCall
Removed in Regina 7.0 — This class was not thread-safe, and did not add anything non-trivial.

LPConstraint...::Coefficients
Removed in Regina 7.0 — The interface for describing linear programming constraints has changed significantly. Typical users should not be affected, but do read the API docs if you are writing constraint classes of your own.

LPConstraintEuler LPConstraintEulerPositive

Matrix<T>::Coefficient Matrix<T>::value_type

NewFunction
Removed in Regina 7.0 —

NNativeLong NativeLong

NormalInfo<coords>
Removed in Regina 7.0 NormalInfo (non-templated) Most of the old templated NormalInfo functionality is now accessible through NormalEncoding(coords). The new non-templated NormalInfo class just has some descriptive name functions, accessible at both compile time and runtime.

NormalSurfaceVector, NormalHypersurfaceVector and subclasses
Removed in Regina 7.0 — Normal (hyper)surfaces now hold their coordinates using a plain Vector<LargeInteger>, and use a NormalEncoding or HyperEncoding to indicate the coordinate system and other details of the vector representation.

PacketInfo<...>
Removed in Regina 7.0 PacketInfo (non-templated) Most of the old templated PacketInfo functionality is no longer necessary. The new non-templated class has just a single name() function, accessible at both compile time and runtime.

PDF Attachment This class now supports all kinds of file attachments (not just PDF documents).

Perm<4..7>::Code Perm<4..7>::Code1 This is an obsolete type of permutation code; you should rework your code to use second-generation codes instead.

Property<T>
Removed in Regina 7.0 std::optional<T> or std::unique_ptr<T>, depending on your storage policy

QitmaskLenN, for all N Qitmask1<uint8_t>, Qitmask1<uint16_t>, etc.

Ray Vector<LargeInteger>

Returns, ReturnsTraits
Removed in Regina 7.0 —

SafePtr, SafePointeeBase
Removed in Regina 7.0 — Now that the packet tree uses std::shared_ptr, these classes are unnecessary.

SatBlockStarter, SatBlockStarterSearcher, SatBlockStarterSet
Removed in Regina 7.0 SatRegion::find(), SatBlockModel The new routine SatRegion::find() is a simpler and more flexible replacement for the old SatBlockStarterSearcher infrastructure. Individual "model blocks" for starting a search now use SatBlockModel instead of SatBlockStarter.

SFSAltSet
Removed in Regina 7.0 SFSAlt This class has had a significant redesign (hence the rename). Instead of creating an SFSAltSet, call the static function SFSAlt::altSet().

SFSpace::classType SFSpace::ClassType

SigIsoList SigCensus::IsoList

SnapPeaException as a base class for other SnapPea-related exception types
Removed in Regina 7.0 — The subclasses SnapPeaFatalError and SnapPeaMemoryFull now derive from standard C++ exception types.

SurfaceFilter as a concrete class that accepts all surfaces
Removed in Regina 7.0 A default-constructed SurfaceFilterProperties SurfaceFilter is now an abstract base class, and you cannot instantiate it directly.

SurfaceFilterInfo<...>
Removed in Regina 7.0 The various virtual functions in SurfaceFilter

Triangulation<dim>::SimplexIterator,
Triangulation<dim>::VertexIterator, etc.
Removed in Regina 7.0 auto or decltype(...)

TritmaskN, for all N
Removed in Regina 7.0 These were not used at all, and did not support tritmasks of arbitrary length.

Vector<T>::Element Vector<T>::value_type

Member Routines

AbelianGroup::addTorsionElement(), AbelianGroup::addTorsionElements() AbelianGroup::addTorsion() The new addTorsion() is much faster than these old deprecated routines.

AngleStructure::rawVector() AngleStructure::vector()

AngleStructures::enumerate(), AngleStructures::enumerateTautDD() AngleStructures class constructor The new class constructor that performs this enumeration will not insert the new list into the packet tree, and will never start in a background thread.

Ban...::init()
Removed in Regina 7.0 Class constructors The linear programming "ban constraint" classes have been redesigned, and the tableaux is now passed to the class constructor instead of a separate init() function.

CensusHit::next()
Removed in Regina 7.0 — Census hits are now returned in a std::list, and so the next() function is no longer relevant.

DoubleDescription::enumerateExtremalRays()
Removed in Regina 7.0 DoubleDescription::enumerate()

Example<3>::poincareHomologySphere() Example<3>::poincare()

Face<dim, subdim>::buildLinkDetail()
Removed in Regina 7.0 Face<dim, subdim>::buildLinkInclusion() This returns only an isomorphism; you can use buildLink() to fetch the corresponding triangulated link. The labelling option has been removed completely.

FaceEmbedding<dim, subdim> constructor that takes (simplex, face number)
Removed in Regina 7.0 FaceEmbedding<dim, subdim> constructor that takes (simplex, embedding permutation) End users would typically not use these constructors, since FaceEmbedding objects are constructed for you as part of the triangulation skeleton.

FileInfo::type(), FileInfo::typeDescription()
Removed in Regina 7.0 FileFormat::format(), FileFormat::formatDescription() This change reflects the fact that Regina now supports more than one generation of XML file format.

GlobalDirs::pythonLibs()
Removed in Regina 7.0 — Nothing has been installed to this path since Regina 5.0.

GluingPerms<dim>::facetPairing() GluingPerms<dim>::pairing()

GluingPerms<dim>::gluingPerm() GluingPerms<dim>::perm()

GluingPerms<dim>::inputError() — The input stream constructor now throws an exception on error.

GluingPermSearcher<dim> enumeration functions
Redesigned in Regina 7.0 — The API for enumerating permutation sets has been significantly reorganised; see GluingPermSearcher<dim>::runSearch() for details.

GluingPermSearcher<dim> functions inherited from GluingPerms<dim>
Removed in Regina 7.0 — GluingPermSearcher<dim> no longer derives from GluingPerms<dim>. Instead, GluingPermSearcher<dim>::runSearch() will pass a GluingPerms<dim> reference to your callback function.

GluingPermSearcher<dim>::completePermSet() GluingPermSearcher<dim>::isComplete()

GluingPermSearcher<dim>::inputError() — The input stream constructor now throws an exception on error.

GluingPermSearcher<dim>::readTaggedData()
Removed in Regina 7.0 GluingPermSearcher<dim>::fromTaggedData() This function now throws an exception on error instead of returning null.

GroupExpression::addStringFirst(), GroupExpression::addStringLast() GroupExpression::addTermFirst(string), GroupExpression::addTermLast(string)

GroupExpression::toTeX() GroupExpression::tex()

GroupExpression::writeText() GroupExpression::writeTextShort(...)

GroupPresentation::intelligentSimplifyDetail(), GroupPresentation::smallCancellationDetail(), GroupPresentation::intelligentNielsenDetail(), GroupPresentation::homologicalAlignmentDetail(), GroupPresentation::prettyRewritingDetail() GroupPresentation::intelligentSimplify(), GroupPresentation::smallCancellation(), GroupPresentation::intelligentNielsen(), GroupPresentation::homologicalAlignment(), GroupPresentation::prettyRewriting() The "non-detail" versions of these functions now return a std::optional<HomGroupPresentation> instead of a bool.

GroupPresentation::toTeX() GroupPresentation::tex()

Handlebody::handles() Handlebody::genus()

Handlebody::isOrientable() — The Handlebody class now only represents orientable handlebodies, and so this routine always returns true.

HilbertCD::enumerateHilbertBasis(), HilbertDual::enumerateHilbertBasis(), HilbertPrimal::enumerateHilbertBasis()
Removed in Regina 7.0 HilbertCD::enumerate(), HilbertDual::enumerate(), HilbertPrimal::enumerate()

HomGroupPresentation::composeWith() Multiplication operator (g * h)

HomGroupPresentation::range()
Removed in Regina 7.0 HomGroupPresentation::codomain() The function has not changed; it has simply been renamed to more accurately reflect what it returns.

HomMarkedAbelianGroup::range()
Removed in Regina 7.0 HomMarkedAbelianGroup::codomain() The function has not changed; it has simply been renamed to more accurately reflect what it returns.

HomMarkedAbelianGroup::writeReducedMatrix() HomMarkedAbelianGroup::detail(), HomMarkedAbelianGroup::writeTextLong()

LayeredSolidTorus::formsLayeredSolidTorusBase(), LayeredSolidTorus::formsLayeredSolidTorusTop() LayeredSolidTorus::recogniseFromBase(), LayeredSolidTorus::recogniseFromTop()

Link::swapContents() Link::swap()

LPData<...>::dump(), LPMatrix<...>::dump() The usual Output routines: str(), detail(), etc.

LPInitialTableaux<...>::constraintsBroken()
Removed in Regina 7.0 — The LPInitialTableaux class constructor now throws an exception on such an error.

Manifold::homologyH1() Manifold::homology()

Manifold::TeXName() Manifold::texName()

MarkedAbelianGroup::equalTo() Equality operators (==, !=)

MarkedAbelianGroup::M(), MarkedAbelianGroup::N(), MarkedAbelianGroup::boundaryMap(), MarkedAbelianGroup::writeAsBoundary() MarkedAbelianGroup::m(), MarkedAbelianGroup::n(), MarkedAbelianGroup::boundaryOf(), MarkedAbelianGroup::asBoundary()

MarkedAbelianGroup::rankCC(), MarkedAbelianGroup::minNumberOfGenerators(), MarkedAbelianGroup::minNumberCycleGens() MarkedAbelianGroup::ccRank(), MarkedAbelianGroup::snfRank(), MarkedAbelianGroup::cycleRank()

Matrix<T>::initialise() Constructor that takes a list of entries The initialise() function was only ever available through Python, not C++.

Matrix<T>::swapColumns() Matrix<T>::swapCols()

Matrix<T>::writeMatrix() Matrix<T>::writeTextLong()

Matrix2::Matrix2(const long[2][2]) Matrix2::Matrix2(long, long, long, long)

Matrix2::operator =(const long[2][2]) matrix = Matrix2(a, b, c, d)

ModelLinkGraph::swapContents() ModelLinkGraph::swap()

NormalSurface::countCoords(), NormalHypersurface::countCoords()
Removed in Regina 7.0 surface.vector().size()

NormalSurface::orientedTriangles(), NormalSurface::orientedQuads(), NormalSurface::systemAllowsOriented()
Removed in Regina 7.0 — Regina 7.0 no longer supports transversely oriented normal surfaces; these will be reimplemented in a future release using a completely different suite of classes.

NormalSurface::sameSurface(), NormalHypersurface::sameSurface() Equality operators (==, !=)

NormalSurface::systemAllowsAlmostNormal(), NormalSurface::systemAllowsSpun()
Removed in Regina 7.0 NormalSurface::couldBeAlmostNormal(), NormalSurface::couldBeNonCompact()

NormalSurface::rawVector(), NormalSurface::writeRawVector(), NormalHypersurface::rawVector(), NormalHypersurface::writeRawVector() NormalSurface::vector(), NormalHypersurface::vector()

NormalSurfaces::allowsOriented() — Regina 7.0 no longer supports transversely oriented normal surfaces; these will be reimplemented in a future release using a completely different suite of classes.

NormalSurfaces::allowsSpun() NormalSurfaces::allowsNonCompact()

NormalSurfaces::enumerate(), NormalHypersurfaces::enumerate() NormalSurfaces and NormalHypersurfaces class constructors The class constructors throw exceptions on error instead of returning null, will not insert new lists into the packet tree, and will never start in a background thread.

NormalSurfaces::quadToStandard(), NormalSurfaces::quadOctToStandardAN(), NormalSurfaces::standardToQuad(), NormalSurfaces::standardANToQuadOct(), NormalSurfaces::filterForDisjointPairs(), NormalSurfaces::filterForLocallyCompatiblePairs(), NormalSurfaces::filterForPotentiallyIncompressible() NormalSurfaces class constructor that takes a NormalTransform argument The new class constructor will throw an exception on error instead of returning null, and will not insert the new list into the packet tree.

NormalSurfaces::writeAllSurfaces() NormalSurfaces::writeTextLong() or NormalSurfaces::detail()

Packet::clone()
Removed in Regina 7.0 Packet::cloneAsSibling() Renamed to emphasise that this function is not a plain copy operation, and might not succeed.

Packet::dependsOnParent(), Packet::isPacketEditable() — There are no longer any packet types that depend on their parents, and so these routines always return false and true respectively.

Packet::firstTreePacket(const std::string&), Packet::nextTreePacket(const std::string&)
Removed in Regina 7.0 Packet::firstTreePacket(PacketType), Packet::nextTreePacket(PacketType)

Packet::isGrandparentOf() Packet::isAncestorOf()

Packet::safeDelete()
Removed in Regina 7.0 — This is no longer required, since packets are managed exclusively by std::shared_ptr.

PacketListener::packetToBeDestroyed()
Marked final in Regina 7.0 to ensure it cannot be reimplemented PacketListener::packetBeingDestroyed() The rename emphasises the fact that this is called when the destructor is already in progress.

PacketListener::unregisterFromAllPackets() PacketListener::unlisten() —

PDF::savePDF() Attachment::save() —

Perm<n> constructor that takes one or two C-style arrays Perm<n> constructor that takes a std::array

Perm<n>::index(), Perm<n>::atIndex() Perm<n>::orderedSnIndex(), Perm<n>::orderedSn[] —

Perm<4..7>::permCode(), Perm<4..7>::setPermCode(), Perm<4..7>::fromPermCode(), Perm<4..7>::isPermCode() Perm<4..7>::permCode1(), Perm<4..7>::setPermCode1(), Perm<4..7>::fromPermCode1(), Perm<4..7>::isPermCode1() These functions use an obsolete type of permutation code; you should rework your code to use second-generation codes instead.

Perm<n>::preImageOf() Perm<n>::pre() —

Rational::doubleApproxCheck() Rational::doubleApprox() The doubleApprox() function now throws an exception if the rational is out of range.

Rational::TeX() Rational::tex()

SatAnnulus::attachLST() member function
Removed in Regina 7.0 SatAnnulus::attachLST() static function SatAnnulus now only allows const access to the triangulation, and so this has become a static function that takes additional non-const tetrahedron and permutation arguments.

SatBlock::nAnnuli() SatBlock::countAnnuli()

SatBlock::isBlock...(), SatBlock::clone() and copy constructors, from SatBlock as well as its subclasses
Removed in Regina 7.0 SatRegion::beginsRegion() SatBlock and its subclasses can only be created through larger recognition routines such as SatRegion::beginsRegion().

...::insertBlock(), from subclasses of SatBlock
Removed in Regina 7.0 ...::model() The relevant subclasses of SatBlock now have a new model() routine, which returns a SatBlockModel by value.

SatBlock::setAdjacent(), SatBlock::transform()
Removed in Regina 7.0 — SatBlock and its subclasses are now read-only.

SatBlockSpec constructors
Removed in Regina 7.0 — SatBlockSpec now only supports move and swap operations, due to its new ownership semantics.

SatRegion::expand()
Removed in Regina 7.0 — All publicly accessible functions that create a SatRegion will expand it automatically.

SatRegion::numberOfBlocks(), SatRegion::numberOfBoundaryAnnuli() SatRegion::countBlocks(), SatRegion::countBoundaryAnnuli()

SigCensus::run()
Removed in Regina 7.0 SigCensus::formCensus() You can no longer create a SigCensus manually; instead you must use the static formCensus() routine.

Signature::cycleCmp()
Removed in Regina 7.0 — This is now a private member function, since it was very specialised.

Signature::parse() The string-based Signature constructor Now throws an exception on error, instead of returning null.

SnapPeaTriangulation::filledTriangulation()
Removed in Regina 7.0 SnapPeaTriangulation::filledPartial() or SnapPeaTriangulation::filledAll() Instead of a polymorphic return type, these routines now have return types that are known precisely at compile time.

StandardTriangulation::homologyH1() StandardTriangulation::homology()

StandardTriangulation::TeXName() StandardTriangulation::texName()

Tangle::swapContents() Tangle::swap()

TreeDecomposition constructor that takes a C-style array of adjacencies Removed in Regina 7.0 Constructor that takes a Matrix<bool> or a std::vector of rows

TreeTraversal::constraintsBroken()
Removed in Regina 7.0 The class constructor now throws an exception in this scenario.

TreeTraversal::nVisited(),
TreeEnumeration::nSolns(),
TautEnumeration::nSolns()
Removed in Regina 7.0 TreeTraversal::visited(),
TreeEnumeration::solutions(),
TautEnumeration::solutions()

TreeTraversal::verify()
Removed in Regina 7.0 — Each variant of verify() just tested a single wmatrix multiplication, which you can perform yourself if necessary.

Triangulation<dim>::homologyH1(),
Triangulation<dim>::homologyH2() Triangulation<dim>::homology<1>(),
Triangulation<dim>::homology<2>() In Python, homology<k>() becomes homology(k). In both C++ and Python, homology() is an alias for homology<1>().

Triangulation<dim>::insertConstruction() Triangulation<dim>::fromGluings() The interface for fromGluings() is very different from insertConstruction(), but both have the same aim of allowing users to hard-code entire triangulations in code.

Triangulation<dim>::isIdenticalTo() a == b

Triangulation<dim>::splitIntoComponents()
Removed in Regina 7.0 Triangulation<dim>::triangulateComponents() The new triangulateComponents() routine does not create packets or interact with the packet tree at all.

Triangulation<dim>::swapContents() Triangulation<dim>::swap()

Triangulation<3>::connectedSumDecomposition()
Removed in Regina 7.0 Triangulation<3>::summands() The new summands() routine does not create packets or interact with the packet tree at all, and throws an exception on error.

Triangulation<3>::enterTextTriangulation() —

Triangulation<3>::findStrictAngleStructure() Triangulation<3>::hasStrictAngleStructure(),
Triangulation<3>::strictAngleStructure() Call strictAngleStructure() only when you already know a solution exist, since it will throw an exception otherwise. If you do not know whether a solution exists, call hasStrictAngleStructure() first.

Triangulation<3>::hasNonTrivialSphereOrDisc(),
Triangulation<3>::hasOctagonalAlmostNormalSphere() Triangulation<3>::nonTrivialSphereOrDisc,
Triangulation<3>::octagonalAlmostNormalSphere

Triangulation<3>::insertLayeredLoop(),
Triangulation<3>::insertLayeredLensSpace(),
Triangulation<3>::insertAugTriSolidTorus(),
Triangulation<3>::insertSFSOverSphere() Example<3>::layeredLoop(),
Example<3>::layeredLensSpace(),
Example<3>::augTriSolidTorus(),
Example<3>::sfsOverSphere() Combine with Triangulation<3>::insertTriangulation() if you need to insert one of these into an existing triangulation.

Triangulation<3>::insertRehydration() Triangulation<3>::rehydrate() Combine with Triangulation<3>::insertTriangulation() if you need to insert a rehydration into an existing triangulation.

Triangulation<3>::isThreeSphere(),
Triangulation<3>::knowsThreeSphere() Triangulation<3>::isSphere(),
Triangulation<3>::knowsSphere()

Triangulation<3>::makeZeroEfficient()
Removed in Regina 7.0 Triangulation<3>w::summands() The new summands() routine (which computes connected sum decompositions) now comes with formal guarantees of zero-efficiency.

TxICore::TeXName() TxICore::texName

Vector<T>::setElement() vector[i] = value

Vertex<3>::link()
Removed in Regina 7.0 Vertex<3>::linkType() This was removed because link() will be used for a different purpose in a future release.

Global Routines

allowsNonOrientableLinks(),
allowsInvalidFaces()
Removed in Regina 7.0 Class constants Face<dim, subdim>::allowsNonOrientableLinks, Face<dim, subdim>::allowsInvalidFaces

basicTokenise(output_iterator, string) basicTokenise(string) The tokens are now returned by value as a std::vector of strings.

clonePtr()
Removed in Regina 7.0 Class copy constructors

duplicate()
Removed in Regina 7.0 ::strdup()

forCoords(), forFilter(), forPacket(),
Removed in Regina 7.0 — The old type registries have been removed. Normal surfaces and hypersurfaces no longer have different subclasses for different coordinate systems; instead each surface or hypersurface stores a NormalEncoding or HyperEncoding. Most of the remaining registry functionality is still available through virtual functions and/or the redesigned PacketInfo, NormalInfo and HyperInfo classes.

formSigCensus()
Removed in Regina 7.0 SigCensus::formCensus The new function uses a typesafe template-based mechanism instead of function pointers and void* arguments.

makeZeroVector()
Removed in Regina 7.0 Class constructor Vector<T>(len)

readIsoSigList() readSigList<ObjectType>() Instead of passing a dimension at runtime, you should set the ObjectType template parameter to be Triangulation<dim> or Link.

valueOf(str, Integer&),
valueOf(str, LargeInteger&),
where str is a string integer = str Errors are detected via exceptions, instead of using a boolean return value.

Class Constants

BoolSet::sNone, BoolSet::sTrue, BoolSet::sFalse, BoolSet::sBoth BoolSet(), true, false, BoolSet(true, true)

DiscType::NONE DiscType()

FileInfo::TYPE_XML
Removed in Regina 7.0 REGINA_XML_GEN_1 or REGINA_XML_GEN_2, from the new FileFormat enum type This change reflects the fact that Regina now supports more than one generation of XML file format.

GluingPermSearcher<dim>::dataTag_ (also in subclasses)
Removed in Regina 7.0 ...::dataTag

Perm<n>::invSk
Removed in Regina 7.0 Perm<k>::inverse() For those k that had inverse lookup tables, the inverse() functions are just as fast.

Vector<T>::zero,
Vector<T>::one,
Vector<T>::minusOne 0, 1, -1

Global Constants

NS_FILTER_DEFAULT
Removed in Regina 7.0 NS_FILTER_LEGACY_DEFAULT The corresponding class SurfaceFilter is now an abstract base class, and can no longer be instantiated directly.

PACKET_PDF PACKET_ATTACHMENT

triDiscArcs(i,j),
quadDiscArcs(i,j),
octDiscArcs(i,j)
Old syntax removed in Regina 7.0 triDiscArcs[i][j],
quadDiscArcs[i][j],
octDiscArcs[i][j] These are now arrays, not macros, and so the syntax has changed.
Only affects C++, not Python.

Deprecated code	Replacement	Comments
Headers
`file/xml*.h` Removed in Regina 7.0	—	All low-level XML parsing code is now private to Regina's engine, and so these XML parsing headers are no longer installed. The only public access to Regina's XML parsing code is via `regina::open()`.
`surfaces/*.h`	`surface/*.h`	Renamed to match `angle/.h` and `hypersurface/.h`, which also use the singular (not the plural).
`triangulation/homologicaldata.h` Removed in Regina 7.0	`triangulation/dim3/homologicaldata.h`
`hypersurface/hscoordregistry.h`, `hypersurface/hscoordregistry-impl.h`, `packet/packetregistry.h`, `packet/packetregistry-impl.h`, `surfaces/coordregistry.h`, `surfaces/coordregistry-impl.h`, `surfaces/filterregistry.h`, `surfaces/filterregistry-impl.h` Removed in Regina 7.0	—	The old type registries have been removed. Normal surfaces and hypersurfaces no longer have different subclasses for different coordinate systems; instead each surface or hypersurface stores a `NormalEncoding` or `HyperEncoding`. Most of the remaining registry functionality is still available through virtual functions and/or the redesigned `PacketInfo`, `NormalInfo` and `HyperInfo` classes.
`utilities/memutils.h`, `utilities/property.h`, `utilities/ptrutils.h`, `utilities/registryutils.h` Removed in Regina 7.0	—	Since the move to C++17, these utilities have either become unnecessary or been replaced with simpler alternatives.
Classes, Enums and Type Aliases
`AngleStructureVector` Removed in Regina 7.0	—	Angle structures now hold their coordinates using a plain `Vector<Integer>`.
`BitmaskLenN`, for all `N`	`Bitmask1<uint8_t>, Bitmask1<uint16_t>, etc.`
`CensusHits`, `CensusHitIterator` Removed in Regina 7.0	`std::list<CensusHit>`, `std::list<CensusHit>::const_iterator`
`DiscSetTetData<T>::DataPtr`	`DiscSetTetData<T>::Data*`
`EnumConstraints` Removed in Regina 7.0	`ValidityConstraints`	This class has been completely redesigned (hence the rename); you will need to read the `ValidityConstraints` documentation before using it.
`FuncDelete`, `FuncNew`, `FuncNewCopyPtr`, `FuncNewCopyRef`, `FuncNewCopyClonePtr` Removed in Regina 7.0	—	C++ provides good alternatives for these nowadays.
`GluingPermSearcher<3>::PurgeFlags`	`regina::CensusPurge`, `regina::CensusPurgeFlags`
`Handlebody` (non-orientable case) Removed in Regina 7.0	—	The `Handlebody` class now only represents orientable handlebodies, since the non-orientable case was never fully implemented.
`HasReturnType` Removed in Regina 7.0	—
`HyperInfo<coords>` Removed in Regina 7.0	`HyperInfo` (non-templated)	Most of the old templated `HyperInfo` functionality is now accessible through `HyperEncoding(coords)`. The new non-templated `HyperInfo` class just has some descriptive name functions, accessible at both compile time and runtime.
`L31Pillow` Removed in Regina 7.0	`TrivialTri`	The old `L31Pillow` is now one of the many ad-hoc cases handled by `TrivialTri`.
`LessDeref` Removed in Regina 7.0	—	Just use a lambda if you need to.
`LightweightSequence<T>::Less` Removed in Regina 7.0	—
`LightweightSequence<T>::SubsequenceCompareFirstPtr` Removed in Regina 7.0	`LightweightSequence<T>::SubsequenceCompareFirst`	This inner class has been significantly redesigned, and now works with containers whose keys are sequences (not pointers to sequences).
`ListOnCall` Removed in Regina 7.0	—	This class was not thread-safe, and did not add anything non-trivial.
`LPConstraint...::Coefficients` Removed in Regina 7.0	—	The interface for describing linear programming constraints has changed significantly. Typical users should not be affected, but do read the API docs if you are writing constraint classes of your own.
`LPConstraintEuler`	`LPConstraintEulerPositive`
`Matrix<T>::Coefficient`	`Matrix<T>::value_type`
`NewFunction` Removed in Regina 7.0	—
`NNativeLong`	`NativeLong`
`NormalInfo<coords>` Removed in Regina 7.0	`NormalInfo` (non-templated)	Most of the old templated `NormalInfo` functionality is now accessible through `NormalEncoding(coords)`. The new non-templated `NormalInfo` class just has some descriptive name functions, accessible at both compile time and runtime.
`NormalSurfaceVector`, `NormalHypersurfaceVector` and subclasses Removed in Regina 7.0	—	Normal (hyper)surfaces now hold their coordinates using a plain `Vector<LargeInteger>`, and use a `NormalEncoding` or `HyperEncoding` to indicate the coordinate system and other details of the vector representation.
`PacketInfo<...>` Removed in Regina 7.0	`PacketInfo` (non-templated)	Most of the old templated `PacketInfo` functionality is no longer necessary. The new non-templated class has just a single `name()` function, accessible at both compile time and runtime.
`PDF`	`Attachment`	This class now supports all kinds of file attachments (not just PDF documents).
`Perm<4..7>::Code`	`Perm<4..7>::Code1`	This is an obsolete type of permutation code; you should rework your code to use second-generation codes instead.
`Property<T>` Removed in Regina 7.0	`std::optional<T>` or `std::unique_ptr<T>`, depending on your storage policy
`QitmaskLenN`, for all `N`	`Qitmask1<uint8_t>, Qitmask1<uint16_t>, etc.`
`Ray`	`Vector<LargeInteger>`
`Returns`, `ReturnsTraits` Removed in Regina 7.0	—
`SafePtr`, `SafePointeeBase` Removed in Regina 7.0	—	Now that the packet tree uses `std::shared_ptr`, these classes are unnecessary.
`SatBlockStarter`, `SatBlockStarterSearcher`, `SatBlockStarterSet` Removed in Regina 7.0	`SatRegion::find()`, `SatBlockModel`	The new routine `SatRegion::find()` is a simpler and more flexible replacement for the old `SatBlockStarterSearcher` infrastructure. Individual "model blocks" for starting a search now use `SatBlockModel` instead of `SatBlockStarter`.
`SFSAltSet` Removed in Regina 7.0	`SFSAlt`	This class has had a significant redesign (hence the rename). Instead of creating an `SFSAltSet`, call the static function `SFSAlt::altSet()`.
`SFSpace::classType`	`SFSpace::ClassType`
`SigIsoList`	`SigCensus::IsoList`
`SnapPeaException` as a base class for other SnapPea-related exception types Removed in Regina 7.0	—	The subclasses `SnapPeaFatalError` and `SnapPeaMemoryFull` now derive from standard C++ exception types.
`SurfaceFilter` as a concrete class that accepts all surfaces Removed in Regina 7.0	A default-constructed `SurfaceFilterProperties`	`SurfaceFilter` is now an abstract base class, and you cannot instantiate it directly.
`SurfaceFilterInfo<...>` Removed in Regina 7.0	The various virtual functions in `SurfaceFilter`
`Triangulation<dim>::SimplexIterator`, `Triangulation<dim>::VertexIterator`, etc. Removed in Regina 7.0	`auto` or `decltype(...)`
`TritmaskN`, for all `N` Removed in Regina 7.0		These were not used at all, and did not support tritmasks of arbitrary length.
`Vector<T>::Element`	`Vector<T>::value_type`
Member Routines
`AbelianGroup::addTorsionElement()`, `AbelianGroup::addTorsionElements()`	`AbelianGroup::addTorsion()`	The new `addTorsion()` is much faster than these old deprecated routines.
`AngleStructure::rawVector()`	`AngleStructure::vector()`
`AngleStructures::enumerate()`, `AngleStructures::enumerateTautDD()`	`AngleStructures` class constructor	The new class constructor that performs this enumeration will not insert the new list into the packet tree, and will never start in a background thread.
`Ban...::init()` Removed in Regina 7.0	Class constructors	The linear programming "ban constraint" classes have been redesigned, and the tableaux is now passed to the class constructor instead of a separate `init()` function.
`CensusHit::next()` Removed in Regina 7.0	—	Census hits are now returned in a `std::list`, and so the `next()` function is no longer relevant.
`DoubleDescription::enumerateExtremalRays()` Removed in Regina 7.0	`DoubleDescription::enumerate()`
`Example<3>::poincareHomologySphere()`	`Example<3>::poincare()`
`Face<dim, subdim>::buildLinkDetail()` Removed in Regina 7.0	`Face<dim, subdim>::buildLinkInclusion()`	This returns only an isomorphism; you can use `buildLink()` to fetch the corresponding triangulated link. The labelling option has been removed completely.
`FaceEmbedding<dim, subdim>` constructor that takes (simplex, face number) Removed in Regina 7.0	`FaceEmbedding<dim, subdim>` constructor that takes (simplex, embedding permutation)	End users would typically not use these constructors, since `FaceEmbedding` objects are constructed for you as part of the triangulation skeleton.
`FileInfo::type()`, `FileInfo::typeDescription()` Removed in Regina 7.0	`FileFormat::format()`, `FileFormat::formatDescription()`	This change reflects the fact that Regina now supports more than one generation of XML file format.
`GlobalDirs::pythonLibs()` Removed in Regina 7.0	—	Nothing has been installed to this path since Regina 5.0.
`GluingPerms<dim>::facetPairing()`	`GluingPerms<dim>::pairing()`
`GluingPerms<dim>::gluingPerm()`	`GluingPerms<dim>::perm()`
`GluingPerms<dim>::inputError()`	—	The input stream constructor now throws an exception on error.
`GluingPermSearcher<dim>` enumeration functions Redesigned in Regina 7.0	—	The API for enumerating permutation sets has been significantly reorganised; see `GluingPermSearcher<dim>::runSearch()` for details.
`GluingPermSearcher<dim>` functions inherited from `GluingPerms<dim>` Removed in Regina 7.0	—	`GluingPermSearcher<dim>` no longer derives from `GluingPerms<dim>`. Instead, `GluingPermSearcher<dim>::runSearch()` will pass a `GluingPerms<dim>` reference to your callback function.
`GluingPermSearcher<dim>::completePermSet()`	`GluingPermSearcher<dim>::isComplete()`
`GluingPermSearcher<dim>::inputError()`	—	The input stream constructor now throws an exception on error.
`GluingPermSearcher<dim>::readTaggedData()` Removed in Regina 7.0	`GluingPermSearcher<dim>::fromTaggedData()`	This function now throws an exception on error instead of returning `null`.
`GroupExpression::addStringFirst()`, `GroupExpression::addStringLast()`	`GroupExpression::addTermFirst(string)`, `GroupExpression::addTermLast(string)`
`GroupExpression::toTeX()`	`GroupExpression::tex()`
`GroupExpression::writeText()`	`GroupExpression::writeTextShort(...)`
`GroupPresentation::intelligentSimplifyDetail()`, `GroupPresentation::smallCancellationDetail()`, `GroupPresentation::intelligentNielsenDetail()`, `GroupPresentation::homologicalAlignmentDetail()`, `GroupPresentation::prettyRewritingDetail()`	`GroupPresentation::intelligentSimplify()`, `GroupPresentation::smallCancellation()`, `GroupPresentation::intelligentNielsen()`, `GroupPresentation::homologicalAlignment()`, `GroupPresentation::prettyRewriting()`	The "non-detail" versions of these functions now return a `std::optional<HomGroupPresentation>` instead of a `bool`.
`GroupPresentation::toTeX()`	`GroupPresentation::tex()`
`Handlebody::handles()`	`Handlebody::genus()`
`Handlebody::isOrientable()`	—	The `Handlebody` class now only represents orientable handlebodies, and so this routine always returns `true`.
`HilbertCD::enumerateHilbertBasis()`, `HilbertDual::enumerateHilbertBasis()`, `HilbertPrimal::enumerateHilbertBasis()` Removed in Regina 7.0	`HilbertCD::enumerate()`, `HilbertDual::enumerate()`, `HilbertPrimal::enumerate()`
`HomGroupPresentation::composeWith()`	Multiplication operator (`g * h`)
`HomGroupPresentation::range()` Removed in Regina 7.0	`HomGroupPresentation::codomain()`	The function has not changed; it has simply been renamed to more accurately reflect what it returns.
`HomMarkedAbelianGroup::range()` Removed in Regina 7.0	`HomMarkedAbelianGroup::codomain()`	The function has not changed; it has simply been renamed to more accurately reflect what it returns.
`HomMarkedAbelianGroup::writeReducedMatrix()`	`HomMarkedAbelianGroup::detail()`, `HomMarkedAbelianGroup::writeTextLong()`
`LayeredSolidTorus::formsLayeredSolidTorusBase()`, `LayeredSolidTorus::formsLayeredSolidTorusTop()`	`LayeredSolidTorus::recogniseFromBase()`, `LayeredSolidTorus::recogniseFromTop()`
`Link::swapContents()`	`Link::swap()`
`LPData<...>::dump()`, `LPMatrix<...>::dump()`	The usual `Output` routines: `str()`, `detail()`, etc.
`LPInitialTableaux<...>::constraintsBroken()` Removed in Regina 7.0	—	The `LPInitialTableaux` class constructor now throws an exception on such an error.
`Manifold::homologyH1()`	`Manifold::homology()`
`Manifold::TeXName()`	`Manifold::texName()`
`MarkedAbelianGroup::equalTo()`	Equality operators (`==`, `!=`)
`MarkedAbelianGroup::M()`, `MarkedAbelianGroup::N()`, `MarkedAbelianGroup::boundaryMap()`, `MarkedAbelianGroup::writeAsBoundary()`	`MarkedAbelianGroup::m()`, `MarkedAbelianGroup::n()`, `MarkedAbelianGroup::boundaryOf()`, `MarkedAbelianGroup::asBoundary()`
`MarkedAbelianGroup::rankCC()`, `MarkedAbelianGroup::minNumberOfGenerators()`, `MarkedAbelianGroup::minNumberCycleGens()`	`MarkedAbelianGroup::ccRank()`, `MarkedAbelianGroup::snfRank()`, `MarkedAbelianGroup::cycleRank()`
`Matrix<T>::initialise()`	Constructor that takes a list of entries	The `initialise()` function was only ever available through Python, not C++.
`Matrix<T>::swapColumns()`	`Matrix<T>::swapCols()`
`Matrix<T>::writeMatrix()`	`Matrix<T>::writeTextLong()`
`Matrix2::Matrix2(const long[2][2])`	`Matrix2::Matrix2(long, long, long, long)`
`Matrix2::operator =(const long[2][2])`	`matrix = Matrix2(a, b, c, d)`
`ModelLinkGraph::swapContents()`	`ModelLinkGraph::swap()`
`NormalSurface::countCoords()`, `NormalHypersurface::countCoords()` Removed in Regina 7.0	`surface.vector().size()`
`NormalSurface::orientedTriangles()`, `NormalSurface::orientedQuads()`, `NormalSurface::systemAllowsOriented()` Removed in Regina 7.0	—	Regina 7.0 no longer supports transversely oriented normal surfaces; these will be reimplemented in a future release using a completely different suite of classes.
`NormalSurface::sameSurface()`, `NormalHypersurface::sameSurface()`	Equality operators (`==`, `!=`)
`NormalSurface::systemAllowsAlmostNormal()`, `NormalSurface::systemAllowsSpun()` Removed in Regina 7.0	`NormalSurface::couldBeAlmostNormal()`, `NormalSurface::couldBeNonCompact()`
`NormalSurface::rawVector()`, `NormalSurface::writeRawVector()`, `NormalHypersurface::rawVector()`, `NormalHypersurface::writeRawVector()`	`NormalSurface::vector()`, `NormalHypersurface::vector()`
`NormalSurfaces::allowsOriented()`	—	Regina 7.0 no longer supports transversely oriented normal surfaces; these will be reimplemented in a future release using a completely different suite of classes.
`NormalSurfaces::allowsSpun()`	`NormalSurfaces::allowsNonCompact()`
`NormalSurfaces::enumerate()`, `NormalHypersurfaces::enumerate()`	`NormalSurfaces` and `NormalHypersurfaces` class constructors	The class constructors throw exceptions on error instead of returning `null`, will not insert new lists into the packet tree, and will never start in a background thread.
`NormalSurfaces::quadToStandard()`, `NormalSurfaces::quadOctToStandardAN()`, `NormalSurfaces::standardToQuad()`, `NormalSurfaces::standardANToQuadOct()`, `NormalSurfaces::filterForDisjointPairs()`, `NormalSurfaces::filterForLocallyCompatiblePairs()`, `NormalSurfaces::filterForPotentiallyIncompressible()`	`NormalSurfaces` class constructor that takes a `NormalTransform` argument	The new class constructor will throw an exception on error instead of returning `null`, and will not insert the new list into the packet tree.
`NormalSurfaces::writeAllSurfaces()`	`NormalSurfaces::writeTextLong()` or `NormalSurfaces::detail()`
`Packet::clone()` Removed in Regina 7.0	`Packet::cloneAsSibling()`	Renamed to emphasise that this function is not a plain copy operation, and might not succeed.
`Packet::dependsOnParent()`, `Packet::isPacketEditable()`	—	There are no longer any packet types that depend on their parents, and so these routines always return `false` and `true` respectively.
`Packet::firstTreePacket(const std::string&)`, `Packet::nextTreePacket(const std::string&)` Removed in Regina 7.0	`Packet::firstTreePacket(PacketType)`, `Packet::nextTreePacket(PacketType)`
`Packet::isGrandparentOf()`	`Packet::isAncestorOf()`
`Packet::safeDelete()` Removed in Regina 7.0	—	This is no longer required, since packets are managed exclusively by `std::shared_ptr`.
`PacketListener::packetToBeDestroyed()` Marked `final` in Regina 7.0 to ensure it cannot be reimplemented	`PacketListener::packetBeingDestroyed()`	The rename emphasises the fact that this is called when the destructor is already in progress.
`PacketListener::unregisterFromAllPackets()`	`PacketListener::unlisten()`	—
`PDF::savePDF()`	`Attachment::save()`	—
`Perm<n>` constructor that takes one or two C-style arrays	`Perm<n>` constructor that takes a `std::array`
`Perm<n>::index()`, `Perm<n>::atIndex()`	`Perm<n>::orderedSnIndex()`, `Perm<n>::orderedSn[]`	—
`Perm<4..7>::permCode()`, `Perm<4..7>::setPermCode()`, `Perm<4..7>::fromPermCode()`, `Perm<4..7>::isPermCode()`	`Perm<4..7>::permCode1()`, `Perm<4..7>::setPermCode1()`, `Perm<4..7>::fromPermCode1()`, `Perm<4..7>::isPermCode1()`	These functions use an obsolete type of permutation code; you should rework your code to use second-generation codes instead.
`Perm<n>::preImageOf()`	`Perm<n>::pre()`	—
`Rational::doubleApproxCheck()`	`Rational::doubleApprox()`	The `doubleApprox()` function now throws an exception if the rational is out of range.
`Rational::TeX()`	`Rational::tex()`
`SatAnnulus::attachLST()` member function Removed in Regina 7.0	`SatAnnulus::attachLST()` static function	`SatAnnulus` now only allows const access to the triangulation, and so this has become a static function that takes additional non-const tetrahedron and permutation arguments.
`SatBlock::nAnnuli()`	`SatBlock::countAnnuli()`
`SatBlock::isBlock...()`, `SatBlock::clone()` and copy constructors, from `SatBlock` as well as its subclasses Removed in Regina 7.0	`SatRegion::beginsRegion()`	`SatBlock` and its subclasses can only be created through larger recognition routines such as `SatRegion::beginsRegion()`.
`...::insertBlock()`, from subclasses of `SatBlock` Removed in Regina 7.0	`...::model()`	The relevant subclasses of `SatBlock` now have a new `model()` routine, which returns a `SatBlockModel` by value.
`SatBlock::setAdjacent()`, `SatBlock::transform()` Removed in Regina 7.0	—	`SatBlock` and its subclasses are now read-only.
`SatBlockSpec` constructors Removed in Regina 7.0	—	`SatBlockSpec` now only supports move and swap operations, due to its new ownership semantics.
`SatRegion::expand()` Removed in Regina 7.0	—	All publicly accessible functions that create a `SatRegion` will expand it automatically.
`SatRegion::numberOfBlocks()`, `SatRegion::numberOfBoundaryAnnuli()`	`SatRegion::countBlocks()`, `SatRegion::countBoundaryAnnuli()`
`SigCensus::run()` Removed in Regina 7.0	`SigCensus::formCensus()`	You can no longer create a `SigCensus` manually; instead you must use the static `formCensus()` routine.
`Signature::cycleCmp()` Removed in Regina 7.0	—	This is now a private member function, since it was very specialised.
`Signature::parse()`	The string-based `Signature` constructor	Now throws an exception on error, instead of returning `null`.
`SnapPeaTriangulation::filledTriangulation()` Removed in Regina 7.0	`SnapPeaTriangulation::filledPartial()` or `SnapPeaTriangulation::filledAll()`	Instead of a polymorphic return type, these routines now have return types that are known precisely at compile time.
`StandardTriangulation::homologyH1()`	`StandardTriangulation::homology()`
`StandardTriangulation::TeXName()`	`StandardTriangulation::texName()`
`Tangle::swapContents()`	`Tangle::swap()`
`TreeDecomposition constructor that takes a C-style array of adjacencies Removed in Regina 7.0`	Constructor that takes a `Matrix<bool>` or a `std::vector` of rows
`TreeTraversal::constraintsBroken()` Removed in Regina 7.0	The class constructor now throws an exception in this scenario.
`TreeTraversal::nVisited()`, `TreeEnumeration::nSolns()`, `TautEnumeration::nSolns()` Removed in Regina 7.0	`TreeTraversal::visited()`, `TreeEnumeration::solutions()`, `TautEnumeration::solutions()`
`TreeTraversal::verify()` Removed in Regina 7.0	—	Each variant of `verify()` just tested a single wmatrix multiplication, which you can perform yourself if necessary.
`Triangulation<dim>::homologyH1()`, `Triangulation<dim>::homologyH2()`	`Triangulation<dim>::homology<1>()`, `Triangulation<dim>::homology<2>()`	In Python, `homology<k>()` becomes `homology(k)`. In both C++ and Python, `homology()` is an alias for `homology<1>()`.
`Triangulation<dim>::insertConstruction()`	`Triangulation<dim>::fromGluings()`	The interface for `fromGluings()` is very different from `insertConstruction()`, but both have the same aim of allowing users to hard-code entire triangulations in code.
`Triangulation<dim>::isIdenticalTo()`	`a == b`
`Triangulation<dim>::splitIntoComponents()` Removed in Regina 7.0	`Triangulation<dim>::triangulateComponents()`	The new `triangulateComponents()` routine does not create packets or interact with the packet tree at all.
`Triangulation<dim>::swapContents()`	`Triangulation<dim>::swap()`
`Triangulation<3>::connectedSumDecomposition()` Removed in Regina 7.0	`Triangulation<3>::summands()`	The new `summands()` routine does not create packets or interact with the packet tree at all, and throws an exception on error.
`Triangulation<3>::enterTextTriangulation()`	—
`Triangulation<3>::findStrictAngleStructure()`	`Triangulation<3>::hasStrictAngleStructure()`, `Triangulation<3>::strictAngleStructure()`	Call `strictAngleStructure()` only when you already know a solution exist, since it will throw an exception otherwise. If you do not know whether a solution exists, call `hasStrictAngleStructure()` first.
`Triangulation<3>::hasNonTrivialSphereOrDisc()`, `Triangulation<3>::hasOctagonalAlmostNormalSphere()`	`Triangulation<3>::nonTrivialSphereOrDisc`, `Triangulation<3>::octagonalAlmostNormalSphere`
`Triangulation<3>::insertLayeredLoop()`, `Triangulation<3>::insertLayeredLensSpace()`, `Triangulation<3>::insertAugTriSolidTorus()`, `Triangulation<3>::insertSFSOverSphere()`	`Example<3>::layeredLoop()`, `Example<3>::layeredLensSpace()`, `Example<3>::augTriSolidTorus()`, `Example<3>::sfsOverSphere()`	Combine with `Triangulation<3>::insertTriangulation()` if you need to insert one of these into an existing triangulation.
`Triangulation<3>::insertRehydration()`	`Triangulation<3>::rehydrate()`	Combine with `Triangulation<3>::insertTriangulation()` if you need to insert a rehydration into an existing triangulation.
`Triangulation<3>::isThreeSphere()`, `Triangulation<3>::knowsThreeSphere()`	`Triangulation<3>::isSphere()`, `Triangulation<3>::knowsSphere()`
`Triangulation<3>::makeZeroEfficient()` Removed in Regina 7.0	`Triangulation<3>w::summands()`	The new `summands()` routine (which computes connected sum decompositions) now comes with formal guarantees of zero-efficiency.
`TxICore::TeXName()`	`TxICore::texName`
`Vector<T>::setElement()`	`vector[i] = value`
`Vertex<3>::link()` Removed in Regina 7.0	`Vertex<3>::linkType()`	This was removed because `link()` will be used for a different purpose in a future release.
Global Routines
`allowsNonOrientableLinks()`, `allowsInvalidFaces()` Removed in Regina 7.0	Class constants `Face<dim, subdim>::allowsNonOrientableLinks`, `Face<dim, subdim>::allowsInvalidFaces`
`basicTokenise(output_iterator, string)`	`basicTokenise(string)`	The tokens are now returned by value as a `std::vector` of strings.
`clonePtr()` Removed in Regina 7.0	Class copy constructors
`duplicate()` Removed in Regina 7.0	`::strdup()`
`forCoords()`, `forFilter()`, `forPacket()`, Removed in Regina 7.0	—	The old type registries have been removed. Normal surfaces and hypersurfaces no longer have different subclasses for different coordinate systems; instead each surface or hypersurface stores a `NormalEncoding` or `HyperEncoding`. Most of the remaining registry functionality is still available through virtual functions and/or the redesigned `PacketInfo`, `NormalInfo` and `HyperInfo` classes.
`formSigCensus()` Removed in Regina 7.0	`SigCensus::formCensus`	The new function uses a typesafe template-based mechanism instead of function pointers and `void*` arguments.
`makeZeroVector()` Removed in Regina 7.0	Class constructor `Vector<T>(len)`
`readIsoSigList()`	`readSigList<ObjectType>()`	Instead of passing a dimension at runtime, you should set the `ObjectType` template parameter to be `Triangulation<dim>` or `Link`.
`valueOf(str, Integer&)`, `valueOf(str, LargeInteger&)`, where `str` is a string	`integer = str`	Errors are detected via exceptions, instead of using a boolean return value.
Class Constants
`BoolSet::sNone`, `BoolSet::sTrue`, `BoolSet::sFalse`, `BoolSet::sBoth`	`BoolSet()`, `true`, `false`, `BoolSet(true, true)`
`DiscType::NONE`	`DiscType()`
`FileInfo::TYPE_XML` Removed in Regina 7.0	`REGINA_XML_GEN_1` or `REGINA_XML_GEN_2`, from the new `FileFormat` enum type	This change reflects the fact that Regina now supports more than one generation of XML file format.
`GluingPermSearcher<dim>::dataTag_` (also in subclasses) Removed in Regina 7.0	`...::dataTag`
`Perm<n>::invSk` Removed in Regina 7.0	`Perm<k>::inverse()`	For those k that had inverse lookup tables, the `inverse()` functions are just as fast.
`Vector<T>::zero`, `Vector<T>::one`, `Vector<T>::minusOne`	`0`, `1`, `-1`
Global Constants
`NS_FILTER_DEFAULT` Removed in Regina 7.0	`NS_FILTER_LEGACY_DEFAULT`	The corresponding class `SurfaceFilter` is now an abstract base class, and can no longer be instantiated directly.
`PACKET_PDF`	`PACKET_ATTACHMENT`
`triDiscArcs(i,j)`, `quadDiscArcs(i,j)`, `octDiscArcs(i,j)` Old syntax removed in Regina 7.0	`triDiscArcs[i][j]`, `quadDiscArcs[i][j]`, `octDiscArcs[i][j]`	These are now arrays, not macros, and so the syntax has changed. Only affects C++, not Python.

Back to main page ...