CPXXsetlogfilenameCPXsetlogfilename

设置和打开日志文件。

int  CPXXsetlogfilename( CPXCENVptr 环境, char const * 文件名, char const * 模式 )

int  CPXsetlogfilename( CPXCENVptr 环境, char const * 文件名, char const * 模式 )

描述

此例程将 CPLEX 日志文件设置为 filename 指定的文件。 CPLEX 日志文件捕获来自所有四个 CPLEX 定义的通道的输出。 CPLEX 以 mode 指示的方式打开日志文件,这是遵循与 C 库中的函数 fopen 的各个自变量相同规范的字符串。

CPLEX 关闭任何先前打开的日志文件,即使打开新日志文件失败。 允许传递 NULL 作为 filename 并关闭当前日志文件(如果存在)。

注意:调用 "CPXXsetlogfilename/CPXsetlogfilename相当于将 "cpxresults、"cpxwarning、"cpxerror"和 "cpxlog消息通道的输出导入一个文件。

参数

env
一个指向 CPXXopenCPLEX/CPXopenCPLEX 所返回 CPLEX 环境的指针。
filename
要打开的日志文件的名称。 CPLEX 将此参数视为空端字符串,并将其原样传递给操作系统,而与 CPLEX "API 字符串编码开关指定的编码无关。 CPLEX 在写入日志文件时使用的编码是打开日志文件时(即调用此例程时)文件编码开关的值。
mode
CPLEX 打开文件的方式。 此规范与 C 库函数 fopen 的规范相同。 例如,使用括在引号内的字符,比如“w”表示写入,“a”表示追加。 确保打开文件进行编写;否则,CPLEX 不会将任何内容写入到日志文件,并且 CPLEX 在每次尝试写入时都会生成错误。 如果 filenameNULL,那么将忽略此自变量,而且也可以为 NULL

返回

如果此例程成功,那么会返回 0,而如果发生错误,那么会返回非零。

示例


status = CPXsetlogfilename (env, "logfile.txt", "w");