LAPI_Addr_get 서브루틴

용도

이전에 ' LAPI_Addr_set'을 사용하여 등록한 함수 주소를 검색합니다.

라이브러리

가용성 라이브러리 (liblapi_r.a)

C 구문

#include <lapi.h>
 
int LAPI_Addr_get(hndl, addr, addr_hndl)
lapi_handle_t  hndl;
void         **addr;
int            addr_hndl;

FORTRAN 구문

include 'lapif.h'
 
LAPI_ADDR_GET(hndl, addr, addr_hndl, ierror)
INTEGER hndl
INTEGER (KIND=LAPI_ADDR_TYPE) :: addr
INTEGER addr_hndl
INTEGER ierror

설명

Type of call: 로컬 주소 조작

이 서브루틴을 사용하여 이전에 LAPI에 등록되어 있고 인덱스 addr_hndl과 연결된 포인터를 가져옵니다. Addr_hndl의 값은 1 <= addr_hndl < LOC_ADDRTBL_SZ 범위에 있어야 합니다.

매개변수

입력
hndl: LAPI 핸들을 지정합니다.
addr_hndl: 검색할 함수 주소의 인덱스를 지정합니다. 이전에 ' LAPI_Addr_set'을 사용하여 이 인덱스에 주소를 등록했어야 합니다. 이 매개변수의 값은 1 <= addr_hndl < LOC_ADDRTBL_SZ 범위에 있어야 합니다.
OUTPUT
addr: 사용자가 LAPI에 등록한 함수 주소를 반환합니다.
ierror: FORTRAN 반환 코드를 지정합니다. 이 매개변수는 항상 마지막 매개변수입니다.

C 예제

이전에 ' LAPI_Addr_set'을 사용하여 등록한 헤더 핸들러 주소를 검색하려면 :


lapi_handle_t   hndl;      /* the LAPI handle                       */
void          **addr;      /* the address to retrieve               */
int             addr_hndl; /* the index returned from LAPI_Addr_set */

⋮            

addr_hndl = 1;
LAPI_Addr_get(hndl, &addr, addr_hndl);
      
/* addr now contains the address that was previously registered */ 
/* using LAPI_Addr_set                                          */

리턴 값

LAPI_SUCCESS: 함수 호출이 성공적으로 완료되었음을 나타냅니다.
LAPI_ERR_ADDR_HNDL_RANGE: Addr_hndl의 값이 1 <= addr_hndl < LOC_ADDRTBL_SZ 범위에 속하지 않음을 나타냅니다.
LAPI_ERR_HNDL_INVALID: 전달된 hndl이 유효하지 않음을 나타냅니다(초기화되지 않았거나 종료된 상태).
LAPI_ERR_RET_PTR_NULL: Addr 포인터의 값이 NULL(C에서는)이거나 addr의 값이 ' LAPI_ADDR_NULL '(FORTRAN에서는)임을 나타냅니다.

위치

/usr/lib/liblapi_r.a