xHarbour Reference Documentation > Function Reference

DevOutPict()

Outputs a PICTURE formatted value to the current device.

Syntax

DevOutPict( <expression>, <cPicture> [,<cColorString>] ) --> NIL

Arguments

<expression>

Any expression whose value should be output to the current output device selected with the SET DEVICE command.

<cPicture>

A character string holding a PICTURE format which specifies how to format the value of <expression> for output. Refer to Transform() for picture formats.

<cColorString>

This is an optional SetColor() compliant color string that defines the output color. If omitted, the standard color of the currently selected color string is used.

Return

The return value is always NIL.

Description

DevOutPict() is a console function that outputs the value of any expression using a picture transformation rule instead of using the default transformation for the type of <expression>.

Info

See also:	@...SAY, Col(), DevOut(), DevPos(), QOut() | QQOut(), Row(), SET DEVICE, SetPos(), Transform()
Category:	Output functions
Source:	rtl\devoutp.prg
LIB:	xhb.lib
DLL:	xhbdll.dll

Example

// Output a negative dollar amount using debit notation.

   PROCEDURE Main

       DevOutPict( -12.45, "@X $ 99,999.99" )   // result: $     12.45 DB

   RETURN