Program: gdcm
Module: $RCSfile: gdcmDocEntryArchive.cxx,v $
Language: C++
- Date: $Date: 2005/02/01 10:29:55 $
- Version: $Revision: 1.11 $
+ Date: $Date: 2005/02/21 17:47:19 $
+ Version: $Revision: 1.13 $
Copyright (c) CREATIS (Centre de Recherche et d'Applications en Traitement de
l'Image). All rights reserved. See Doc/License.txt or
//-----------------------------------------------------------------------------
// Public
/**
- * \brief Replace in the Header a DocEntry by the new DocEntry. The last
- * DocEntry is kept in archive
+ * \brief Replaces in the Header a DocEntry by the new DocEntry.
+ * The initial DocEntry is kept in archive.
* @param newEntry New entry to substitute to an other entry of the Header
- * @return FALSE when an other DocEntry is already archived with the same
- * generalized key, TRUE otherwise
+ * @return FALSE when an other DocEntry is already archived with the same key
+ * TRUE otherwise
*/
bool DocEntryArchive::Push(DocEntry *newEntry)
{
return false;
uint16_t group = newEntry->GetDictEntry()->GetGroup();
- uint16_t elem = newEntry->GetDictEntry()->GetElement();
+ uint16_t elem = newEntry->GetDictEntry()->GetElement();
std::string key = DictEntry::TranslateToKey(group,elem);
if( Archive.find(key)==Archive.end() )
{
// Save the old DocEntry if any
- DocEntry *old = ArchFile->GetDocEntry(group,elem);
- Archive[key] = old;
+ DocEntry *old = ArchFile->GetDocEntry(group, elem);
+ Archive[key] = old;
if( old )
ArchFile->RemoveEntryNoDestroy(old);
}
/**
- * \brief Replace in the Header a DocEntry by the new DocEntry. The last
- * DocEntry is kept in archive
- * @param group Group number of the Entry
- * @param elem Element number of the Entry
- * @return FALSE when an other DocEntry is already archived with the same
- * generalized key, TRUE otherwise
+ * \brief Removes out of the Header a DocEntry.
+ * It's kept in archive.
+ * @param group Group number of the Entry to remove
+ * @param elem Element number of the Entry to remove
+ * @return FALSE when an other DocEntry is already archived with the same key
+ * TRUE otherwise
*/
-bool DocEntryArchive::Push(uint16_t group,uint16_t elem)
+bool DocEntryArchive::Push(uint16_t group, uint16_t elem)
{
- std::string key = DictEntry::TranslateToKey(group,elem);
+ std::string key = DictEntry::TranslateToKey(group, elem);
if( Archive.find(key)==Archive.end() )
{
// Save the old DocEntry if any
- DocEntry *old = ArchFile->GetDocEntry(group,elem);
+ DocEntry *old = ArchFile->GetDocEntry(group, elem);
Archive[key] = old;
if( old )
ArchFile->RemoveEntryNoDestroy(old);
}
/**
- * \brief Restore in the Header the DocEntry that have the generalized key.
- * The old entry is destroyed.
- * @param group Group number of the Entry
- * @param elem Element number of the Entry
- * @return FALSE when the generalized key isn't in the archive,
+ * \brief Restore in the Header the DocEntry specified by (group,element).
+ * The archive entry is destroyed.
+ * @param group Group number of the Entry to restore
+ * @param elem Element number of the Entry to restore
+ * @return FALSE when the key isn't in the archive,
* TRUE otherwise
*/
-bool DocEntryArchive::Restore(uint16_t group,uint16_t elem)
+bool DocEntryArchive::Restore(uint16_t group, uint16_t elem)
{
- std::string key=DictEntry::TranslateToKey(group,elem);
+ std::string key=DictEntry::TranslateToKey(group, elem);
TagDocEntryHT::iterator restoreIt=Archive.find(key);
if( restoreIt!=Archive.end() )
{
// Delete the new value
- DocEntry *rem = ArchFile->GetDocEntry(group,elem);
+ DocEntry *rem = ArchFile->GetDocEntry(group, elem);
if( rem )
ArchFile->RemoveEntry(rem);
}
/**
- * \brief Remove all DocEntry that are in the archive.
- * The entries aren't restored but only destroyed.
+ * \brief Removes all DocEntry from the archive, and destroy them.
+ * The archives entries aren't restored.
*/
void DocEntryArchive::ClearArchive( )
{