NAME

fn_ctx_lookup_link − look up the link reference bound to a name

SYNOPSIS

cc [ flag ... ] file ... −lxfn [ library ... ]

#include <xfn/xfn.h>

FN_ref_t ∗fn_ctx_lookup_link(FN_ctx_t ∗ctx, const FN_composite_name_t ∗name,

FN_status_t ∗status);

MT-LEVEL

Safe. 

DESCRIPTION

This operation returns the XFN link bound to name.  The terminal atomic part of name must be bound to an XFN link. 

The normal fn_ctx_lookup(3N) operation follows all links encountered, including any bound to the terminal atomic part of name.  This operation differs from the normal lookup in that when the terminal atomic part of name is an XFN link, this link is not followed, and the operation returns the link. 

RETURN VALUE

If fn_ctx_lookup_link() fails, a NULL pointer (0) is returned. 

ERRORS

fn_ctx_lookup_link() sets status as described in FN_status_t(3N) and xfn_status_codes(3N).  Of special relevance for fn_ctx_lookup_link() is the following status code:

FN_E_MALFORMED_LINK
name resolved to a reference that was not a link. 

SEE ALSO

FN_composite_name_t(3N), FN_ctx_t(3N), FN_ref_t(3N), FN_status_t(3N), fn_ctx_lookup(3N), xfn_status_codes(3N), xfn_links(3N), xfn(3N)

SunOS 5.5  —  Last change: 4 Nov 1994