Regina Calculation Engine
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 (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::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::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.
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.

Copyright © 1999-2011, The Regina development team
This software is released under the GNU General Public License.
For further information, or to submit a bug or other problem, please contact Ben Burton (bab@debian.org).