usr/src/man/man3c/insque.3c

   1 '\" te
   2 .\" Copyright (c) 2002, Sun Microsystems, Inc. All Rights Reserved. Copyright 1989 AT&T  Copyright (c) 1983 Regents of the University of California.  All rights reserved.  The Berkeley software License Agreement  specifies the terms and conditions for redistribution.
   3 .TH INSQUE 3C "Jul 24, 2002"
   4 .SH NAME
   5 insque, remque \- insert/remove element from a queue
   6 .SH SYNOPSIS
   7 .LP
   8 .nf
   9 include <search.h>
  10
  11 \fBvoid\fR \fBinsque\fR(\fBstruct qelem *\fR\fIelem\fR, \fBstruct qelem *\fR\fIpred\fR);
  12 .fi
  13
  14 .LP
  15 .nf
  16 \fBvoid\fR \fBremque\fR(\fBstruct qelem *\fR\fIelem\fR);
  17 .fi
  18
  19 .SH DESCRIPTION
  20 .sp
  21 .LP
  22 The \fBinsque()\fR and \fBremque()\fR functions manipulate queues built from
  23 doubly linked lists.  Each element in the queue must be in the following form:
  24 .sp
  25 .in +2
  26 .nf
  27 struct qelem {
  28         struct qelem   *q_forw;
  29         struct qelem   *q_back;
  30         char           q_data[\|];
  31 };
  32 .fi
  33 .in -2
  34
  35 .sp
  36 .LP
  37 The \fBinsque()\fR function inserts \fIelem\fR in a queue immediately after
  38 \fIpred\fR.  The \fBremque()\fR function removes an entry \fIelem\fR from a
  39 queue.
  40 .SH ATTRIBUTES
  41 .sp
  42 .LP
  43 See \fBattributes\fR(5) for descriptions of the following attributes:
  44 .sp
  45
  46 .sp
  47 .TS
  48 box;
  49 c | c
  50 l | l .
  51 ATTRIBUTE TYPE  ATTRIBUTE VALUE
  52 _
  53 Interface Stability     Standard
  54 _
  55 MT-Level        Unsafe
  56 .TE
  57
  58 .SH SEE ALSO
  59 .sp
  60 .LP
  61 \fBattributes\fR(5), \fBstandards\fR(5)