NAME
cgGetLastListing - get the current listing text
SYNOPSIS
#include <Cg/cg.h> const char * cgGetLastListing( CGcontext context );PARAMETERS
- context
The context handle.
RETURN VALUES
cgGetListListing return a NULL-terminated string containing the current listing text. If no listing text is available, or the listing text string is empty, NULL is returned.
In all cases, the pointer returned by cgGetLastListing is only guaranteed to be valid until the next Cg entry point not related to error reporting is called. For example, calls to cgCreateProgram, cgCompileProgram, cgCreateEffect, or cgValidateEffect will invalidate any previously-returned listing pointer.
DESCRIPTION
Each Cg context maintains a NULL-terminated string containing warning and error messages generated by the Cg compiler, state managers and the like. cgGetlastListing allows applications and custom state managers to query the listing text.
cgGetLastListing returns the currrent listing string for the given CGcontext. When a Cg runtime error occurs, applications can use the appropriate context's listing text in order to provide the user with detailed information about the error.
EXAMPLES
to-be-written
ERRORS
CG_INVALID_PARAMETER_ERROR is generated if context is invalid.
HISTORY
cgGetLastListing was introduced in Cg 1.1.
SEE ALSO