CResponse::getExpiresAbsolute

The CResponse::getExpiresAbsolute function retrieve the current value of the ExpiresAbsolute property.

chchar *getExpiresAbsolute();

Return Type

chchar *
Upon successful completion, a string which contains the value of the {\bf ExpiresAbsolute} property is returned. Otherwise, NULL is returned.

Parameters

None.

Remarks

This function retrieves the current value of the ExpiresAbsolute property of the object. If the user returns to the same page before the set date and time, the cached version is displayed. If this property is set more than once on a page, the earliest expiration date or time is used. If the expiration date and time is not set before this function is called, NULL is returned.

The date string is formatted as:

 Wdy, DD-Mon-YYYY HH:MM:SS GMT

This is based on RFC 822, RFC 850, RFC 1036, and RFC 1123, with the variations that the only legal time zone is GMT (Greenwich Mean Time) and the separators between the elements of the date must be dashes.

The CResponse::setExpiresAbsolute function can be used to set a new value to the ExpiresAbsolute property.