source: trunk/src/kmk/lst.lib/lstIsAtEnd.c@ 19

Last change on this file since 19 was 9, checked in by bird, 23 years ago

Initial revision

  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
File size: 3.3 KB
Line 
1/*
2 * Copyright (c) 1988, 1989, 1990, 1993
3 * The Regents of the University of California. All rights reserved.
4 *
5 * This code is derived from software contributed to Berkeley by
6 * Adam de Boor.
7 *
8 * Redistribution and use in source and binary forms, with or without
9 * modification, are permitted provided that the following conditions
10 * are met:
11 * 1. Redistributions of source code must retain the above copyright
12 * notice, this list of conditions and the following disclaimer.
13 * 2. Redistributions in binary form must reproduce the above copyright
14 * notice, this list of conditions and the following disclaimer in the
15 * documentation and/or other materials provided with the distribution.
16 * 3. All advertising materials mentioning features or use of this software
17 * must display the following acknowledgement:
18 * This product includes software developed by the University of
19 * California, Berkeley and its contributors.
20 * 4. Neither the name of the University nor the names of its contributors
21 * may be used to endorse or promote products derived from this software
22 * without specific prior written permission.
23 *
24 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
25 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
26 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
27 * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
28 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
29 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
30 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
31 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
32 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
33 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
34 * SUCH DAMAGE.
35 *
36 * @(#)lstIsAtEnd.c 8.1 (Berkeley) 6/6/93
37 */
38
39#ifndef lint
40#include <sys/cdefs.h>
41__FBSDID("$FreeBSD: src/usr.bin/make/lst.lib/lstIsAtEnd.c,v 1.7 2002/10/09 02:00:22 jmallett Exp $");
42#endif /* not lint */
43
44/*-
45 * LstIsAtEnd.c --
46 * Tell if the current node is at the end of the list.
47 * The sequential functions access the list in a slightly different way.
48 * CurPtr points to their idea of the current node in the list and they
49 * access the list based on it. Because the list is circular, Lst_Next
50 * and Lst_Prev will go around the list forever. Lst_IsAtEnd must be
51 * used to determine when to stop.
52 */
53
54#include "lstInt.h"
55
56/*-
57 *-----------------------------------------------------------------------
58 * Lst_IsAtEnd --
59 * Return true if have reached the end of the given list.
60 *
61 * Results:
62 * TRUE if at the end of the list (this includes the list not being
63 * open or being invalid) or FALSE if not. We return TRUE if the list
64 * is invalid or unopend so as to cause the caller to exit its loop
65 * asap, the assumption being that the loop is of the form
66 * while (!Lst_IsAtEnd (l)) {
67 * ...
68 * }
69 *
70 * Side Effects:
71 * None.
72 *
73 *-----------------------------------------------------------------------
74 */
75Boolean
76Lst_IsAtEnd (l)
77 Lst l;
78{
79 register List list = (List) l;
80
81 return (!LstValid (l) || !list->isOpen ||
82 (list->atEnd == Head) || (list->atEnd == Tail));
83}
84
Note: See TracBrowser for help on using the repository browser.