LAPI_Address Sous-routine

Objectif

Renvoie une valeur longue non signée pour une adresse utilisateur spécifiée.

Bibliothèque

Bibliothèque de disponibilité (liblapi_r.a)

Syntaxe C

#include <lapi.h>
 
int LAPI_Address(my_addr, ret_addr)
void   *my_addr;
ulong  *ret_addr;

Note: Cette sous-routine est destinée à être utilisée par les programmes FORTRAN. La version C de LAPI_Address est fournie à des fins de compatibilité uniquement.

Syntaxe FORTRAN

include 'lapif.h'
 
LAPI_ADDRESS(my_addr, ret_addr, ierror)
INTEGER (KIND=any_type) :: my_addr
INTEGER (KIND=LAPI_ADDR_TYPE) :: ret_addr
INTEGER ierror

où :

Type_any_de_type: Est un type de données FORTRAN. Cette déclaration de type a la même signification que le type void * dans C.

Descriptif

Manipulation de l'adresse locale Type of call:

Utilisez cette sous-routine dans les programmes FORTRAN lorsque vous devez stocker des adresses spécifiées dans un tableau. Dans FORTRAN, le concept d'adresse (&) n'existe pas comme dans C. LAPI_Address fournit cette fonction aux programmeurs FORTRAN.

Paramètres

ENTREE
Mon_adresse: Indique l'adresse à convertir. La valeur de ce paramètre ne peut pas être NULL (en C) ou LAPI_ADDR_NULL (en FORTRAN).
Sortie
Ret_addr: Renvoie l'adresse stockée dans Mon_adresse en tant que durée d'utilisation non signée pour les appels LAPI. La valeur de ce paramètre ne peut pas être NULL (en C) ou LAPI_ADDR_NULL (en FORTRAN).
Ierror: Indique un code retour FORTRAN. C'est toujours le dernier paramètre.

Exemples FORTRAN

Pour extraire l'adresse d'une variable:


! Contains the address of the target counter  
integer (KIND=LAPI_ADDR_TYPE) :: cntr_addr              
      
! Target Counter
type (LAPI_CNTR_T) :: tgt_cntr                                              
      
! Return code
integer :: ierror                                      
      
call LAPI_ADDRESS(tgt_cntr, cntr_addr, ierror)
      
!  cntr_addr now contains the address of tgt_cntr

Valeurs renvoyées

LAPI_SUCCESS: Indique que l'appel de fonction a abouti.
LAPI_ERR_ORG_ADDR_NULL: Indique que la valeur de my_addr est NULL (en C) ou LAPI_ADDR_NULL (en FORTRAN).
LAPI_ERR_TGT_ADDR_NULL: Indique que la valeur de ret_addr est NULL (en C) ou LAPI_ADDR_NULL (en FORTRAN).

Emplacement

/usr/lib/liblapi_r.a