Functions and Directives Functions and Directives

Function _conGetDS() Foundation

Writes the content of a date type container into the passed buffer as a character string.

Syntax
XPPAPIRET _conGetDS(ContainerHandle chd, CHAR pcBuffer[8]);
Parameters
ContainerHandle chd
Handle to a container of type date.
CHAR pcBuffer[8]
Pointer to the buffer where the date character string is to be written. The character string is always 8 characters long and is not terminated with a NULL character.
Return

The function returns an error code (XPP_ERR_...) when the container chd is not a date. If the return value is NULL, the operation was successful.

Description

_conGetDS() is used to access a date container. The date value is written as a character string in the format "YYYYMMDD" into the passed buffer. The year is written with four digits, month and day with two digits, zero padded if needed (example: 7/22/94 -> "19940722"). The character string is not terminated with a NULL character. If the value is a NULL date, the character string is filled with blank spaces. This behavior corresponds with the Xbase++ function DtoS(), therefore the date settings of SET DATE have no effect.

Examples
/* 
   Writes the date value of a container into the buffer as a string. 
*/ 
#include <xppcon.h> 

ContainerHandle  hDate; 
XPPAPIRET        xr; 
CHAR             buffer[9]; 

/* Assigns a value to ... hDate */ 

xr = _conGetDS(hDate, buffer); 
if (xr == 0) 
{ 
   /* ... Operations with the date string */ 
}
Feedback

If you see anything in the documentation that is not correct, does not match your experience with the particular feature or requires further clarification, please use this form to report a documentation issue.