1 This file is break.def, from which is created break.c.
2 It implements the builtins "break" and "continue" in Bash.
4 Copyright (C) 1987-2003 Free Software Foundation, Inc.
6 This file is part of GNU Bash, the Bourne Again SHell.
8 Bash is free software; you can redistribute it and/or modify it under
9 the terms of the GNU General Public License as published by the Free
10 Software Foundation; either version 2, or (at your option) any later
13 Bash is distributed in the hope that it will be useful, but WITHOUT ANY
14 WARRANTY; without even the implied warranty of MERCHANTABILITY or
15 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
18 You should have received a copy of the GNU General Public License along
19 with Bash; see the file COPYING. If not, write to the Free Software
20 Foundation, 59 Temple Place, Suite 330, Boston, MA 02111 USA.
25 $FUNCTION break_builtin
27 Exit from within a FOR, WHILE or UNTIL loop. If N is specified,
32 #if defined (HAVE_UNISTD_H)
34 # include <sys/types.h>
39 #include "../bashintl.h"
44 extern char *this_command_name;
45 extern int posixly_correct;
47 static int check_loop_level __P((void));
49 /* The depth of while's and until's. */
52 /* Non-zero when a "break" instruction is encountered. */
55 /* Non-zero when we have encountered a continue instruction. */
58 /* Set up to break x levels, where x defaults to 1, but can be specified
59 as the first argument. */
66 if (check_loop_level () == 0)
67 return (EXECUTION_SUCCESS);
69 newbreak = get_numeric_arg (list, 1);
73 sh_erange (list->word->word, "loop count");
74 breaking = loop_level;
75 return (EXECUTION_FAILURE);
78 if (newbreak > loop_level)
79 newbreak = loop_level;
83 return (EXECUTION_SUCCESS);
87 $FUNCTION continue_builtin
88 $SHORT_DOC continue [n]
89 Resume the next iteration of the enclosing FOR, WHILE or UNTIL loop.
90 If N is specified, resume at the N-th enclosing loop.
93 /* Set up to continue x levels, where x defaults to 1, but can be specified
94 as the first argument. */
96 continue_builtin (list)
101 if (check_loop_level () == 0)
102 return (EXECUTION_SUCCESS);
104 newcont = get_numeric_arg (list, 1);
108 sh_erange (list->word->word, "loop count");
109 breaking = loop_level;
110 return (EXECUTION_FAILURE);
113 if (newcont > loop_level)
114 newcont = loop_level;
116 continuing = newcont;
118 return (EXECUTION_SUCCESS);
121 /* Return non-zero if a break or continue command would be okay.
122 Print an error message if break or continue is meaningless here. */
126 #if defined (BREAK_COMPLAINS)
127 if (loop_level == 0 && posixly_correct == 0)
128 builtin_error (_("only meaningful in a `for', `while', or `until' loop"));
129 #endif /* BREAK_COMPLAINS */