Table of Contents

Search

  1. Preface
  2. Part 1: On-Prem Operations
  3. Part 2: Parameter and Element Reference
  4. Appendix A: Geocode Countries
  5. Appendix B: Reverse Geocoding Coverage
  6. Appendix C: Certified Mode Values

On-Premises Developer Guide

On-Premises Developer Guide

Retrieving Optional Properties

Retrieving Optional Properties

The IDVE_IsValuePresent() function identifies any optional JSON property that has no default value in a JSON schema document. For example, if you want to know if the error log has been disabled because of an error, you can call IDVE_IsValuePresent() on the URI "
State/IDVEInformation/ErrorLog/ErrorCode
". You can use this function call to check for the presence of optional properties in a JSON document.
If you call the IDVE_IsValuePresent() function on a non-optional property, the function returns
true
as output.

Example: The IDVE_IsValuePresent() function

The following sample code shows the structure of the IDVE_IsValuePresent() function:
IDVE_EXPORTCALL1 IDVE_StatusCode IDVE_EXPORTCALL2
IDVE_IsValuePresent
( const char* const kpksCustomerID, const char* const kpksURI, IDVE_Bool* const kbValue, char* const kpsExtStatusMsg );
The following table shows the parameter definitions for the IDVE_IsValuePresent() function:
Parameter
Operation
Comment
const char* const kpksCustomerID
[in]
Pointer to the zero-terminated 7-bit ASCII-encoded customer ID. The value might not be NULL.
const char* const kpksURI
[in]
Pointer to the zero-terminated 7-bit ASCII URI, for example "
AV/v1/Jobs/###/IO/Outputs/0/Results/0/Variants/0/AddressElements/AdministrativeDivision
". The value might not be NULL.
IDVE_Bool* const kbValue
[out]
Pointer to a boolean value to be retrieved by the function call. If the pointer is not NULL, it indicates if the value at the given URI is present or not.
char* const kpsExtStatusMsg
[out]
Pointer to a buffer of size IDVE_EXT_STATUS_MSG_BUFFER_SIZE for an optional extended status message. The value can be NULL.

0 COMMENTS

We’d like to hear from you!