L_DicomGetFirstCodedConcept

#include "ltdic.h"

L_LTDIC_API pDICOMCODEDCONCEPT L_DicomGetFirstCodedConcept(pContextGroup)

/* pointer to a Context Group */

Returns a pointer to the first Coded Concept in the specified Context Group.

Parameter	Description
pContextGroup	Pointer to a DICOMCONTEXTGROUP structure that specifies a Context Group in the Context Group Table. The function returns a pointer to the first Coded Concept in this Group, if it contains any.

Returns

!NULL	Pointer to a DICOMCODEDCONCEPT structure that specifies the first Coded Concept in the specified Context Group.
NULL	The specified Context Group does not contain any Coded Concepts.

Comments

Along with this function, the following functions can be used to maneuver through the Coded Concepts of a Context Group in the Context Group Table:

L_DicomGetLastCodedConcept

L_DicomGetNextCodedConcept

L_DicomGetPrevCodedConcept

You can also use the L_DicomGetCountCodedConcept and L_DicomFindIndexCodedConcept functions to enumerate the Coded Concepts.

Use the L_DicomGetCodedConceptGroup function to determine which Context Group contains a specific Coded Concept.

Required DLLs and Libraries

LTDIC

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application

See Also

Functions:	L_DicomLoadContextGroup, L_DicomInsertContextGroup, L_DicomGetLastCodedConcept, L_DicomGetNextCodedConcept, L_DicomGetPrevCodedConcept, L_DicomGetCountCodedConcept, L_DicomFindIndexCodedConcept, L_DicomGetCodedConceptGroup, L_DicomSetCodedConceptCodeMeaning, L_DicomDeleteCodedConcept, L_DicomGetFirstContextGroup
Topics:	Working with Context Groups

Example

L_INT DicomGetFirstCodedConceptExample(pDICOMCONTEXTGROUP pGroup)
{
   pDICOMCODEDCONCEPT pConcept;
   L_INT nRet;

   // Is it a valid pointer? 
   if (!L_DicomExistsContextGroup (pGroup)) 
      return DICOM_ERROR_NULL_PTR;

   // Enumerate the Coded Concepts in the Context Group (3 possible ways) 
#if 1

   // One possible way to enumerate the Coded Concepts
   pConcept = L_DicomGetFirstCodedConcept(pGroup); 
   while (pConcept) 
   {
      // Refer to the example of L_DicomGetCodedConceptGroup for
      // the function DicomGetCodedConceptGroupExample
      nRet = DicomGetCodedConceptGroupExample(pConcept, TRUE);
      if (nRet != SUCCESS)
         break;

      pConcept = L_DicomGetNextCodedConcept (pConcept); 
   }

#elif 0
   
   // Another way to enumerate the Coded Concepts
   uConceptsCount = L_DicomGetCountCodedConcept (pGroup); 
   for (i = 0; i < uConceptsCount; i++)
   {
      pConcept = L_DicomFindIndexCodedConcept (pGroup, i); 
      nRet = DicomGetCodedConceptGroupExample(pConcept, TRUE);
      if (nRet != SUCCESS)
         break;
   }

#elif 0

   // A third way to enumerate the Coded Concepts
   pConcept = L_DicomGetLastCodedConcept (pGroup); 
   while (pConcept) 
   {
      nRet = DicomGetCodedConceptGroupExample(pConcept, TRUE);
      if (nRet != SUCCESS)
         break;

      pConcept = L_DicomGetPrevCodedConcept (pConcept); 
   }
#endif
   return DICOM_SUCCESS;
}