tt_pattern_bcontext_add(3)

tt_pattern_bcontext_addC3LIBRARY FUNCTItt_pattern_bcontext_add(3)

NAME
     tt_pattern_bcontext_add - add  a  byte-array  value  to  the
     values in this pattern's named context

SYNOPSIS
     #include <Tt/tt_c.h>

     Tt_status tt_pattern_bcontext_add(Tt_pattern p,
				       const char *slotname,
				       const unsigned char *value,
				       int length);

DESCRIPTION
     The tt_pattern_bcontext_add()  function  adds  a  byte-array
     value to the values in this pattern's named context.

     The p argument is the opaque handle for the pattern involved
     in	this operation.	 The slotname argument describes the con-
     text for this pattern.   The  value  argument  is	the  byte
     string  with  the	contents  for  the  message context.  The
     length argument is	the length of the value	in bytes.

RETURN VALUE
     Upon successful  completion,  the	tt_pattern_bcontext_add()
     function  returns	the status of the operation as one of the
     following Tt_status values:

	TT_OK	The operation completed	successfully.

	TT_ERR_UNIMP
		The ToolTalk function called is	not implemented.

	TT_ERR_NOMP
		The ttsession(1) process is not	running	 and  the
		ToolTalk service cannot	restart	it.

	TT_ERR_POINTER
		The pointer passed does	not point to an	object of
		the correct type for this operation.

	TT_ERR_SLOTNAME
		The specified slotname is syntactically	invalid.

SEE ALSO
     Tttt_c(5).

Unix System LaboratorLast change: 11 May 1994			1