.\" $Id: JAM_NewSubPacket.3,v 1.1 2002/11/09 00:37:16 raorn Exp $
.\"
.TH JAM_NewSubPacket 3 2002-11-07 "" "JAM subroutine library"
.SH NAME
JAM_NewSubPacket \- Create a new subfield packet
.SH SYNOPSIS
.nf
.B #include <jamlib/jam.h>

.BI "s_JamSubPacket* JAM_NewSubPacket(void);"
.RE
.fi
.SH DESCRIPTION
Creates a new, empty, subfield packet.
.SS Arguments
None
.SH "RETURN VALUE"
The subpacket handle, if successful, or NULL if a memory allocation failed.
.SH EXAMPLES
.nf
s_JamSubPacket*   SubPacket_PS;

SubPacket_PS = JAM_NewSubPacket();
if (!SubPacket_PS) {
    printf("JAM_NewSubPacket returned NULL.\\n");
    return;
}
.fi
.SH 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>.
.SH SEE ALSO
.BR jamlib (3),
.BR JAM_DelSubPacket (3),
.BR JAM_GetSubfield (3),
.BR JAM_GetSubfield_R (3),
.BR JAM_PutSubfield (3)
.\" vim: ft=nroff