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 attri-
butes:
____________________________________________________________
| 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)
|
Закладки на сайте Проследить за страницей |
Created 1996-2025 by Maxim Chirkov Добавить, Поддержать, Вебмастеру |