fn_attr_create_subcontext(3XFN)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | ERRORS | ATTRIBUTES | SEE ALSO

NAME

fn_attr_create_subcontext- create a subcontext in a context and associate attributes with newly created context

SYNOPSIS

#include <xfn/xfn.h>

FN_ref_t *fn_attr_create_subcontext(FN_ctx_t *ctx, const FN_composite_name_t *name, const FN_attrset_t *attrs, FN_status_t *status);

DESCRIPTION

This operation creates a new XFN context of the same type as the target context, that is, that context named by all but the terminal atomic component of name, and binds it to the supplied composite name. In addition, attributes given in attrs are associated with the newly created context.

The target context must already exist. The new context is created and bound in the target context using the terminal atomic name in name. The operation returns a reference to the newly created context.

RETURN VALUES

fn_attr_create_subcontext() returns a reference to the newly created context; if the operation fails, it returns a NULL pointer.

ERRORS

fn_attr_create_subcontext() sets status as described in FN_status_t(3XFN) and xfn_status_codes(3XFN). Of special relevance for this operation is the following status code:

FN_E_NAME_IN_USE

The terminal atomic name already exists in the target context.

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
MT-Level	MT-Safe

SEE ALSO

FN_composite_name_t(3XFN), FN_ctx_t(3XFN), FN_ref_t(3XFN), FN_status_t(3XFN), fn_attr_bind(3XFN), fn_ctx_bind(3XFN), fn_ctx_create_subcontext(3XFN), fn_ctx_destroy_subcontext(3XFN), fn_ctx_lookup(3XFN), xfn_attributes(3XFN), xfn_status_codes(3XFN), attributes(5)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | ERRORS | ATTRIBUTES | SEE ALSO