Initializing help system before first use

XPRMdbg_getlocation

Purpose
Get a source file location associated to a given line index.
Synopsis
int XPRMdbg_getlocation(XPRMmodel model, int lndx, int *line, const char **fname);
Arguments
model 
Reference to a model
lndx 
Line index, -1 for current location or -2 for the last location of the model
line 
Pointer to an area where the line number is returned
fname 
Pointer to an area where the file name is returned
Return value
0 if successful, 1 otherwise (invalid parameters)
Further information
1. This funtion returns the source location (file name and line number) corresponding to a given line index. If the provided index is -1 and an execution context is available, the function returns information related to the statement being executed. If this value is -2, the location of the last statement is returned.
2. If parameter fname is NULL, the function returns in line the current line index ( i.e. the value of lndx or its updated value if it was given as a negative number).
3. If the returned line number is 0, the machine is currently executing a portion of the code for which there is no debugging information ( i.e. a package compiled without option -g or -G). In this case the fname information corresponds to the package name.
Related topics

© 2001-2024 Fair Isaac Corporation. All rights reserved. This documentation is the property of Fair Isaac Corporation (“FICO”). Receipt or possession of this documentation does not convey rights to disclose, reproduce, make derivative works, use, or allow others to use it except solely for internal evaluation purposes to determine whether to purchase a license to the software described in this documentation, or as otherwise set forth in a written software license agreement between you and FICO (or a FICO affiliate). Use of this documentation and the software described in it must conform strictly to the foregoing permitted uses, and no other use is permitted.