LAPI_Getcntr 子例程

在线编辑

用途

获取指定的 LAPI 计数器的整数值。

库

可用性库 (liblapi_r.a)

C 语法

#include <lapi.h>
 
int LAPI_Getcntr(hndl, cntr, val)
lapi_handle_t  hndl;
lapi_cntr_t   *cntr;
int           *val;

FORTRAN 语法

include 'lapif.h'
 
LAPI_GETCNTR(hndl, cntr, val,  ierror)
INTEGER hndl
TYPE (LAPI_CNTR_T) :: cntr
INTEGER val
INTEGER ierror

描述

Type of call: 本地计数器操作

此子例程获取 中特尔的整数值。 它用于检查 恩德尔上的进度。

参数

INPUT
恩德尔
指定 LAPI 句柄。
中特尔
指定该计数器的地址。 此参数的值不能为 NULL (在 C 中) 或 LAPI_ADDR_NULL (在 FORTRAN 中)。
输出
瓦尔
将返回计数器 中特尔的整数值。 此参数的值不能为 NULL (在 C 中) 或 LAPI_ADDR_NULL (在 FORTRAN 中)。
国际错误
指定 FORTRAN 返回码。 这始终是最后一个参数。

C 示例


{
    lapi_cntr_t cntr;
    int         val;

   /* cntr is initialized */

   /* processing/communication takes place */
   
   LAPI_Getcntr(hndl, &cntr, &val)
       
   /* val now contains the current value of cntr */
}

返回值

LAPI_SUCCESS
指示已成功完成函数调用。
LAPI_ERR_CNTR_NULL
指示 cntr 指针为 NULL (在 C 中) 或 cntr 的值为 LAPI_ADDR_NULL (在 FORTRAN 中)。
LAPI_ERR_HNDL_INVALID
指示传入的 恩德尔 无效 (未初始化或处于 "已终止" 状态)。
LAPI_ERR_RET_PTR_NULL
指示 val 指针的值为 NULL (在 C 中) 或 val 的值为 LAPI_ADDR_NULL (在 FORTRAN 中)。

位置

/usr/lib/liblapi_r.a