[ новости /+++ | форум | теги | ]

NAME
     fn_ctx_create_subcontext - create a subcontext in a context

SYNOPSIS
     cc [ flag ... ] file ... -lxfn [ library ... ]
     #include <xfn/xfn.h>

     FN_ref_t  *fn_ctx_create_subcontext(FN_ctx_t   *ctx,   const
     FN_composite_name_t *name, FN_status_t *status);

DESCRIPTION
     This operation creates a new XFN context of the same type as
     the  target  context  -  that  named by all but the terminal
     atomic component of  name - and binds  it  to  the  supplied
     composite name.

     As with  fn_ctx_bind(),  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  opera-
     tion returns a reference to the newly created context.

RETURN VALUE
     fn_ctx_create_subcontext() returns a reference to the  newly
     created  context;  if the operation fails, it returns a NULL
     pointer (0).

ERRORS
     fn_ctx_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.

APPLICATION USAGE
     The new subcontext is an XFN context and is created  in  the
     same  naming  system as the target context.  The new subcon-
     text also inherits the same syntax attributes as the  target
     context.  XFN does not specify any further properties of the
     new subcontext. The target context  and  its  naming  system
     determine these.

ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | MT-Level                    | Safe.                       |
    |_____________________________|_____________________________|


SEE ALSO
     FN_composite_name_t(3XFN),  FN_ctx_t(3XFN),  FN_ref_t(3XFN),
     FN_status_t(3XFN),  fn_ctx_bind(3XFN),  fn_ctx_lookup(3XFN),
     fn_ctx_destroy_subcontext(3XFN),     xfn_status_codes(3XFN),
     xfn(3XFN), attributes(5)

Партнёры:

Хостинг: