Cg Core Runtime API                           cgGetNextProgram(3)



NAME
     cgGetNextProgram - iterate through programs in a context

SYNOPSIS
       #include 

       CGprogram cgGetNextProgram( CGprogram program );


PARAMETERS
     program The current program.

RETURN VALUES
     Returns the next program in the context's internal sequence
     of programs.

     Returns NUL when program is the last program in the
     context.

DESCRIPTION
     The programs within a context can be iterated over by using
     cgGetNextProgram.

     Note that no specific order of traversal is defined by this
     mechanism.  The only guarantee is that each program will be
     visited exactly once. No guarantees can be made if programs
     are generated or deleted during iteration.

EXAMPLES
       CGprogram program = cgGetFirstProgram( context );
       while( program )
       {
         /* do something with program */
         program = cgGetNextProgram( program )
       }


ERORS
     CGINVALIDPROGRAMHANDLEROR is generated if program is
     not a valid program handle.

HISTORY
     cgGetNextProgram was introduced in Cg 1.1.

SEE ALSO
     cgGetFirstProgram, cgCreateProgram, cgDestroyProgram,
     cgIsProgram








Cg Toolkit 2.1            Last change:                          1