NAME

fn_attr_get − return specified attribute associated with name

SYNOPSIS

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

#include <xfn/xfn.h>

FN_attribute_t ∗fn_attr_get(FN_ctx_t ∗ctx, const FN_composite_name_t ∗name,

const FN_identifier_t ∗attribute_id, FN_status_t ∗status);

MT-LEVEL

Safe

DESCRIPTION

This operation returns the identifier, syntax and values of a specified attribute for the object named name relative to ctx.  If name is empty, the attribute associated with ctx is returned. 

RETURN VALUE

fn_attr_get returns a pointer to an FN_attribute_t object if the operation succeeds; it returns a NULL pointer (0) if the operation fails. 

ERRORS

fn_attr_get() sets status as described in FN_status_t(3N) and xfn_status_codes(3N). 

APPLICATION USAGE

fn_attr_get_values() and its related operations are used for getting individual values of an attribute.  They should be used if the combined size of all the values are expected to be too large to be returned in a single invocation of fn_attr_get().

SEE ALSO

FN_attribute_t(3N), FN_composite_name_t(3N), FN_ctx_t(3N), FN_identifier_t(3N), FN_status_t(3N), fn_attr_get_values(3N), xfn_attributes(3N), xfn_status_codes(3N), xfn(3N)

SunOS 5.5  —  Last change: 4 Nov 1994