NAME

JAM_GetSubfield_R - Get a subfield from a subfield packet (reentrant)

SYNOPSIS

#include <jamlib/jam.h>
s_JamSubfield* JAM_GetSubfield(s_JamSubPacket* SubPack_PS,
                               ulong*          Count_PI);

DESCRIPTION

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

This function is a reentrant replacement for JAM_GetSubfield(3).

Arguments

SubPack_PS: The subfield packet to use.
Count_PI: Pointer to a variable that contains the number of the subfield to retrieve. The variable should be set to zero the first time the function is called and is then automatically increased by the function for any subsequent calls.

RETURN VALUE

A pointer to a subfield, if successful, or NULL if there are no more subfields in the packet.

EXAMPLES

s_JamSubPacket* SubPack_PS;
s_JamSubfield*  Subfield_PS;
s_JamMsgHeader  Header_S;
ulong           Count_I;
int             Result_I;
Result_I = JAM_ReadMsgHeader(0, &Header_S, &SubPack_PS);
if (Result_I)
  printf("JAM_ReadMsgHeader returned %d.\n", Result_I);
Count_I = 0;     
while((Subfield_PS = JAM_GetSubfield_R(SubPack_PS , &Count_I)))
  printf("Subfield id %d\n", Subfield_PS->LoID);
JAM_DelSubPacket(SubPack_PS);

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