CPXXNETgetarcname 和 CPXNETgetarcname
访问存储在网络问题对象中的网络中一系列弧的名称。
int CPXXNETgetarcname( CPXCENVptr 环境, CPXCNETptr 网, char ** 名称, char * 命名存储, CPXSIZE 名称, CPXSIZE * 剩余_p, CPXDIM 兴办, CPXDIM 最后 )
int CPXNETgetarcname( CPXCENVptr 环境, CPXCNETptr 网, char ** 名称, char * 命名存储, int 名称, int * 剩余_p, int 兴办, int 最后 )
描述
例程 "CPXXNETgetarcname/CPXNETgetarcname访问存储在网络问题对象中的网络中一系列弧的名称。 作为此例程的参数,您必须指定范围的起点、范围的终点以及要返回弧名的数组长度。
注:
如果该例程返回 CPXERR_NEGATIVE_SURPLUS,那么 *surplus_p 中的值将为负并指定所提供内存与所需内存之差(以字节计)。
参数
- env
- 一个指向
CPXXopenCPLEX/CPXopenCPLEX所返回 CPLEX 环境的指针。 - net
- 一个指向 CPLEX 网络问题对象的指针,此指针由
CPXXNETcreateprob/CPXNETcreateprob返回。 - nnames
- 将指向存储在数组 "
namestore中的圆弧名称的指针复制到哪里。 该数组的长度必须至少为 (end-begin+1)。此例程返回指向 "nnames[i-begin]中弧 "i名称的指针。 - namestore
- 指定的标界线名称将复制到的字符数组。 如果 "
namespc为 0(零),则该数组可以为空。 - namespc
namestore数组的长度。- surplus_p
- 一个整数的指针,用于返回 "
namespc与存储所需的名称字符数之间的差值。 非负值指定namespc已足够。 负值指定其不够。 在这种情况下,该例程会返回 "CPXERR_NEGATIVE_SURPLUS。surplus_p的负值表示数组 "namestore空间不足的上限。 - 开始
- 将为其获取名称的第一根标界线的索引。
- 结束
- 将为其获取名称的最后一根标界线的索引。
返回
如果此例程成功,那么会返回 0(零),而如果发生错误,那么会返回非零。 值 CPXERR_NEGATIVE_SURPLUS 指定数组 namestore 中没有足够的空间用于存放名称。
示例
status = CPXNETgetarcname (env, net, nnames, namestore, namespc,
&surplus_p, 0, narcs-1);