Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
JAM_GetSubfield(3)	     JAM subroutine library	      JAM_GetSubfield(3)

NAME
     JAM_GetSubfield - Get a subfield from a subfield packet (not reentrant)

SYNOPSIS
     #include <jamlib/jam.h>

     s_JamSubfield* JAM_GetSubfield(s_JamSubPacket* SubPack_PS);

DESCRIPTION
     Returns a pointer to the first/next subfield struct in the subfield packet.

   Arguments
     SubPack_PS
	    The subfield packet to use. If this parameter is NULL, the next sub-
	    field from the subfield packet previously scanned will be returned.

RETURN VALUE
     A	pointer  to a subfield, if successful, or NULL if there are no more sub-
     fields in the packet.

EXAMPLES
     s_JamSubPacket* SubPack_PS;
     s_JamSubfield*  Subfield_PS;
     s_JamMsgHeader  Header_S;
     int	     Result_I;

     Result_I = JAM_ReadMsgHeader(0, &Header_S, &SubPack_PS);
     if (Result_I)
       printf("JAM_ReadMsgHeader returned %d.\n", Result_I);

     for (Subfield_PS = JAM_GetSubfield(SubPack_PS); Subfield_PS;
	   Subfield_PS = JAM_GetSubfield(NULL))
       printf("Subfield id %d\n", Subfield_PS->LoID);

     JAM_DelSubPacket(SubPack_PS);

BUGS
     This function is not reentrant and should not be used in multi-threaded ap-
     plications unless you know what you are doing.

     Use JAM_GetSubfield_R(3) instead when a reentrant function is needed.

AUTHOR
     This manual page was created by Sir  Raorn  <raorn@altlinux.ru>,  based  on
     original  JAMlib  documentation by Bjorn Stenberg <bjorn@haxx.nu> and Johan
     Billing <billing@df.lth.se>.

SEE ALSO
     jamlib(3), JAM_GetSubfield_R(3),  JAM_PutSubfield(3),  JAM_NewSubPacket(3),
     JAM_DelSubPacket(3)

				   2002-11-07		      JAM_GetSubfield(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=JAM_GetSubfield&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help