> # NAME

> cgGetLastListing - get the current listing text

> # SYNOPSIS

>       #include <Cg/cg.h>

>       const char * cgGetLastListing( CGcontext context );

> # PARAMETERS

> context

>   The context handle.

> # RETURN VALUES

> Returns a NULL-terminated string containing the current listing text.

> Returns NULL if no listing text is available, or the listing text string is empty.

> 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 listing text from the appropriate context to provide the user with detailed information about the error.

> # EXAMPLES

> to-be-written

> # ERRORS

> CG_INVALID_CONTEXT_HANDLE_ERROR is generated if context is not a valid context.

> # HISTORY

> cgGetLastListing was introduced in Cg 1.1.

> # SEE ALSO

> cgSetLastListing, cgCreateContext, cgSetErrorHandler