pcrs_job.Exec

pcrs_job.Exec — applies a compiled pattern substitution to a subject string.

Synopsis

pcrs_job.Exec(subject, length?=-1)
    

Arguments

subject

A subject string for substitution.

length

The length of the subject string. Entering -1 (the default) for this parameter will cause the length of the subject string to be automatically computed.

Returns

On success, the new string with the substitutions applied. On failure, an error list with three elements:

  • car(errlist) = a numeric return code from the failing function

  • cadr(errlist) = a character position in the pattern where the error occurred, or 0.

  • caddr(errlist) = an error message, as a human-readable string

Description

This method of the pcrs_job class applies a previously compiled pattern substitution to a subject string.