dc_frdate()

Converts a date variable to a string for display in a field

Call
#include <vv_date.h>
int dc_frdate(stp, datap, dfldp, cvbufp)
UCHAR *stp	Pointer to a string buffer
PTR datap	Pointer to a variable containing date string
DFIELDPTR dfldp	Pointer to a data field structure
PTR cvbufp	Pointer to a data conversion buffer
Returns
1	The string was successfully formatted for field display. This is the only return value for this function.
Description dc_frdate() prepares a date for display in a field. The date is first reformatted, if necessary, to agree with the field's date format string. The string buffer is then initialized to blanks and the date variable copied to the string buffer. Field requirements are respected as follows: If the field has protected characters, the setting of the PICSKIP field option determines how the protected characters are written to the string buffer. If PICSKIP is ON, the protected characters are inserted into the field string at the appropriate positions. If PICSKIP is OFF, the string is written to the buffer first. Any character located in a protected position is overwritten with the protected character. If the field is set for left justification (LFTADJUST is ON), any leading blanks in the string variable are skipped when copying to the string buffer. If the field is set for right justification (RTADJUST is ON) and the string is shorter than the field length, the string is shifted the appropriate number of spaces to the right. Characters are copied into the string buffer for the length of the field. The variable string will be truncated if there are more characters than fit in the field.
Related Functions dc_todate(), vf_date()
Cautions dc_frdate() assumes that the string buffer is large enough to hold the resulting string, including a null terminator '/0'.