LAPI_Addr_get Subroutine

Propósito

Recupera um endereço de função que foi registrado anteriormente usando LAPI_Addr_set.

Biblioteca

Biblioteca de Disponibilidade (liblapi_r.a)

Sintaxe C

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

Sintaxe 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
 

Descrição

Type of call: manipulação de endereço local

Use este subroutine para obter o ponteiro que foi registrado anteriormente com LAPI e está associado ao índice addr_hndl. O valor de addr_hndl deve estar no intervalo 1 < = addr_hndl < LOC_ADDRTBL_SZ.

Parâmetros

INPUT

hndl

Especifica a alça LAPI.

addr_hndl

Especifica o índice do endereço da função a recuperar. Você já deveria ter registrado anteriormente o endereço neste índice usando LAPI_Addr_set. O valor deste parâmetro deve estar no intervalo 1 < = addr_hndl < LOC_ADDRTBL_SZ.

SAÍDA

endereço

Retorna um endereço de função que o usuário registrou com LAPI.

ierror

Especifica um código de retorno FORTRAN. Este é sempre o último parâmetro.

Exemplos de C

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                                          */

Valores De Retorno

LAPI_SUCESSO

Indica que a chamada de função foi concluída com sucesso.

LAPI_ERR_ADDR_HNDL_RANGE

Indica que o valor de addr_hndl não está no intervalo 1 < = addr_hndl < LOC_ADDRTBL_SZ.

LAPI_ERR_HNDL_INVÁLIDA

Indica que o hndl passado em não é válido (não inicializado ou em estado finalizado).

LAPI_ERR_RET_PTR_NULL

Indica que o valor do ponteiro addr é NULL (em C) ou que o valor de addr é LAPI_ADDR_NULL (em FORTRAN).

Local

/usr/lib/liblapi_r.a