19.4.7. Looking Up List Values

The USER: data arriving at the CFX-Solver may be interpreted either as a single value, or as a list of values separated by commas. If there is only a single value, the following utilities regard this as a list that is one item long.

Each individual value of a list may be looked-up as data of type CHARACTER, DOUBLE PRECISION, LOGICAL, INTEGER or REAL by calling the appropriate utility and specifying the position of the item in the list.

      CALL USER_PEEKCA(
     & CDANAM, JADRES, CVALUE, CERACT, CRESLT, CZ )
      CALL USER_PEEKD(
     & CDANAM, JADRES, DVALUE, CERACT, CRESLT, CZ )
      CALL USER_PEEKL(
     & CDANAM, JADRES, DVALUE, CERACT, CRESLT, CZ )
      CALL USER_PEEKI(
     & CDANAM, JADRES, IVALUE, CERACT, CRESLT, CZ )
      CALL USER_PEEKR(
     & CDANAM, JADRES, RVALUE, CERACT, CRESLT, CZ )

Input arguments:

  • CHARACTER*(*) CDANAM - name of parameter.

  • INTEGER JADRES - parameter list index, for example, 1 for a simple value or for the first value in the list.

  • CHARACTER*4 CERACT - error action.

    • STOP to stop on error.

    • SKIP to continue silently.

    • WARN to continue after warning.

  • CHARACTER*1(*) CZ - solver stack for CHARACTER data.

Output arguments:

  • CHARACTER*(*) CVALUE - value of string parameter.

  • DOUBLE PRECISION DVALUE - value of double precision parameter.

  • LOGICAL LVALUE - value of logical parameter.

  • INTEGER IVALUE - value of integer parameter.

  • REAL RVALUE - value of real parameter.

  • CHARACTER*4 CRESLT - result code.

    • GOOD if successful.

    • ADRS if JADRES is out of bounds.