IrisEvalH

Variants: IrisEvalA, IrisEvalW

int IrisEvalH(IRISHSTRP volatile expr)

Arguments

expr	The address of a IRISHSTRP variable.

Description

Evaluates a string as if it were an InterSystems IRIS expression and places the return value in memory for further processing by IrisType and IrisConvert.

If IrisEvalH completes successfully, it sets a flag that allows calls to IrisType and IrisConvert to complete. These functions are used to process the item returned from IrisEvalA.

Caution:

The next call to IrisEvalH, IrisExecuteH, or IrisEnd will overwrite the existing return value.

Return Values for IrisEvalH

IRIS_CONBROKEN	Connection has been closed due to a serious error condition or RESJOB.
IRISW_ERSYSTEM	Either InterSystems IRIS generated a <SYSTEM> error, or if called from a $ZF function, an internal counter may be out of sync.
IRIS_NOCON	No connection has been established.
IRIS_STRTOOLONG	String is too long.
IRIS_SUCCESS	String evaluated successfully.

IrisEvalH can also return any of the InterSystems IRIS error codes.

Example

int rc;
IRISHSTRP retval;
IRISHSTRP expr;

strcpy(expr.str, "\"Record\"_^Recnum_\" = \"_$$^GetRec(^Recnum)");
expr.len = strlen(expr.str);
rc = IrisEvalH(&expr);
if (rc == IRIS_SUCCESS)
    rc = IrisConvert(ING,&retval);

IrisEvalW

IrisEvalA