STW TC1 - Page 257

7 Teleservice Application Framework
User Manual 257/374
7.3.12.10 utils_search_first_value
Function Description
sint32 utils_search_first_value (FILE * opt_File, const charn * const opcn_SearchString, charn *
opcn_ValueTarget, const uint32 ou32_ValueTargetBufferSize)
The function searches for the string opcn_SearchString, from the beginning in the file opt_File. If
opcn_SearchString is located in the file, the rest of the line is copied into opcn_ValueTarget. The maximal
length of opcn_ValueTarget is defined by ou32_ValueTargetBufferSize in byte.
Information Flow
Input Information
Parameter
Range
Description
opt_File
FILE
pointing to file in that the search sting must be
searched
opcn_SearchString
pointer to the search string
opcn_ValueTarget
pointer to the value string
opcn_ValueTargetBufferSize
pointer to the buffer size of the value
Output Information
Return Value
Description
C_NO_ERR
Function executed without error, the search string is found and the value is written
to the buffer
C_UNKNOWN_ERR
No search string was found, the buffer is too small or can not allocate the buffer
7.3.12.11 utils_search_next_value
Function Description
sint32 utils_search_next_value (FILE * opt_File, charn const * const opcn_SearchString, const
charn * opcn_ValueTarget, const uint32 ou32_ValueTargetBufferSize)
The function searches for the string opcn_SearchString from the current file pointer position in file opt_File. If
opcn_SearchString is located in the file, the rest of the line is copied into opcn_ValueTarget. The maximum
length of opcn_ValueTarget is defined by ou32_ValueTargetBufferSize in byte.
Information Flow
Input Information
Parameter
Range
Description
opt_File
FILE
pointing to file in that the search sting must be
searched