# DEVOUTPICT()

Displays a value to a device using a picture template

Syntax

  DEVOUTPICT( <xExp>, <cPicture>, [<cColorString>] ) --> NIL

Arguments

  <xExp> is any valid expression.
  <cPicture> is any picture transformation that TRANSFORM() can use.
  <cColorString> is an optional string that specifies a screen color to use in place of the default color when the output goes to the screen.

Returns

  NIL

Description

  Outputs any expression using a picture transformation instead of using the default transformation for the type of expression.

Examples

          // Output a negative dollar amount using debit notation.
          DEVOUTPICT( -1.25, "@D$ 99,999.99 )
    Tests
          @ 3,1 SAY -1.25 PICTURE "@D$ 99,999.99"
          will display "$(     1.25)" starting on row four, column two of the
          current device (without the double quotation marks, of course).

Status

  Ready

Compliance

  DEVOUTPICT() is mostly CA-Clipper compliant. Any differences are due to enhancements in the Harbour TRANSFORM() over CA-Clipper.

Files

  Library is rtl

See Also

- DEVOUT()
- TRANSFORM()