respAdd3StateValue()

This procedure adds 3-State value for existing field. Procedure converts input 3-State value (text) into JSON true/false/null values then store it as field value. The input value is converted using several converson patterns.

ParameterTypeDescription
ptrPOINTERMandatoryPointer to field
Value10AMandatoryInput 3-State value (text)
pattern10I 0Optionalconversion pattern

Following input boolean values are supported:

  • ’true'
  • ‘false’
  • ’null'
  • ‘Y’
  • ‘N’
  • *BLANK
  • ‘1’
  • ‘0’

Following conversion patterns are sypported:

  • #true_false_null (default)
  • #Y_N_BLANK
  • #1_0_BLANK

The procedure returns pointer of field. If procedure can’t add value, then returns null.

Examples:

xxPtr = respAddField('data': 'freeOfCharge');
respAdd3StateValue(xxPtr: 'true');
respAdd3StateValue(xxPtr: 'false');
respAdd3StateValue(xxPtr: 'null');
respAdd3StateValue(xxPtr: 'true': #true_false_null);
respAdd3StateValue(xxPtr: 'false': #true_false_null);
respAdd3StateValue(xxPtr: 'null': #true_false_null);
respAdd3StateValue(xxPtr: 'Y': #Y_N_BLANK);
respAdd3StateValue(xxPtr: 'N': #Y_N_BLANK);
respAdd3StateValue(xxPtr: *BLANK: #Y_N_BLANK);
respAdd3StateValue(xxPtr: '0': #1_0_BLANK);
respAdd3StateValue(xxPtr: '1': #1_0_BLANK);
respAdd3StateValue(xxPtr: *BLANK: #1_0_BLANK);
respAdd3StateValue(xxPtr: XXFOCC: #Y_N_BLANK);