In This Topic ▼

L_DicomSetConvertValue

Summary

Converts a string and sets the value of an element. Items in the string are separated by a '\'.

Syntax

#include "Ltdic.h"

L_LTDIC_API L_BOOL L_DicomSetConvertValue(hDS, pElement, strText, nCount)

Parameters

HDICOMDS hDS

A DICOM handle.

pDICOMELEMENT pElement

Pointer to a DICOMELEMENT structure within the Data Set.

L_TCHAR *strText

Character string that contains the string to be converted to 1 or more values.

L_UINT32 nCount

Number of values in strText.

Returns

Value	Meaning
TRUE	The function completed successfully.
FALSE	The function did not complete successfully.

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

Platforms

Win32, x64, Linux.

Example

This example sets the value of an element

L_INT DicomSetConvertValueExample(L_VOID) 
{ 
   HDICOMDS       hDS; 
   pDICOMELEMENT  pElement; 
 
   hDS = L_DicomCreateDS(NULL); 
 
   L_DicomInitDS(hDS, CLASS_NM_IMAGE_STORAGE, 0);  
 
   pElement = L_DicomFindFirstElement(hDS, NULL, TAG_STUDY_DATE, FALSE); 
   if (!L_DicomSetConvertValue(hDS, pElement, TEXT("01/02/1999"), 1)) 
   { 
      L_DicomFreeDS(hDS); 
      return FAILURE - 1; 
   } 
 
   pElement = L_DicomFindFirstElement(hDS, NULL, TAG_IMAGE_TYPE, FALSE); 
   if (!L_DicomSetConvertValue(hDS, pElement, TEXT("DERIVED\\PRIMARY"), 2)) 
   { 
      L_DicomFreeDS(hDS); 
      return FAILURE - 1; 
   } 
 
   pElement = L_DicomFindFirstElement(hDS, NULL, TAG_IMAGE_POSITION_PATIENT, FALSE); 
   if (!L_DicomSetConvertValue(hDS, pElement, TEXT("0.123\\0.456\\1.789"), 3)) 
   { 
      L_DicomFreeDS(hDS); 
      return FAILURE - 1; 
   } 
 
   L_DicomFreeDS(hDS); 
   return DICOM_SUCCESS; 
}