1 /* Parse C expressions for CCCP.
2 Copyright (C) 1987, 1992, 1994, 1995, 1997 Free Software Foundation.
4 This program is free software; you can redistribute it and/or modify it
5 under the terms of the GNU General Public License as published by the
6 Free Software Foundation; either version 2, or (at your option) any
9 This program is distributed in the hope that it will be useful,
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 GNU General Public License for more details.
14 You should have received a copy of the GNU General Public License
15 along with this program; if not, write to the Free Software
16 Foundation, 59 Temple Place - Suite 330,
17 Boston, MA 02111-1307, USA.
19 In other words, you are welcome to use, share and improve this program.
20 You are forbidden to forbid anyone else to use, share and improve
21 what you give them. Help stamp out software-hoarding!
23 Written by Per Bothner 1994. */
25 /* Parse a C expression from text in a string */
30 extern char *xmalloc
PARAMS ((unsigned));
31 extern char *xrealloc
PARAMS ((char *, unsigned));
33 #ifdef MULTIBYTE_CHARS
40 /* This is used for communicating lists of keywords with cccp.c. */
48 /* Define a generic NULL if one hasn't already been defined. */
55 #if defined (USE_PROTOTYPES) ? USE_PROTOTYPES : defined (__STDC__)
56 #define GENERIC_PTR void *
58 #define GENERIC_PTR char *
63 #define NULL_PTR ((GENERIC_PTR) 0)
66 extern char *xmalloc ();
68 #ifndef CHAR_TYPE_SIZE
69 #define CHAR_TYPE_SIZE BITS_PER_UNIT
73 #define INT_TYPE_SIZE BITS_PER_WORD
76 #ifndef LONG_TYPE_SIZE
77 #define LONG_TYPE_SIZE BITS_PER_WORD
80 #ifndef WCHAR_TYPE_SIZE
81 #define WCHAR_TYPE_SIZE INT_TYPE_SIZE
84 #ifndef MAX_CHAR_TYPE_SIZE
85 #define MAX_CHAR_TYPE_SIZE CHAR_TYPE_SIZE
88 #ifndef MAX_INT_TYPE_SIZE
89 #define MAX_INT_TYPE_SIZE INT_TYPE_SIZE
92 #ifndef MAX_LONG_TYPE_SIZE
93 #define MAX_LONG_TYPE_SIZE LONG_TYPE_SIZE
96 #ifndef MAX_WCHAR_TYPE_SIZE
97 #define MAX_WCHAR_TYPE_SIZE WCHAR_TYPE_SIZE
100 /* Yield nonzero if adding two numbers with A's and B's signs can yield a
101 number with SUM's sign, where A, B, and SUM are all C integers. */
102 #define possible_sum_sign(a, b, sum) ((((a) ^ (b)) | ~ ((a) ^ (sum))) < 0)
104 static void integer_overflow ();
105 static long left_shift ();
106 static long right_shift ();
121 #define LEFT_OPERAND_REQUIRED 1
122 #define RIGHT_OPERAND_REQUIRED 2
124 /* SKIP_OPERAND is set for '&&' '||' '?' and ':' when the
125 following operand should be short-circuited instead of evaluated. */
126 #define SKIP_OPERAND 8
127 /*#define UNSIGNEDP 16*/
129 #ifndef HOST_BITS_PER_WIDE_INT
131 #if HOST_BITS_PER_LONG > HOST_BITS_PER_INT
132 #define HOST_BITS_PER_WIDE_INT HOST_BITS_PER_LONG
133 #define HOST_WIDE_INT long
135 #define HOST_BITS_PER_WIDE_INT HOST_BITS_PER_INT
136 #define HOST_WIDE_INT int
143 char rprio
; /* Priority of op (relative to it right operand). */
145 char unsignedp
; /* true if value should be treated as unsigned */
146 HOST_WIDE_INT value
; /* The value logically "right" of op. */
149 /* Take care of parsing a number (anything that starts with a digit).
150 LEN is the number of characters in it. */
152 /* maybe needs to actually deal with floating point numbers */
155 parse_number (pfile
, start
, olen
)
161 register char *p
= start
;
163 register unsigned long n
= 0, nd
, ULONG_MAX_over_base
;
164 register int base
= 10;
165 register int len
= olen
;
166 register int overflow
= 0;
167 register int digit
, largest_digit
= 0;
172 for (c
= 0; c
< len
; c
++)
174 /* It's a float since it contains a point. */
176 "floating point numbers not allowed in #if expressions");
181 if (len
>= 3 && (!strncmp (p
, "0x", 2) || !strncmp (p
, "0X", 2))) {
189 /* Some buggy compilers (e.g. MPW C) seem to need both casts. */
190 ULONG_MAX_over_base
= ((unsigned long) -1) / ((unsigned long) base
);
192 for (; len
> 0; len
--) {
195 if (c
>= '0' && c
<= '9')
197 else if (base
== 16 && c
>= 'a' && c
<= 'f')
198 digit
= c
- 'a' + 10;
199 else if (base
== 16 && c
>= 'A' && c
<= 'F')
200 digit
= c
- 'A' + 10;
202 /* `l' means long, and `u' means unsigned. */
204 if (c
== 'l' || c
== 'L')
207 cpp_error (pfile
, "two `l's in integer constant");
210 else if (c
== 'u' || c
== 'U')
213 cpp_error (pfile
, "two `u's in integer constant");
223 /* Don't look for any more digits after the suffixes. */
226 if (largest_digit
< digit
)
227 largest_digit
= digit
;
228 nd
= n
* base
+ digit
;
229 overflow
|= ULONG_MAX_over_base
< n
| nd
< n
;
235 cpp_error (pfile
, "Invalid number in #if expression");
240 if (base
<= largest_digit
)
241 cpp_pedwarn (pfile
, "integer constant contains digits beyond the radix");
244 cpp_pedwarn (pfile
, "integer constant out of range");
246 /* If too big to be signed, consider it unsigned. */
247 if ((long) n
< 0 && ! op
.unsignedp
)
250 cpp_warning (pfile
, "integer constant is so large that it is unsigned");
264 static struct token tokentab2
[] = {
278 /* Read one token. */
281 cpp_lex (pfile
, skip_evaluation
)
286 register int namelen
;
287 register struct token
*toktab
;
288 enum cpp_token token
;
290 U_CHAR
*tok_start
, *tok_end
;
295 old_written
= CPP_WRITTEN (pfile
);
296 cpp_skip_hspace (pfile
);
297 c
= CPP_BUF_PEEK (CPP_BUFFER (pfile
));
299 return parse_number (pfile
,
300 cpp_read_check_assertion (pfile
) ? "1" : "0", 1);
308 token
= cpp_get_token (pfile
);
309 tok_start
= pfile
->token_buffer
+ old_written
;
310 tok_end
= CPP_PWRITTEN (pfile
);
311 pfile
->limit
= tok_start
;
314 case CPP_EOF
: /* Should not happen ... */
319 if (CPP_BUFFER (pfile
)->fname
!= NULL
)
324 cpp_pop_buffer (pfile
);
326 case CPP_HSPACE
: case CPP_COMMENT
:
329 return parse_number (pfile
, tok_start
, tok_end
- tok_start
);
331 cpp_error (pfile
, "string constants not allowed in #if expressions");
335 /* This code for reading a character constant
336 handles multicharacter constants and wide characters.
337 It is mostly copied from c-lex.c. */
339 register int result
= 0;
340 register num_chars
= 0;
341 unsigned width
= MAX_CHAR_TYPE_SIZE
;
344 U_CHAR
*ptr
= tok_start
;
345 #ifdef MULTIBYTE_CHARS
346 char token_buffer
[MAX_LONG_TYPE_SIZE
/MAX_CHAR_TYPE_SIZE
+ MB_CUR_MAX
];
348 char token_buffer
[MAX_LONG_TYPE_SIZE
/MAX_CHAR_TYPE_SIZE
+ 1];
355 width
= MAX_WCHAR_TYPE_SIZE
;
356 #ifdef MULTIBYTE_CHARS
357 max_chars
= MB_CUR_MAX
;
363 max_chars
= MAX_LONG_TYPE_SIZE
/ width
;
366 while (ptr
< tok_end
&& ((c
= *ptr
++) != '\''))
370 c
= cpp_parse_escape (pfile
, &ptr
);
371 if (width
< HOST_BITS_PER_INT
372 && (unsigned) c
>= (1 << width
))
374 "escape sequence out of range for character");
379 /* Merge character into result; ignore excess chars. */
380 if (num_chars
< max_chars
+ 1)
382 if (width
< HOST_BITS_PER_INT
)
383 result
= (result
<< width
) | (c
& ((1 << width
) - 1));
386 token_buffer
[num_chars
- 1] = c
;
390 token_buffer
[num_chars
] = 0;
393 cpp_error (pfile
, "malformatted character constant");
394 else if (num_chars
== 0)
395 cpp_error (pfile
, "empty character constant");
396 else if (num_chars
> max_chars
)
398 num_chars
= max_chars
;
399 cpp_error (pfile
, "character constant too long");
401 else if (num_chars
!= 1 && ! CPP_TRADITIONAL (pfile
))
402 cpp_warning (pfile
, "multi-character character constant");
404 /* If char type is signed, sign-extend the constant. */
407 int num_bits
= num_chars
* width
;
409 if (cpp_lookup (pfile
, "__CHAR_UNSIGNED__",
410 sizeof ("__CHAR_UNSIGNED__")-1, -1)
411 || ((result
>> (num_bits
- 1)) & 1) == 0)
413 = result
& ((unsigned long) ~0 >> (HOST_BITS_PER_LONG
- num_bits
));
416 = result
| ~((unsigned long) ~0 >> (HOST_BITS_PER_LONG
- num_bits
));
420 #ifdef MULTIBYTE_CHARS
421 /* Set the initial shift state and convert the next sequence. */
423 /* In all locales L'\0' is zero and mbtowc will return zero,
426 || (num_chars
== 1 && token_buffer
[0] != '\0'))
429 (void) mbtowc (NULL_PTR
, NULL_PTR
, 0);
430 if (mbtowc (& wc
, token_buffer
, num_chars
) == num_chars
)
433 cpp_pedwarn (pfile
,"Ignoring invalid multibyte character");
440 /* This is always a signed type. */
447 if (CPP_WARN_UNDEF (pfile
) && !skip_evaluation
)
448 cpp_warning (pfile
, "`%.*s' is not defined",
449 (int) (tok_end
- tok_start
), tok_start
);
450 return parse_number (pfile
, "0", 0);
453 /* See if it is a special token of length 2. */
454 if (tok_start
+ 2 == tok_end
)
456 for (toktab
= tokentab2
; toktab
->operator != NULL
; toktab
++)
457 if (tok_start
[0] == toktab
->operator[0]
458 && tok_start
[1] == toktab
->operator[1])
460 if (toktab
->token
== ERROR
)
462 char *buf
= (char *) alloca (40);
463 sprintf (buf
, "`%s' not allowed in operand of `#if'", tok_start
);
464 cpp_error (pfile
, buf
);
466 op
.op
= toktab
->token
;
477 /* Parse a C escape sequence. STRING_PTR points to a variable
478 containing a pointer to the string to parse. That pointer
479 is updated past the characters we use. The value of the
480 escape sequence is returned.
482 A negative value means the sequence \ newline was seen,
483 which is supposed to be equivalent to nothing at all.
485 If \ is followed by a null character, we return a negative
486 value and leave the string pointer pointing at the null character.
488 If \ is followed by 000, we return 0 and leave the string pointer
489 after the zeros. A value of 0 does not mean end of string. */
492 cpp_parse_escape (pfile
, string_ptr
)
496 register int c
= *(*string_ptr
)++;
505 if (CPP_PEDANTIC (pfile
))
506 cpp_pedwarn (pfile
, "non-ANSI-standard escape sequence, `\\%c'", c
);
511 return TARGET_NEWLINE
;
533 register int i
= c
- '0';
534 register int count
= 0;
537 c
= *(*string_ptr
)++;
538 if (c
>= '0' && c
<= '7')
539 i
= (i
<< 3) + c
- '0';
546 if ((i
& ~((1 << MAX_CHAR_TYPE_SIZE
) - 1)) != 0)
548 i
&= (1 << MAX_CHAR_TYPE_SIZE
) - 1;
550 "octal character constant does not fit in a byte");
556 register unsigned i
= 0, overflow
= 0, digits_found
= 0, digit
;
559 c
= *(*string_ptr
)++;
560 if (c
>= '0' && c
<= '9')
562 else if (c
>= 'a' && c
<= 'f')
563 digit
= c
- 'a' + 10;
564 else if (c
>= 'A' && c
<= 'F')
565 digit
= c
- 'A' + 10;
571 overflow
|= i
^ (i
<< 4 >> 4);
572 i
= (i
<< 4) + digit
;
576 cpp_error (pfile
, "\\x used with no following hex digits");
577 if (overflow
| (i
& ~((1 << BITS_PER_UNIT
) - 1)))
579 i
&= (1 << BITS_PER_UNIT
) - 1;
581 "hex character constant does not fit in a byte");
591 integer_overflow (pfile
)
594 if (CPP_PEDANTIC (pfile
))
595 cpp_pedwarn (pfile
, "integer overflow in preprocessor expression");
599 left_shift (pfile
, a
, unsignedp
, b
)
605 if (b
>= HOST_BITS_PER_LONG
)
607 if (! unsignedp
&& a
!= 0)
608 integer_overflow (pfile
);
612 return (unsigned long) a
<< b
;
617 integer_overflow (pfile
);
623 right_shift (pfile
, a
, unsignedp
, b
)
629 if (b
>= HOST_BITS_PER_LONG
)
630 return unsignedp
? 0 : a
>> (HOST_BITS_PER_LONG
- 1);
632 return (unsigned long) a
>> b
;
637 /* These priorities are all even, so we can handle associatively. */
638 #define PAREN_INNER_PRIO 0
640 #define COND_PRIO (COMMA_PRIO+2)
641 #define OROR_PRIO (COND_PRIO+2)
642 #define ANDAND_PRIO (OROR_PRIO+2)
643 #define OR_PRIO (ANDAND_PRIO+2)
644 #define XOR_PRIO (OR_PRIO+2)
645 #define AND_PRIO (XOR_PRIO+2)
646 #define EQUAL_PRIO (AND_PRIO+2)
647 #define LESS_PRIO (EQUAL_PRIO+2)
648 #define SHIFT_PRIO (LESS_PRIO+2)
649 #define PLUS_PRIO (SHIFT_PRIO+2)
650 #define MUL_PRIO (PLUS_PRIO+2)
651 #define UNARY_PRIO (MUL_PRIO+2)
652 #define PAREN_OUTER_PRIO (UNARY_PRIO+2)
654 #define COMPARE(OP) \
656 top->value = (unsigned1 || unsigned2) ? (unsigned long) v1 OP v2 : (v1 OP v2)
658 /* Parse and evaluate a C expression, reading from PFILE.
659 Returns the value of the expression. */
662 cpp_parse_expr (pfile
)
665 /* The implementation is an operator precedence parser,
666 i.e. a bottom-up parser, using a stack for not-yet-reduced tokens.
668 The stack base is 'stack', and the current stack pointer is 'top'.
669 There is a stack element for each operator (only),
670 and the most recently pushed operator is 'top->op'.
671 An operand (value) is stored in the 'value' field of the stack
672 element of the operator that precedes it.
673 In that case the 'flags' field has the HAVE_VALUE flag set. */
675 #define INIT_STACK_SIZE 20
676 struct operation init_stack
[INIT_STACK_SIZE
];
677 struct operation
*stack
= init_stack
;
678 struct operation
*limit
= stack
+ INIT_STACK_SIZE
;
679 register struct operation
*top
= stack
;
681 int skip_evaluation
= 0;
691 op
= cpp_lex (pfile
, skip_evaluation
);
693 /* See if the token is an operand, in which case go to set_value.
694 If the token is an operator, figure out its left and right
695 priorities, and then goto maybe_reduce. */
702 top
->value
= op
.value
;
703 top
->unsignedp
= op
.unsignedp
;
706 lprio
= 0; goto maybe_reduce
;
708 /* Is this correct if unary ? FIXME */
709 flags
= RIGHT_OPERAND_REQUIRED
;
710 lprio
= PLUS_PRIO
; rprio
= lprio
+ 1; goto maybe_reduce
;
712 flags
= RIGHT_OPERAND_REQUIRED
;
713 rprio
= UNARY_PRIO
; lprio
= rprio
+ 1; goto maybe_reduce
;
714 case '*': case '/': case '%':
715 lprio
= MUL_PRIO
; goto binop
;
716 case '<': case '>': case LEQ
: case GEQ
:
717 lprio
= LESS_PRIO
; goto binop
;
718 case EQUAL
: case NOTEQUAL
:
719 lprio
= EQUAL_PRIO
; goto binop
;
721 lprio
= SHIFT_PRIO
; goto binop
;
722 case '&': lprio
= AND_PRIO
; goto binop
;
723 case '^': lprio
= XOR_PRIO
; goto binop
;
724 case '|': lprio
= OR_PRIO
; goto binop
;
725 case ANDAND
: lprio
= ANDAND_PRIO
; goto binop
;
726 case OROR
: lprio
= OROR_PRIO
; goto binop
;
728 lprio
= COMMA_PRIO
; goto binop
;
730 lprio
= PAREN_OUTER_PRIO
; rprio
= PAREN_INNER_PRIO
;
733 lprio
= PAREN_INNER_PRIO
; rprio
= PAREN_OUTER_PRIO
;
736 lprio
= COND_PRIO
; rprio
= COND_PRIO
;
739 lprio
= COND_PRIO
+ 1; rprio
= COND_PRIO
;
742 flags
= LEFT_OPERAND_REQUIRED
|RIGHT_OPERAND_REQUIRED
;
746 cpp_error (pfile
, "invalid character in #if");
751 /* Push a value onto the stack. */
752 if (top
->flags
& HAVE_VALUE
)
754 cpp_error (pfile
, "syntax error in #if");
757 top
->flags
|= HAVE_VALUE
;
761 /* Push an operator, and check if we can reduce now. */
762 while (top
->rprio
> lprio
)
764 long v1
= top
[-1].value
, v2
= top
[0].value
;
765 int unsigned1
= top
[-1].unsignedp
, unsigned2
= top
[0].unsignedp
;
767 if ((top
[1].flags
& LEFT_OPERAND_REQUIRED
)
768 && ! (top
[0].flags
& HAVE_VALUE
))
770 cpp_error (pfile
, "syntax error - missing left operand");
773 if ((top
[1].flags
& RIGHT_OPERAND_REQUIRED
)
774 && ! (top
[1].flags
& HAVE_VALUE
))
776 cpp_error (pfile
, "syntax error - missing right operand");
779 /* top[0].value = (top[1].op)(v1, v2);*/
783 if (!(top
->flags
& HAVE_VALUE
))
786 top
->unsignedp
= unsigned2
;
787 top
->flags
|= HAVE_VALUE
;
791 top
->value
= v1
+ v2
;
792 top
->unsignedp
= unsigned1
|| unsigned2
;
793 if (! top
->unsignedp
&& ! skip_evaluation
794 && ! possible_sum_sign (v1
, v2
, top
->value
))
795 integer_overflow (pfile
);
799 if (!(top
->flags
& HAVE_VALUE
))
802 if (!skip_evaluation
&& (top
->value
& v2
) < 0 && !unsigned2
)
803 integer_overflow (pfile
);
804 top
->unsignedp
= unsigned2
;
805 top
->flags
|= HAVE_VALUE
;
809 top
->value
= v1
- v2
;
810 top
->unsignedp
= unsigned1
|| unsigned2
;
811 if (! top
->unsignedp
&& ! skip_evaluation
812 && ! possible_sum_sign (top
->value
, v2
, v1
))
813 integer_overflow (pfile
);
817 top
->unsignedp
= unsigned1
|| unsigned2
;
819 top
->value
= (unsigned long) v1
* v2
;
820 else if (!skip_evaluation
)
822 top
->value
= v1
* v2
;
824 && (top
->value
/ v1
!= v2
825 || (top
->value
& v1
& v2
) < 0))
826 integer_overflow (pfile
);
834 cpp_error (pfile
, "division by zero in #if");
837 top
->unsignedp
= unsigned1
|| unsigned2
;
839 top
->value
= (unsigned long) v1
/ v2
;
842 top
->value
= v1
/ v2
;
843 if ((top
->value
& v1
& v2
) < 0)
844 integer_overflow (pfile
);
852 cpp_error (pfile
, "division by zero in #if");
855 top
->unsignedp
= unsigned1
|| unsigned2
;
857 top
->value
= (unsigned long) v1
% v2
;
859 top
->value
= v1
% v2
;
862 if (top
->flags
& HAVE_VALUE
)
864 cpp_error (pfile
, "syntax error");
869 top
->flags
|= HAVE_VALUE
;
872 if (top
->flags
& HAVE_VALUE
)
874 cpp_error (pfile
, "syntax error");
878 top
->unsignedp
= unsigned2
;
879 top
->flags
|= HAVE_VALUE
;
881 case '<': COMPARE(<); break;
882 case '>': COMPARE(>); break;
883 case LEQ
: COMPARE(<=); break;
884 case GEQ
: COMPARE(>=); break;
886 top
->value
= (v1
== v2
);
890 top
->value
= (v1
!= v2
);
896 top
->unsignedp
= unsigned1
;
897 if (v2
< 0 && ! unsigned2
)
898 top
->value
= right_shift (pfile
, v1
, unsigned1
, -v2
);
900 top
->value
= left_shift (pfile
, v1
, unsigned1
, v2
);
905 top
->unsignedp
= unsigned1
;
906 if (v2
< 0 && ! unsigned2
)
907 top
->value
= left_shift (pfile
, v1
, unsigned1
, -v2
);
909 top
->value
= right_shift (pfile
, v1
, unsigned1
, v2
);
911 #define LOGICAL(OP) \
912 top->value = v1 OP v2;\
913 top->unsignedp = unsigned1 || unsigned2;
914 case '&': LOGICAL(&); break;
915 case '^': LOGICAL(^); break;
916 case '|': LOGICAL(|); break;
918 top
->value
= v1
&& v2
; top
->unsignedp
= 0;
919 if (!v1
) skip_evaluation
--;
922 top
->value
= v1
|| v2
; top
->unsignedp
= 0;
923 if (v1
) skip_evaluation
--;
926 if (CPP_PEDANTIC (pfile
))
927 cpp_pedwarn (pfile
, "comma operator in operand of `#if'");
929 top
->unsignedp
= unsigned2
;
932 cpp_error (pfile
, "syntax error in #if");
935 if (top
[0].op
!= '?')
938 "syntax error ':' without preceding '?'");
941 else if (! (top
[1].flags
& HAVE_VALUE
)
942 || !(top
[-1].flags
& HAVE_VALUE
)
943 || !(top
[0].flags
& HAVE_VALUE
))
945 cpp_error (pfile
, "bad syntax for ?: operator");
951 if (top
->value
) skip_evaluation
--;
952 top
->value
= top
->value
? v1
: v2
;
953 top
->unsignedp
= unsigned1
|| unsigned2
;
957 if ((top
[1].flags
& HAVE_VALUE
)
958 || ! (top
[0].flags
& HAVE_VALUE
)
960 || (top
[-1].flags
& HAVE_VALUE
))
962 cpp_error (pfile
, "mismatched parentheses in #if");
969 top
->unsignedp
= unsigned1
;
970 top
->flags
|= HAVE_VALUE
;
975 top
[1].op
>= ' ' && top
[1].op
<= '~'
976 ? "unimplemented operator '%c'\n"
977 : "unimplemented operator '\\%03o'\n",
984 cpp_error (pfile
, "internal error in #if expression");
985 if (stack
!= init_stack
)
991 /* Check for and handle stack overflow. */
994 struct operation
*new_stack
;
995 int old_size
= (char *) limit
- (char *) stack
;
996 int new_size
= 2 * old_size
;
997 if (stack
!= init_stack
)
998 new_stack
= (struct operation
*) xrealloc (stack
, new_size
);
1001 new_stack
= (struct operation
*) xmalloc (new_size
);
1002 bcopy ((char *) stack
, (char *) new_stack
, old_size
);
1005 top
= (struct operation
*) ((char *) new_stack
+ old_size
);
1006 limit
= (struct operation
*) ((char *) new_stack
+ new_size
);
1012 if ((op
.op
== OROR
&& top
[-1].value
)
1013 || (op
.op
== ANDAND
&& !top
[-1].value
)
1014 || (op
.op
== '?' && !top
[-1].value
))
1018 else if (op
.op
== ':')
1020 if (top
[-2].value
) /* Was condition true? */
1027 if (stack
!= init_stack
)
1029 skip_rest_of_line (pfile
);