Deprecated List

File hashmap.h

Everything related to the hash_set and hash_map classes is deprecated, since these classes are not part of the C++ standard. This material is scheduled to be removed from Regina in version 5.0.

File hashset.h

Everything related to the hash_set and hash_map classes is deprecated, since these classes are not part of the C++ standard. This material is scheduled to be removed from Regina in version 5.0.

File hashutils.h

Everything related to the hash_set and hash_map classes is deprecated, since these classes are not part of the C++ standard. This material is scheduled to be removed from Regina in version 5.0.

File nfile.h

The preferred way of representing data is using XML which is accessed using text I/O streams. See file nxmlfile.h for XML routines corresponding to the old-style binary file routines declared in this header.

File nfilepropertyreader.h

The preferred way of storing data is using XML which is accessed via text I/O streams. New-style XML data files should simply bundle object properties in with the standard XML read/write routines.

File nresources.h

The preferred way of representing data is using XML which is accessed using text I/O streams.

Member regina::AcceptTriangulation )(NTriangulation *, void *)

This global typedef is now deprecated. Please use the identical class typedef NCensus::AcceptTriangulation instead.

Member regina::allPermsS2

This array has been moved into the NPerm4 class, and can now be accessed as the static array NPerm4::S2. The deprecated name regina::allPermsS2 now just points to NPerm4::S2, and will be removed in some future version of Regina.

Member regina::allPermsS2Inv

This array has been moved into the NPerm4 class, and can now be accessed as the static array NPerm4::invS2. The deprecated name regina::allPermsS2Inv now just points to NPerm4::invS2, and will be removed in some future version of Regina.

Member regina::allPermsS3

This array has been moved into the NPerm4 class, and can now be accessed as the static array NPerm4::S3. The deprecated name regina::allPermsS4 now just points to NPerm4::S3, and will be removed in some future version of Regina.

Member regina::allPermsS3Inv

This array has been moved into the NPerm4 class, and can now be accessed as the static array NPerm4::invS3. The deprecated name regina::allPermsS3Inv now just points to NPerm4::invS3, and will be removed in some future version of Regina.

Member regina::allPermsS4

This array has been moved into the NPerm4 class, and can now be accessed as the static array NPerm4::S4. The deprecated name regina::allPermsS4 now just points to NPerm4::S4, and will be removed in some future version of Regina.

Member regina::allPermsS4Inv

This array has been moved into the NPerm4 class, and can now be accessed as the static array NPerm4::invS4. The deprecated name regina::allPermsS4Inv now just points to NPerm4::invS4, and will be removed in some future version of Regina.

Member regina::edgeDescription (int edge)

This routine is no longer recommended, and will be removed in some future version of Regina. Please use NEdge::ordering[edge].trunc2() (which gives identical results).

Member regina::edgeDescription (const NPerm4 &edgePerm)

This routine is no longer recommended, and will be removed in some future version of Regina. Please use NPerm4::trunc2() instead (which gives identical results).

Member regina::edgeEnd [6]

This array has been superceded by NEdge::edgeVertex (where edgeEnd[i] is now NEdge::edgeVertex[i][1]). Users are advised to switch to NEdge::edgeVertex instead, since the old regina::edgeStart and regina::edgeEnd will eventually be removed in some future version of Regina.

Member regina::edgeNumber [4][4]

This array has been replaced with the identical array NEdge::edgeNumber. Users are advised to switch to NEdge::edgeNumber instead, since the old regina::edgeNumber will eventually be removed in some future version of Regina.

Member regina::edgeOrdering (int edge)

This routine is no longer recommended, and will be removed in some future version of Regina. Please use the lookup table NEdge::ordering instead (which gives identical results).

Member regina::edgeStart [6]

This array has been superceded by NEdge::edgeVertex (where edgeStart[i] is now NEdge::edgeVertex[i][0]). Users are advised to switch to NEdge::edgeVertex instead, since the old regina::edgeStart and regina::edgeEnd will eventually be removed in some future version of Regina.

Member regina::faceDescription (const NPerm4 &facePerm)

This routine is no longer recommended, and will be removed in some future version of Regina. Please use NPerm4::trunc3() instead (which gives identical results).

Member regina::faceDescription (int face)

This routine is no longer recommended, and will be removed in some future version of Regina. Please use NFace::ordering[face].trunc3() (which gives identical results).

Member regina::faceOrdering (int face)

This routine is no longer recommended, and will be removed in some future version of Regina. Please use the lookup table NFace::ordering instead (which gives identical results).

Member regina::factorise (unsigned long n, std::list< unsigned long > &factors)

This routine is old and slow; please consider using the much faster routines from the NPrimes class instead.

Class regina::HashPointer

Everything related to the hash_set and hash_map classes is deprecated, since these classes are not part of the C++ standard. This material is scheduled to be removed from Regina in version 5.0.

Class regina::HashString

Everything related to the hash_set and hash_map classes is deprecated, since these classes are not part of the C++ standard. This material is scheduled to be removed from Regina in version 5.0.

Member regina::NAbelianGroup::readFromFile (NFile &in)

For the preferred way of reading abelian groups from file, see class NXMLAbelianGroupReader instead.

Member regina::NAbelianGroup::writeToFile (NFile &out) const

For the preferred way to write data to file, see writeXMLData() instead.

Member regina::NAngleStructure::readFromFile (NFile &in, NTriangulation *triangulation)

For the preferred way of reading angle structures from file, see class NXMLAngleStructureReader instead.

Member regina::NAngleStructure::writeToFile (NFile &out) const

For the preferred way to write data to file, see writeXMLData() instead.

Member regina::NAngleStructureList::allowsStrict () const

This routine will be removed in a future version of Regina. Users should switch to the identical routine spansStrict() instead.

Member regina::NAngleStructureList::allowsTaut () const

This routine will be removed in a future version of Regina. Users should switch to the identical routine spansTaut() instead.

Member regina::NDoubleDescriptor

As of Regina 4.6, the class NDoubleDescriptor has been renamed as NDoubleDescription. This renaming is merely for consistency in documentation and nomenclature; the functionality of the new NDoubleDescription class is identical to the old NDoubleDescriptor class as it was in Regina 4.5.1. This typedef is provided for backward compatibility, and will be removed in some future version of Regina.

Member regina::NExampleTriangulation::seifertWeber ()

This routine is now called weberSeifert(), for consistency with Weber and Seifert's original paper. The old name seifertWeber() has been kept for backward compatibility, but will be removed in a future version of Regina.

Class regina::NFile

The preferred way of representing data is using XML which is accessed using text I/O streams.

Class regina::NFilePropertyReader

This class is only for use with old-style binary data files. New-style XML data files should simply bundle object properties in with the standard XML read/write routines.

Member regina::NGroupExpression::readFromFile (NFile &in)

For the preferred way of reading group presentations from file, see class NXMLGroupPresentationReader instead.

Member regina::NGroupExpression::writeToFile (NFile &out) const

For the preferred way to write data to file, see writeXMLData() instead.

Member regina::NGroupExpressionTerm::readFromFile (NFile &in)

For the preferred way of reading group presentations from file, see class NXMLGroupPresentationReader instead.

Member regina::NGroupExpressionTerm::writeToFile (NFile &out) const

For the preferred way to write data to file, see NGroupExpression::writeXMLData() instead.

Member regina::NGroupPresentation::readFromFile (NFile &in)

For the preferred way of reading group presentations from file, see class NXMLGroupPresentationReader instead.

Member regina::NGroupPresentation::writeToFile (NFile &out) const

For the preferred way to write data to file, see writeXMLData() instead.

Member regina::NHomMarkedAbelianGroup::isIso () const

This routine will be removed in a future version of Regina; please use the identical routine isIsomorphism() instead.

Class regina::NHomologicalData

This class will be removed in Regina 5.0. A new and more flexible class called NCellularData will take its place.

Class regina::NIndexedArray< Data, HashFcn, EqualTo >

Like everything else that relies on the non-standard STL/g++ extension classes hash_set and hash_map, NIndexedArray is scheduled to be removed from Regina in version 5.0. For a replacement, NMarkedVector does a similar job and is smaller and faster, though it requires modification of the data types stored in the array.

Class regina::NIsomorphismDirect

All of the functionality that NIsomorphismDirect used to provide in old versions of Regina has now been moved into the parent class NIsomorphism. The NIsomorphismDirect class is now an empty subclass of NIsomorphism, provided for backward compatibility only, and should not be used in new applications. This class will be removed from Regina in the near future.

Member regina::NLayeredLoop::getIndex () const

The preferred way of accessing the length of a layered loop is through getLength().

Class regina::NLocalFileResource

The preferred way of representing data is using XML which is accessed using text I/O streams.

Member regina::NMarkedAbelianGroup::getFreeLoc () const

This routine will be removed in Regina 5.0.

Member regina::NMarkedAbelianGroup::getMCB () const

This routine will be removed in Regina 5.0.

Member regina::NMarkedAbelianGroup::getMCBi () const

This routine will be removed in Regina 5.0.

Member regina::NMarkedAbelianGroup::getMRB () const

This routine will be removed in Regina 5.0.

Member regina::NMarkedAbelianGroup::getMRBi () const

This routine will be removed in Regina 5.0.

Member regina::NMarkedAbelianGroup::getNCB () const

This routine will be removed in Regina 5.0.

Member regina::NMarkedAbelianGroup::getNCBi () const

This routine will be removed in Regina 5.0.

Member regina::NMarkedAbelianGroup::getNRB () const

This routine will be removed in Regina 5.0.

Member regina::NMarkedAbelianGroup::getNRBi () const

This routine will be removed in Regina 5.0.

Member regina::NMarkedAbelianGroup::getRankM () const

This routine will be removed in Regina 5.0.

Member regina::NMarkedAbelianGroup::getSNFIsoRep (const std::vector< NLargeInteger > &v) const

This routine has been renamed to snfRep(). See snfRep() for details, preconditions and warnings.

Member regina::NMarkedAbelianGroup::getTorsionLoc () const

This routine will be removed in Regina 5.0.

Member regina::NMarkedAbelianGroup::operator== (const NMarkedAbelianGroup &other) const

This routine will be removed in a future version of Regina. Users should switch to the less ambiguously named routine isIsomorphicTo() instead.

Member regina::NNormalSurface::readFromFile (NFile &in, int flavour, NTriangulation *triangulation)

For the preferred way to read surfaces from file, see class NXMLNormalSurfaceReader instead.

Member regina::NNormalSurface::writeToFile (NFile &out) const

For the preferred way to write data to file, see writeXMLData() instead.

Member regina::NPacket::ChangeEventBlock

ChangeEventSpan is now the correct way to fire a "packet changed" event. The class ChangeEventSpan is similar to the old ChangeEventBlock except that it fires both NPacketListener::packetToBeChanged() and NPacketListener::packetWasChanged() (on construction and destruction respectively), and the old boolean argument fireOnDestruction is gone (events are now fired always).

Member regina::NPacket::readPacket (NFile &in, NPacket *parent)

For the preferred way to read packets from file, see getXMLReader() and class NXMLPacketReader instead.

Member regina::NPacket::writePacket (NFile &out) const

For the preferred way to write packets to file, see writeXMLFile() and writeXMLPacketData() instead.

Member regina::NPerm

As of Regina 4.6.1, the class NPerm has been renamed as NPerm4 (which has identical functionality). This NPerm typedef is provided for backward compatibility, and will be removed in some future version of Regina.

Member regina::NPerm4::setPerm (int a, int b)

This routine is largely unnecessary, since NPerm4 objects are tiny and cheap. Just use the assignment operator instead. This routine will eventually be removed entirely in a future version of Regina.

Member regina::NPerm4::setPerm (int a, int b, int c, int d)

This routine is largely unnecessary, since NPerm4 objects are tiny and cheap. Just use the assignment operator instead. This routine will eventually be removed entirely in a future version of Regina.

Class regina::NPermItS4

This class will removed in a future release of Regina, since it is completely unnecessary. Just loop directly through the 24 elements of NPerm4::S4.

Class regina::NRandomAccessResource

The preferred way of representing data is using XML which is accessed using text I/O streams.

Member regina::NSurfaceFilter::readFilter (NFile &in, NPacket *parent)

For the preferred way to read filters from file, see getXMLFilterReader() and class NXMLFilterReader instead.

Member regina::NSurfaceFilter::writeFilter (NFile &out) const

For the preferred way to write data to file, see writeXMLFilterData() instead.

Member regina::NSurfaceFilter::writeProperties (NFile &out) const

For the preferred way to write data to file, see writeXMLFilterData() instead.

Member regina::NTetFace

For the 3-dimensional class NTetFace, the old field names tet and face are deprecated. Please use the new (generic) names simp and facet instead. The old names are no longer supported in C++, but will continue to be supported in Python until Regina 5.0.

Member regina::NTetrahedron::getAdjacentFace (int face) const

This routine will eventually be removed in some future version of Regina. Users are advised to use adjacentFace() instead, which is an identical routine with a shorter name.

Member regina::NTetrahedron::getAdjacentTetrahedron (int face) const

This routine will eventually be removed in some future version of Regina. Users are advised to use adjacentTetrahedron() instead, which is an identical routine with a shorter name.

Member regina::NTetrahedron::getAdjacentTetrahedronGluing (int face) const

This routine will eventually be removed in some future version of Regina. Users are advised to use adjacentGluing() instead, which is an identical routine with a shorter name.

Member regina::NTetrahedron::NTetrahedron ()

Users should now create new tetrahedra by calling NTriangulation::newTetrahedron(). For details, see the changes in tetrahedron management outlined in the NTetrahedron class notes.

Member regina::NTetrahedron::NTetrahedron (const std::string &desc)

Users should now create new tetrahedra by calling NTriangulation::newTetrahedron(const std::string&). For details, see the changes in tetrahedron management outlined in the NTetrahedron class notes.

Member regina::NTriangulation::addTetrahedron (NTetrahedron *tet)

Users should create tetrahedra by calling newTetrahedron() or newTetrahedron(const std::string&), which will add the tetrahedron to the triangulation automatically.

Member regina::NTriangulation::getBoundaryComponentIndex (const NBoundaryComponent *bc) const

As of Regina 4.5, this is now a slow linear time routine (a consequence of some significant memory optimisations). The alternative boundaryComponentIndex() is fast, but insists that bc belongs to the triangulation. This slower routine will be removed at some point in the future.

Member regina::NTriangulation::getComponentIndex (const NComponent *component) const

As of Regina 4.5, this is now a slow linear time routine (a consequence of some significant memory optimisations). The alternative componentIndex() is fast, but insists that component belongs to the triangulation. This slower routine will be removed at some point in the future.

Member regina::NTriangulation::getEdgeIndex (const NEdge *edge) const

As of Regina 4.5, this is now a slow linear time routine (a consequence of some significant memory optimisations). The alternative edgeIndex() is fast, but insists that edge belongs to the triangulation. This slower routine will be removed at some point in the future.

Member regina::NTriangulation::getEulerCharacteristic () const

This routine will be removed in a future version of Regina. Please use getEulerCharTri() instead.

Member regina::NTriangulation::getFaceIndex (const NFace *face) const

As of Regina 4.5, this is now a slow linear time routine (a consequence of some significant memory optimisations). The alternative faceIndex() is fast, but insists that face belongs to the triangulation. This slower routine will be removed at some point in the future.

Member regina::NTriangulation::getTetrahedronIndex (const NTetrahedron *tet) const

As of Regina 4.5, this is now a slow linear time routine (a consequence of some significant memory optimisations). The alternative tetrahedronIndex() is fast, but insists that tet belongs to the triangulation. This slower routine will be removed at some point in the future.

Member regina::NTriangulation::getVertexIndex (const NVertex *vertex) const

As of Regina 4.5, this is now a slow linear time routine (a consequence of some significant memory optimisations). The alternative vertexIndex() is fast, but insists that vertex belongs to the triangulation. This slower routine will be removed at some point in the future.

Member regina::NTriangulation::gluingsHaveChanged ()

In Regina versions 4.6 and earlier, this routine was used to manually notify the triangulation that the gluings of tetrahedra had changed. In Regina 4.90 and later this notification is automatic. This routine now does nothing at all, and can safely be removed from any existing code.

Member regina::NTriangulation::maximalForestInBoundary (stdhash::hash_set< NEdge *, HashPointer > &edgeSet, stdhash::hash_set< NVertex *, HashPointer > &vertexSet) const

In Regina 5.0, this routine will be changed to use std::set instead of stdhash::hash_set. This is part of the broader plan to remove any need for the non-standard hash_set and hash_map.

Member regina::NTriangulation::maximalForestInDualSkeleton (stdhash::hash_set< NFace *, HashPointer > &faceSet) const

In Regina 5.0, this routine will be changed to use std::set instead of stdhash::hash_set. This is part of the broader plan to remove any need for the non-standard hash_set and hash_map.

Member regina::NTriangulation::maximalForestInSkeleton (stdhash::hash_set< NEdge *, HashPointer > &edgeSet, bool canJoinBoundaries=true) const

In Regina 5.0, this routine will be changed to use std::set instead of stdhash::hash_set. This is part of the broader plan to remove any need for the non-standard hash_set and hash_map.

Class regina::NTriBool

NTriBool has now been replaced with native (two-way) bool throughout Regina, and will be removed in some future release.

Member regina::orderedPermsS3

This array has been moved into the NPerm4 class, and can now be accessed as the static array NPerm4::orderedS3. The deprecated name regina::orderedPermsS3 now just points to NPerm4::orderedS3, and will be removed in some future version of Regina.

Member regina::orderedPermsS4

This array has been moved into the NPerm4 class, and can now be accessed as the static array NPerm4::orderedS4. The deprecated name regina::orderedPermsS4 now just points to NPerm4::orderedS4, and will be removed in some future version of Regina.

Member regina::primesUpTo (const NLargeInteger &roof, std::list< NLargeInteger > &primes)

This routine is old and slow; please consider using the much faster routines from the NPrimes class instead.

Member regina::readFromFile (const char *fileName)

The preferred way of representing data is using XML which is accessed using text I/O streams. See routines readXMLFile() and readFileMagic() for corresponding XML all-at-once read routines.

Member regina::writeToFile (const char *fileName, NPacket *packet)

The preferred way of representing data is using XML which is accessed using text I/O streams. See routine writeXMLFile() for a corresponding XML all-at-once write routine.

Namespace stdhash

Everything related to the hash_set and hash_map classes is deprecated, since these classes are not part of the C++ standard. This material is scheduled to be removed from Regina in version 5.0.