Developer Guide and Reference

ID 767251
Date 10/31/2024
Public
Document Table of Contents

C_ASSOCIATED

Intrinsic Module Inquiry function (Generic): Indicates the association status of one argument, or whether two arguments are associated with the same entity.

Module

USE, INTRINSIC :: ISO_C_BINDING

Syntax

result = C_ASSOCIATED(c_ptr_1[, c_ptr_2])

c_ptr_1

(Input) Is a scalar of derived type C_PTR or C_FUNPTR.

c_ptr_2

(Optional; input) Is a scalar of the same type as c_ptr_1.

Results

The result is a scalar of type default logical. The result value is one of the following:

  • If only c_ptr_1 is specified, the result is false if c_ptr_1 is a C null pointer; otherwise, the result is true.

  • If c_ptr_2 is specified, the result is false if c_ptr_1 is a C null pointer. The result is true if c_ptr_1 is equal to c_ptr_2; otherwise, the result is false.