+/**
+ * \ingroup gdcmObject
+ * \brief Set the 'boundaries' gdcmObject (gdcmDicomDirPatient,
+ * gdcmDicomDirStudy, gdcmDicomDirSerie, gdcmDicomDirImage)
+ * comming for the parsing of a DICOMDIR file
+ * \warning NOT en user intended function
+ * @param flag = 0 when META to be dealt with
+ */
+void gdcmObject::ResetBoundaries(int flag) {
+
+ if (flag) { // it's NOT a META
+ // upwards to fffe,e000
+ for( i=j=debut();
+ ((*i)->GetGroup() != 0xfffe) && ((*i)->GetElement() != 0xe000);
+ --i,j--) {
+ }
+ beginObj=j;
+ }
+
+ // upwards again to fffe,e000
+ if (fin()== (--(plistEntries->end())) ) // Don't try anything more when end
+ return; // of Chained List is reached
+
+ for( i=j=fin();
+ ((*i)->GetGroup() != 0xfffe) && ((*i)->GetElement() != 0xe000);
+ --i,j--) {
+ }
+ j--;
+ endObj=j;
+}
+
+/**
+ * \brief Sets Entry (Dicom Element) value of an element,
+ * specified by it's tag (Group, Number)
+ * and the length, too ...
+ * If the Element is not found, it's just created !
+ * \warning we suppose, right now, the element belongs to a Public Group
+ * (NOT a shadow one)
+ * @param val string value to set
+ * @param group Group of the searched tag.
+ * @param element Element of the searched tag.
+ * @return true if element was found or created successfully
+ */
+ bool gdcmObject::SetEntryByNumber(std::string val,guint16 group,
+ guint16 element) {
+
+ for(ListTag::iterator i=beginObj;;++i) {
+ if ( (*i)->GetGroup() == 0xfffe && (*i)->GetElement() == 0xe000 )
+ continue;
+ if ( group < (*i)->GetGroup() ||
+ (group == (*i)->GetGroup() && element < (*i)->GetElement()) ){
+ // instead of ReplaceOrCreateByNumber
+ // that is a method of gdcmParser :-(
+ gdcmHeaderEntry *Entry;
+ TagKey key = gdcmDictEntry::TranslateToKey(group, element);
+ if ( ! ptagHT->count(key)) {
+ // we assume a Public Dictionnary *is* loaded
+ gdcmDict *PubDict = gdcmGlobal::GetDicts()->GetDefaultPubDict();
+ // if the invoked (group,elem) doesn't exist inside the Dictionary
+ // we create a VirtualDictEntry
+ gdcmDictEntry *DictEntry = PubDict->GetDictEntryByNumber(group, element);
+ if (DictEntry == NULL) {
+ DictEntry=gdcmGlobal::GetDicts()->NewVirtualDictEntry(group,element,"UN","??","??");
+ }
+ // we assume the constructor didn't fail
+ Entry = new gdcmHeaderEntry(DictEntry);
+ /// \todo
+ /// ----
+ /// better we don't assume too much !
+ /// in the next release, gdcmObject will be used
+ /// to describe any Header Entry ...
+ } else {
+ Entry = ptagHT->find(key)->second;
+ }
+ Entry->SetValue(val);
+ Entry->SetLength(val.length());
+ plistEntries->insert(i,Entry);
+ return true;
+ }
+ if (group == (*i)->GetGroup() && element == (*i)->GetElement() ) {
+ (*i)->SetValue(val);
+ (*i)->SetLength(val.length());
+ return true;
+ }
+ }
+}
+/**
+ * \ingroup gdcmObject
+ * \brief Builds a hash table (multimap) containing
+ * pointers to all Header Entries (i.e Dicom Element)
+ * related to this 'object'
+ * @return
+ */
+TagHeaderEntryHT gdcmObject::GetEntry(void) {
+ TagHeaderEntryHT HT;
+ for(ListTag::iterator i=beginObj;;++i) {
+ HT.insert( PairHT( (*i)->GetKey(),(*i)) );
+ if (i == endObj) break;
+ }
+ return(HT);
+}
+
+/**
+ * \ingroup gdcmObject
+ * \brief Builds a Chained List containing
+ * pointers to all Header Entries (i.e Dicom Element)
+ * related to this 'object'
+ * @return
+ */
+ListTag gdcmObject::GetListEntry(void) {
+ ListTag list;
+ for(ListTag::iterator i=beginObj;;++i) {
+ list.push_back(*i);
+ if (i == endObj) break;
+ }
+ return(list);
+}
+
+