1 /* RTL reader for GCC.
2    Copyright (C) 1987-2014 Free Software Foundation, Inc.
3 
4 This file is part of GCC.
5 
6 GCC is free software; you can redistribute it and/or modify it under
7 the terms of the GNU General Public License as published by the Free
8 Software Foundation; either version 3, or (at your option) any later
9 version.
10 
11 GCC is distributed in the hope that it will be useful, but WITHOUT ANY
12 WARRANTY; without even the implied warranty of MERCHANTABILITY or
13 FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
14 for more details.
15 
16 You should have received a copy of the GNU General Public License
17 along with GCC; see the file COPYING3.  If not see
18 <http://www.gnu.org/licenses/>.  */
19 
20 #include "bconfig.h"
21 
22 /* Disable rtl checking; it conflicts with the iterator handling.  */
23 #undef ENABLE_RTL_CHECKING
24 
25 #include "system.h"
26 #include "coretypes.h"
27 #include "tm.h"
28 #include "rtl.h"
29 #include "obstack.h"
30 #include "hashtab.h"
31 #include "read-md.h"
32 #include "gensupport.h"
33 
34 /* One element in a singly-linked list of (integer, string) pairs.  */
35 struct map_value {
36   struct map_value *next;
37   int number;
38   const char *string;
39 };
40 
41 /* Maps an iterator or attribute name to a list of (integer, string) pairs.
42    The integers are iterator values; the strings are either C conditions
43    or attribute values.  */
44 struct mapping {
45   /* The name of the iterator or attribute.  */
46   const char *name;
47 
48   /* The group (modes or codes) to which the iterator or attribute belongs.  */
49   struct iterator_group *group;
50 
51   /* The list of (integer, string) pairs.  */
52   struct map_value *values;
53 
54   /* For iterators, records the current value of the iterator.  */
55   struct map_value *current_value;
56 };
57 
58 /* Vector definitions for the above.  */
59 typedef struct mapping *mapping_ptr;
60 
61 /* A structure for abstracting the common parts of iterators.  */
62 struct iterator_group {
63   /* Tables of "mapping" structures, one for attributes and one for
64      iterators.  */
65   htab_t attrs, iterators;
66 
67   /* Treat the given string as the name of a standard mode, etc., and
68      return its integer value.  */
69   int (*find_builtin) (const char *);
70 
71   /* Make the given pointer use the given iterator value.  */
72   void (*apply_iterator) (void *, int);
73 };
74 
75 /* Records one use of an iterator.  */
76 struct iterator_use {
77   /* The iterator itself.  */
78   struct mapping *iterator;
79 
80   /* The location of the use, as passed to the apply_iterator callback.  */
81   void *ptr;
82 };
83 
84 /* Vector definitions for the above.  */
85 typedef struct iterator_use iterator_use;
86 
87 /* Records one use of an attribute (the "<[iterator:]attribute>" syntax)
88    in a non-string rtx field.  */
89 struct attribute_use {
90   /* The group that describes the use site.  */
91   struct iterator_group *group;
92 
93   /* The name of the attribute, possibly with an "iterator:" prefix.  */
94   const char *value;
95 
96   /* The location of the use, as passed to GROUP's apply_iterator callback.  */
97   void *ptr;
98 };
99 
100 /* Vector definitions for the above.  */
101 typedef struct attribute_use attribute_use;
102 
103 /* This struct is used to link subst_attr named ATTR_NAME with
104    corresponding define_subst named ITER_NAME.  */
105 struct subst_attr_to_iter_mapping
106 {
107     char *attr_name;
108     char *iter_name;
109 };
110 
111 /* Hash-table to store links between subst-attributes and
112    define_substs.  */
113 htab_t subst_attr_to_iter_map = NULL;
114 /* This global stores name of subst-iterator which is currently being
115    processed.  */
116 const char *current_iterator_name;
117 
118 static void validate_const_int (const char *);
119 static rtx read_rtx_code (const char *);
120 static rtx read_nested_rtx (void);
121 static rtx read_rtx_variadic (rtx);
122 
123 /* The mode and code iterator structures.  */
124 static struct iterator_group modes, codes, ints, substs;
125 
126 /* All iterators used in the current rtx.  */
127 static vec<mapping_ptr> current_iterators;
128 
129 /* The list of all iterator uses in the current rtx.  */
130 static vec<iterator_use> iterator_uses;
131 
132 /* The list of all attribute uses in the current rtx.  */
133 static vec<attribute_use> attribute_uses;
134 
135 /* Implementations of the iterator_group callbacks for modes.  */
136 
137 static int
find_mode(const char * name)138 find_mode (const char *name)
139 {
140   int i;
141 
142   for (i = 0; i < NUM_MACHINE_MODES; i++)
143     if (strcmp (GET_MODE_NAME (i), name) == 0)
144       return i;
145 
146   fatal_with_file_and_line ("unknown mode `%s'", name);
147 }
148 
149 static void
apply_mode_iterator(void * loc,int mode)150 apply_mode_iterator (void *loc, int mode)
151 {
152   PUT_MODE ((rtx) loc, (enum machine_mode) mode);
153 }
154 
155 /* Implementations of the iterator_group callbacks for codes.  */
156 
157 static int
find_code(const char * name)158 find_code (const char *name)
159 {
160   int i;
161 
162   for (i = 0; i < NUM_RTX_CODE; i++)
163     if (strcmp (GET_RTX_NAME (i), name) == 0)
164       return i;
165 
166   fatal_with_file_and_line ("unknown rtx code `%s'", name);
167 }
168 
169 static void
apply_code_iterator(void * loc,int code)170 apply_code_iterator (void *loc, int code)
171 {
172   PUT_CODE ((rtx) loc, (enum rtx_code) code);
173 }
174 
175 /* Implementations of the iterator_group callbacks for ints.  */
176 
177 /* Since GCC does not construct a table of valid constants,
178    we have to accept any int as valid.  No cross-checking can
179    be done.  */
180 
181 static int
find_int(const char * name)182 find_int (const char *name)
183 {
184   validate_const_int (name);
185   return atoi (name);
186 }
187 
188 static void
apply_int_iterator(void * loc,int value)189 apply_int_iterator (void *loc, int value)
190 {
191   *(int *)loc = value;
192 }
193 
194 /* This routine adds attribute or does nothing depending on VALUE.  When
195    VALUE is 1, it does nothing - the first duplicate of original
196    template is kept untouched when it's subjected to a define_subst.
197    When VALUE isn't 1, the routine modifies RTL-template LOC, adding
198    attribute, named exactly as define_subst, which later will be
199    applied.  If such attribute has already been added, then no the
200    routine has no effect.  */
201 static void
apply_subst_iterator(void * loc,int value)202 apply_subst_iterator (void *loc, int value)
203 {
204   rtx rt = (rtx)loc;
205   rtx new_attr;
206   rtvec attrs_vec, new_attrs_vec;
207   int i;
208   if (value == 1)
209     return;
210   gcc_assert (GET_CODE (rt) == DEFINE_INSN
211 	      || GET_CODE (rt) == DEFINE_EXPAND);
212 
213   attrs_vec = XVEC (rt, 4);
214 
215   /* If we've already added attribute 'current_iterator_name', then we
216      have nothing to do now.  */
217   if (attrs_vec)
218     {
219       for (i = 0; i < GET_NUM_ELEM (attrs_vec); i++)
220 	{
221 	  if (strcmp (XSTR (attrs_vec->elem[i], 0), current_iterator_name) == 0)
222 	    return;
223 	}
224     }
225 
226   /* Add attribute with subst name - it serves as a mark for
227      define_subst which later would be applied to this pattern.  */
228   new_attr = rtx_alloc (SET_ATTR);
229   PUT_CODE (new_attr, SET_ATTR);
230   XSTR (new_attr, 0) = xstrdup (current_iterator_name);
231   XSTR (new_attr, 1) = xstrdup ("yes");
232 
233   if (!attrs_vec)
234     {
235       new_attrs_vec = rtvec_alloc (1);
236       new_attrs_vec->elem[0] = new_attr;
237     }
238   else
239     {
240       new_attrs_vec = rtvec_alloc (GET_NUM_ELEM (attrs_vec) + 1);
241       memcpy (&new_attrs_vec->elem[0], &attrs_vec->elem[0],
242 	      GET_NUM_ELEM (attrs_vec) * sizeof (rtx));
243       new_attrs_vec->elem[GET_NUM_ELEM (attrs_vec)] = new_attr;
244     }
245   XVEC (rt, 4) = new_attrs_vec;
246 }
247 
248 /* Map subst-attribute ATTR to subst iterator ITER.  */
249 
250 static void
bind_subst_iter_and_attr(const char * iter,const char * attr)251 bind_subst_iter_and_attr (const char *iter, const char *attr)
252 {
253   struct subst_attr_to_iter_mapping *value;
254   void **slot;
255   if (!subst_attr_to_iter_map)
256     subst_attr_to_iter_map =
257       htab_create (1, leading_string_hash, leading_string_eq_p, 0);
258   value = XNEW (struct subst_attr_to_iter_mapping);
259   value->attr_name = xstrdup (attr);
260   value->iter_name = xstrdup (iter);
261   slot = htab_find_slot (subst_attr_to_iter_map, value, INSERT);
262   *slot = value;
263 }
264 
265 /* Return name of a subst-iterator, corresponding to subst-attribute ATTR.  */
266 
267 static char*
find_subst_iter_by_attr(const char * attr)268 find_subst_iter_by_attr (const char *attr)
269 {
270   char *iter_name = NULL;
271   struct subst_attr_to_iter_mapping *value;
272   value = (struct subst_attr_to_iter_mapping*)
273     htab_find (subst_attr_to_iter_map, &attr);
274   if (value)
275     iter_name = value->iter_name;
276   return iter_name;
277 }
278 
279 /* Map attribute string P to its current value.  Return null if the attribute
280    isn't known.  */
281 
282 static struct map_value *
map_attr_string(const char * p)283 map_attr_string (const char *p)
284 {
285   const char *attr;
286   struct mapping *iterator;
287   unsigned int i;
288   struct mapping *m;
289   struct map_value *v;
290   int iterator_name_len;
291 
292   /* Peel off any "iterator:" prefix.  Set ATTR to the start of the
293      attribute name.  */
294   attr = strchr (p, ':');
295   if (attr == 0)
296     {
297       iterator_name_len = -1;
298       attr = p;
299     }
300   else
301     {
302       iterator_name_len = attr - p;
303       attr++;
304     }
305 
306   FOR_EACH_VEC_ELT (current_iterators, i, iterator)
307     {
308       /* If an iterator name was specified, check that it matches.  */
309       if (iterator_name_len >= 0
310 	  && (strncmp (p, iterator->name, iterator_name_len) != 0
311 	      || iterator->name[iterator_name_len] != 0))
312 	continue;
313 
314       /* Find the attribute specification.  */
315       m = (struct mapping *) htab_find (iterator->group->attrs, &attr);
316       if (m)
317 	{
318 	  /* In contrast to code/mode/int iterators, attributes of subst
319 	     iterators are linked to one specific subst-iterator.  So, if
320 	     we are dealing with subst-iterator, we should check if it's
321 	     the one which linked with the given attribute.  */
322 	  if (iterator->group == &substs)
323 	    {
324 	      char *iter_name = find_subst_iter_by_attr (attr);
325 	      if (strcmp (iter_name, iterator->name) != 0)
326 		continue;
327 	    }
328 	  /* Find the attribute value associated with the current
329 	     iterator value.  */
330 	  for (v = m->values; v; v = v->next)
331 	    if (v->number == iterator->current_value->number)
332 	      return v;
333 	}
334     }
335   return NULL;
336 }
337 
338 /* Apply the current iterator values to STRING.  Return the new string
339    if any changes were needed, otherwise return STRING itself.  */
340 
341 static const char *
apply_iterator_to_string(const char * string)342 apply_iterator_to_string (const char *string)
343 {
344   char *base, *copy, *p, *start, *end;
345   struct map_value *v;
346 
347   if (string == 0)
348     return string;
349 
350   base = p = copy = ASTRDUP (string);
351   while ((start = strchr (p, '<')) && (end = strchr (start, '>')))
352     {
353       p = start + 1;
354 
355       *end = 0;
356       v = map_attr_string (p);
357       *end = '>';
358       if (v == 0)
359 	continue;
360 
361       /* Add everything between the last copied byte and the '<',
362 	 then add in the attribute value.  */
363       obstack_grow (&string_obstack, base, start - base);
364       obstack_grow (&string_obstack, v->string, strlen (v->string));
365       base = end + 1;
366     }
367   if (base != copy)
368     {
369       obstack_grow (&string_obstack, base, strlen (base) + 1);
370       copy = XOBFINISH (&string_obstack, char *);
371       copy_md_ptr_loc (copy, string);
372       return copy;
373     }
374   return string;
375 }
376 
377 /* Return a deep copy of X, substituting the current iterator
378    values into any strings.  */
379 
380 static rtx
copy_rtx_for_iterators(rtx original)381 copy_rtx_for_iterators (rtx original)
382 {
383   const char *format_ptr, *p;
384   int i, j;
385   rtx x;
386 
387   if (original == 0)
388     return original;
389 
390   /* Create a shallow copy of ORIGINAL.  */
391   x = rtx_alloc (GET_CODE (original));
392   memcpy (x, original, RTX_CODE_SIZE (GET_CODE (original)));
393 
394   /* Change each string and recursively change each rtx.  */
395   format_ptr = GET_RTX_FORMAT (GET_CODE (original));
396   for (i = 0; format_ptr[i] != 0; i++)
397     switch (format_ptr[i])
398       {
399       case 'T':
400 	while (XTMPL (x, i) != (p = apply_iterator_to_string (XTMPL (x, i))))
401 	  XTMPL (x, i) = p;
402 	break;
403 
404       case 'S':
405       case 's':
406 	while (XSTR (x, i) != (p = apply_iterator_to_string (XSTR (x, i))))
407 	  XSTR (x, i) = p;
408 	break;
409 
410       case 'e':
411 	XEXP (x, i) = copy_rtx_for_iterators (XEXP (x, i));
412 	break;
413 
414       case 'V':
415       case 'E':
416 	if (XVEC (original, i))
417 	  {
418 	    XVEC (x, i) = rtvec_alloc (XVECLEN (original, i));
419 	    for (j = 0; j < XVECLEN (x, i); j++)
420 	      XVECEXP (x, i, j)
421 		= copy_rtx_for_iterators (XVECEXP (original, i, j));
422 	  }
423 	break;
424 
425       default:
426 	break;
427       }
428   return x;
429 }
430 
431 /* Return a condition that must satisfy both ORIGINAL and EXTRA.  If ORIGINAL
432    has the form "&& ..." (as used in define_insn_and_splits), assume that
433    EXTRA is already satisfied.  Empty strings are treated like "true".  */
434 
435 static const char *
add_condition_to_string(const char * original,const char * extra)436 add_condition_to_string (const char *original, const char *extra)
437 {
438   if (original != 0 && original[0] == '&' && original[1] == '&')
439     return original;
440   return join_c_conditions (original, extra);
441 }
442 
443 /* Like add_condition, but applied to all conditions in rtx X.  */
444 
445 static void
add_condition_to_rtx(rtx x,const char * extra)446 add_condition_to_rtx (rtx x, const char *extra)
447 {
448   switch (GET_CODE (x))
449     {
450     case DEFINE_INSN:
451     case DEFINE_EXPAND:
452     case DEFINE_SUBST:
453       XSTR (x, 2) = add_condition_to_string (XSTR (x, 2), extra);
454       break;
455 
456     case DEFINE_SPLIT:
457     case DEFINE_PEEPHOLE:
458     case DEFINE_PEEPHOLE2:
459     case DEFINE_COND_EXEC:
460       XSTR (x, 1) = add_condition_to_string (XSTR (x, 1), extra);
461       break;
462 
463     case DEFINE_INSN_AND_SPLIT:
464       XSTR (x, 2) = add_condition_to_string (XSTR (x, 2), extra);
465       XSTR (x, 4) = add_condition_to_string (XSTR (x, 4), extra);
466       break;
467 
468     default:
469       break;
470     }
471 }
472 
473 /* Apply the current iterator values to all attribute_uses.  */
474 
475 static void
apply_attribute_uses(void)476 apply_attribute_uses (void)
477 {
478   struct map_value *v;
479   attribute_use *ause;
480   unsigned int i;
481 
482   FOR_EACH_VEC_ELT (attribute_uses, i, ause)
483     {
484       v = map_attr_string (ause->value);
485       if (!v)
486 	fatal_with_file_and_line ("unknown iterator value `%s'", ause->value);
487       ause->group->apply_iterator (ause->ptr,
488 				   ause->group->find_builtin (v->string));
489     }
490 }
491 
492 /* A htab_traverse callback for iterators.  Add all used iterators
493    to current_iterators.  */
494 
495 static int
add_current_iterators(void ** slot,void * data ATTRIBUTE_UNUSED)496 add_current_iterators (void **slot, void *data ATTRIBUTE_UNUSED)
497 {
498   struct mapping *iterator;
499 
500   iterator = (struct mapping *) *slot;
501   if (iterator->current_value)
502     current_iterators.safe_push (iterator);
503   return 1;
504 }
505 
506 /* Expand all iterators in the current rtx, which is given as ORIGINAL.
507    Build a list of expanded rtxes in the EXPR_LIST pointed to by QUEUE.  */
508 
509 static void
apply_iterators(rtx original,rtx * queue)510 apply_iterators (rtx original, rtx *queue)
511 {
512   unsigned int i;
513   const char *condition;
514   iterator_use *iuse;
515   struct mapping *iterator;
516   struct map_value *v;
517   rtx x;
518 
519   if (iterator_uses.is_empty ())
520     {
521       /* Raise an error if any attributes were used.  */
522       apply_attribute_uses ();
523       XEXP (*queue, 0) = original;
524       XEXP (*queue, 1) = NULL_RTX;
525       return;
526     }
527 
528   /* Clear out the iterators from the previous run.  */
529   FOR_EACH_VEC_ELT (current_iterators, i, iterator)
530     iterator->current_value = NULL;
531   current_iterators.truncate (0);
532 
533   /* Mark the iterators that we need this time.  */
534   FOR_EACH_VEC_ELT (iterator_uses, i, iuse)
535     iuse->iterator->current_value = iuse->iterator->values;
536 
537   /* Get the list of iterators that are in use, preserving the
538      definition order within each group.  */
539   htab_traverse (modes.iterators, add_current_iterators, NULL);
540   htab_traverse (codes.iterators, add_current_iterators, NULL);
541   htab_traverse (ints.iterators, add_current_iterators, NULL);
542   htab_traverse (substs.iterators, add_current_iterators, NULL);
543   gcc_assert (!current_iterators.is_empty ());
544 
545   for (;;)
546     {
547       /* Apply the current iterator values.  Accumulate a condition to
548 	 say when the resulting rtx can be used.  */
549       condition = "";
550       FOR_EACH_VEC_ELT (iterator_uses, i, iuse)
551 	{
552 	  if (iuse->iterator->group == &substs)
553 	    continue;
554 	  v = iuse->iterator->current_value;
555 	  iuse->iterator->group->apply_iterator (iuse->ptr, v->number);
556 	  condition = join_c_conditions (condition, v->string);
557 	}
558       apply_attribute_uses ();
559       x = copy_rtx_for_iterators (original);
560       add_condition_to_rtx (x, condition);
561 
562       /* We apply subst iterator after RTL-template is copied, as during
563 	 subst-iterator processing, we could add an attribute to the
564 	 RTL-template, and we don't want to do it in the original one.  */
565       FOR_EACH_VEC_ELT (iterator_uses, i, iuse)
566 	{
567 	  v = iuse->iterator->current_value;
568 	  if (iuse->iterator->group == &substs)
569 	    {
570 	      iuse->ptr = x;
571 	      current_iterator_name = iuse->iterator->name;
572 	      iuse->iterator->group->apply_iterator (iuse->ptr, v->number);
573 	    }
574 	}
575       /* Add the new rtx to the end of the queue.  */
576       XEXP (*queue, 0) = x;
577       XEXP (*queue, 1) = NULL_RTX;
578 
579       /* Lexicographically increment the iterator value sequence.
580 	 That is, cycle through iterator values, starting from the right,
581 	 and stopping when one of them doesn't wrap around.  */
582       i = current_iterators.length ();
583       for (;;)
584 	{
585 	  if (i == 0)
586 	    return;
587 	  i--;
588 	  iterator = current_iterators[i];
589 	  iterator->current_value = iterator->current_value->next;
590 	  if (iterator->current_value)
591 	    break;
592 	  iterator->current_value = iterator->values;
593 	}
594 
595       /* At least one more rtx to go.  Allocate room for it.  */
596       XEXP (*queue, 1) = rtx_alloc (EXPR_LIST);
597       queue = &XEXP (*queue, 1);
598     }
599 }
600 
601 /* Add a new "mapping" structure to hashtable TABLE.  NAME is the name
602    of the mapping and GROUP is the group to which it belongs.  */
603 
604 static struct mapping *
add_mapping(struct iterator_group * group,htab_t table,const char * name)605 add_mapping (struct iterator_group *group, htab_t table, const char *name)
606 {
607   struct mapping *m;
608   void **slot;
609 
610   m = XNEW (struct mapping);
611   m->name = xstrdup (name);
612   m->group = group;
613   m->values = 0;
614   m->current_value = NULL;
615 
616   slot = htab_find_slot (table, m, INSERT);
617   if (*slot != 0)
618     fatal_with_file_and_line ("`%s' already defined", name);
619 
620   *slot = m;
621   return m;
622 }
623 
624 /* Add the pair (NUMBER, STRING) to a list of map_value structures.
625    END_PTR points to the current null terminator for the list; return
626    a pointer the new null terminator.  */
627 
628 static struct map_value **
add_map_value(struct map_value ** end_ptr,int number,const char * string)629 add_map_value (struct map_value **end_ptr, int number, const char *string)
630 {
631   struct map_value *value;
632 
633   value = XNEW (struct map_value);
634   value->next = 0;
635   value->number = number;
636   value->string = string;
637 
638   *end_ptr = value;
639   return &value->next;
640 }
641 
642 /* Do one-time initialization of the mode and code attributes.  */
643 
644 static void
initialize_iterators(void)645 initialize_iterators (void)
646 {
647   struct mapping *lower, *upper;
648   struct map_value **lower_ptr, **upper_ptr;
649   char *copy, *p;
650   int i;
651 
652   modes.attrs = htab_create (13, leading_string_hash, leading_string_eq_p, 0);
653   modes.iterators = htab_create (13, leading_string_hash,
654 				 leading_string_eq_p, 0);
655   modes.find_builtin = find_mode;
656   modes.apply_iterator = apply_mode_iterator;
657 
658   codes.attrs = htab_create (13, leading_string_hash, leading_string_eq_p, 0);
659   codes.iterators = htab_create (13, leading_string_hash,
660 				 leading_string_eq_p, 0);
661   codes.find_builtin = find_code;
662   codes.apply_iterator = apply_code_iterator;
663 
664   ints.attrs = htab_create (13, leading_string_hash, leading_string_eq_p, 0);
665   ints.iterators = htab_create (13, leading_string_hash,
666 				 leading_string_eq_p, 0);
667   ints.find_builtin = find_int;
668   ints.apply_iterator = apply_int_iterator;
669 
670   substs.attrs = htab_create (13, leading_string_hash, leading_string_eq_p, 0);
671   substs.iterators = htab_create (13, leading_string_hash,
672 				 leading_string_eq_p, 0);
673   substs.find_builtin = find_int; /* We don't use it, anyway.  */
674   substs.apply_iterator = apply_subst_iterator;
675 
676   lower = add_mapping (&modes, modes.attrs, "mode");
677   upper = add_mapping (&modes, modes.attrs, "MODE");
678   lower_ptr = &lower->values;
679   upper_ptr = &upper->values;
680   for (i = 0; i < MAX_MACHINE_MODE; i++)
681     {
682       copy = xstrdup (GET_MODE_NAME (i));
683       for (p = copy; *p != 0; p++)
684 	*p = TOLOWER (*p);
685 
686       upper_ptr = add_map_value (upper_ptr, i, GET_MODE_NAME (i));
687       lower_ptr = add_map_value (lower_ptr, i, copy);
688     }
689 
690   lower = add_mapping (&codes, codes.attrs, "code");
691   upper = add_mapping (&codes, codes.attrs, "CODE");
692   lower_ptr = &lower->values;
693   upper_ptr = &upper->values;
694   for (i = 0; i < NUM_RTX_CODE; i++)
695     {
696       copy = xstrdup (GET_RTX_NAME (i));
697       for (p = copy; *p != 0; p++)
698 	*p = TOUPPER (*p);
699 
700       lower_ptr = add_map_value (lower_ptr, i, GET_RTX_NAME (i));
701       upper_ptr = add_map_value (upper_ptr, i, copy);
702     }
703 }
704 
705 /* Provide a version of a function to read a long long if the system does
706    not provide one.  */
707 #if HOST_BITS_PER_WIDE_INT > HOST_BITS_PER_LONG && !defined(HAVE_ATOLL) && !defined(HAVE_ATOQ)
708 HOST_WIDE_INT atoll (const char *);
709 
710 HOST_WIDE_INT
atoll(const char * p)711 atoll (const char *p)
712 {
713   int neg = 0;
714   HOST_WIDE_INT tmp_wide;
715 
716   while (ISSPACE (*p))
717     p++;
718   if (*p == '-')
719     neg = 1, p++;
720   else if (*p == '+')
721     p++;
722 
723   tmp_wide = 0;
724   while (ISDIGIT (*p))
725     {
726       HOST_WIDE_INT new_wide = tmp_wide*10 + (*p - '0');
727       if (new_wide < tmp_wide)
728 	{
729 	  /* Return INT_MAX equiv on overflow.  */
730 	  tmp_wide = (~(unsigned HOST_WIDE_INT) 0) >> 1;
731 	  break;
732 	}
733       tmp_wide = new_wide;
734       p++;
735     }
736 
737   if (neg)
738     tmp_wide = -tmp_wide;
739   return tmp_wide;
740 }
741 #endif
742 
743 /* Process a define_conditions directive, starting with the optional
744    space after the "define_conditions".  The directive looks like this:
745 
746      (define_conditions [
747         (number "string")
748         (number "string")
749         ...
750      ])
751 
752    It's not intended to appear in machine descriptions.  It is
753    generated by (the program generated by) genconditions.c, and
754    slipped in at the beginning of the sequence of MD files read by
755    most of the other generators.  */
756 static void
read_conditions(void)757 read_conditions (void)
758 {
759   int c;
760 
761   c = read_skip_spaces ();
762   if (c != '[')
763     fatal_expected_char ('[', c);
764 
765   while ( (c = read_skip_spaces ()) != ']')
766     {
767       struct md_name name;
768       char *expr;
769       int value;
770 
771       if (c != '(')
772 	fatal_expected_char ('(', c);
773 
774       read_name (&name);
775       validate_const_int (name.string);
776       value = atoi (name.string);
777 
778       c = read_skip_spaces ();
779       if (c != '"')
780 	fatal_expected_char ('"', c);
781       expr = read_quoted_string ();
782 
783       c = read_skip_spaces ();
784       if (c != ')')
785 	fatal_expected_char (')', c);
786 
787       add_c_test (expr, value);
788     }
789 }
790 
791 static void
validate_const_int(const char * string)792 validate_const_int (const char *string)
793 {
794   const char *cp;
795   int valid = 1;
796 
797   cp = string;
798   while (*cp && ISSPACE (*cp))
799     cp++;
800   if (*cp == '-' || *cp == '+')
801     cp++;
802   if (*cp == 0)
803     valid = 0;
804   for (; *cp; cp++)
805     if (! ISDIGIT (*cp))
806       {
807         valid = 0;
808 	break;
809       }
810   if (!valid)
811     fatal_with_file_and_line ("invalid decimal constant \"%s\"\n", string);
812 }
813 
814 /* Record that PTR uses iterator ITERATOR.  */
815 
816 static void
record_iterator_use(struct mapping * iterator,void * ptr)817 record_iterator_use (struct mapping *iterator, void *ptr)
818 {
819   struct iterator_use iuse = {iterator, ptr};
820   iterator_uses.safe_push (iuse);
821 }
822 
823 /* Record that PTR uses attribute VALUE, which must match a built-in
824    value from group GROUP.  */
825 
826 static void
record_attribute_use(struct iterator_group * group,void * ptr,const char * value)827 record_attribute_use (struct iterator_group *group, void *ptr,
828 		      const char *value)
829 {
830   struct attribute_use ause = {group, value, ptr};
831   attribute_uses.safe_push (ause);
832 }
833 
834 /* Interpret NAME as either a built-in value, iterator or attribute
835    for group GROUP.  PTR is the value to pass to GROUP's apply_iterator
836    callback.  */
837 
838 static void
record_potential_iterator_use(struct iterator_group * group,void * ptr,const char * name)839 record_potential_iterator_use (struct iterator_group *group, void *ptr,
840 			       const char *name)
841 {
842   struct mapping *m;
843   size_t len;
844 
845   len = strlen (name);
846   if (name[0] == '<' && name[len - 1] == '>')
847     {
848       /* Copy the attribute string into permanent storage, without the
849 	 angle brackets around it.  */
850       obstack_grow0 (&string_obstack, name + 1, len - 2);
851       record_attribute_use (group, ptr, XOBFINISH (&string_obstack, char *));
852     }
853   else
854     {
855       m = (struct mapping *) htab_find (group->iterators, &name);
856       if (m != 0)
857 	record_iterator_use (m, ptr);
858       else
859 	group->apply_iterator (ptr, group->find_builtin (name));
860     }
861 }
862 
863 /* Finish reading a declaration of the form:
864 
865        (define... <name> [<value1> ... <valuen>])
866 
867    from the MD file, where each <valuei> is either a bare symbol name or a
868    "(<name> <string>)" pair.  The "(define..." part has already been read.
869 
870    Represent the declaration as a "mapping" structure; add it to TABLE
871    (which belongs to GROUP) and return it.  */
872 
873 static struct mapping *
read_mapping(struct iterator_group * group,htab_t table)874 read_mapping (struct iterator_group *group, htab_t table)
875 {
876   struct md_name name;
877   struct mapping *m;
878   struct map_value **end_ptr;
879   const char *string;
880   int number, c;
881 
882   /* Read the mapping name and create a structure for it.  */
883   read_name (&name);
884   m = add_mapping (group, table, name.string);
885 
886   c = read_skip_spaces ();
887   if (c != '[')
888     fatal_expected_char ('[', c);
889 
890   /* Read each value.  */
891   end_ptr = &m->values;
892   c = read_skip_spaces ();
893   do
894     {
895       if (c != '(')
896 	{
897 	  /* A bare symbol name that is implicitly paired to an
898 	     empty string.  */
899 	  unread_char (c);
900 	  read_name (&name);
901 	  string = "";
902 	}
903       else
904 	{
905 	  /* A "(name string)" pair.  */
906 	  read_name (&name);
907 	  string = read_string (false);
908 	  c = read_skip_spaces ();
909 	  if (c != ')')
910 	    fatal_expected_char (')', c);
911 	}
912       number = group->find_builtin (name.string);
913       end_ptr = add_map_value (end_ptr, number, string);
914       c = read_skip_spaces ();
915     }
916   while (c != ']');
917 
918   return m;
919 }
920 
921 /* For iterator with name ATTR_NAME generate define_attr with values
922    'yes' and 'no'.  This attribute is used to mark templates to which
923    define_subst ATTR_NAME should be applied.  This attribute is set and
924    defined implicitly and automatically.  */
925 static void
add_define_attr_for_define_subst(const char * attr_name,rtx * queue)926 add_define_attr_for_define_subst (const char *attr_name, rtx *queue)
927 {
928   rtx const_str, return_rtx;
929 
930   return_rtx = rtx_alloc (DEFINE_ATTR);
931   PUT_CODE (return_rtx, DEFINE_ATTR);
932 
933   const_str = rtx_alloc (CONST_STRING);
934   PUT_CODE (const_str, CONST_STRING);
935   XSTR (const_str, 0) = xstrdup ("no");
936 
937   XSTR (return_rtx, 0) = xstrdup (attr_name);
938   XSTR (return_rtx, 1) = xstrdup ("no,yes");
939   XEXP (return_rtx, 2) = const_str;
940 
941   XEXP (*queue, 0) = return_rtx;
942   XEXP (*queue, 1) = NULL_RTX;
943 }
944 
945 /* This routine generates DEFINE_SUBST_ATTR expression with operands
946    ATTR_OPERANDS and places it to QUEUE.  */
947 static void
add_define_subst_attr(const char ** attr_operands,rtx * queue)948 add_define_subst_attr (const char **attr_operands, rtx *queue)
949 {
950   rtx return_rtx;
951   int i;
952 
953   return_rtx = rtx_alloc (DEFINE_SUBST_ATTR);
954   PUT_CODE (return_rtx, DEFINE_SUBST_ATTR);
955 
956   for (i = 0; i < 4; i++)
957     XSTR (return_rtx, i) = xstrdup (attr_operands[i]);
958 
959   XEXP (*queue, 0) = return_rtx;
960   XEXP (*queue, 1) = NULL_RTX;
961 }
962 
963 /* Read define_subst_attribute construction.  It has next form:
964 	(define_subst_attribute <attribute_name> <iterator_name> <value1> <value2>)
965    Attribute is substituted with value1 when no subst is applied and with
966    value2 in the opposite case.
967    Attributes are added to SUBST_ATTRS_TABLE.
968    In case the iterator is encountered for the first time, it's added to
969    SUBST_ITERS_TABLE.  Also, implicit define_attr is generated.  */
970 
971 static void
read_subst_mapping(htab_t subst_iters_table,htab_t subst_attrs_table,rtx * queue)972 read_subst_mapping (htab_t subst_iters_table, htab_t subst_attrs_table,
973 		    rtx *queue)
974 {
975   struct mapping *m;
976   struct map_value **end_ptr;
977   const char *attr_operands[4];
978   rtx * queue_elem = queue;
979   int i;
980 
981   for (i = 0; i < 4; i++)
982     attr_operands[i] = read_string (false);
983 
984   add_define_subst_attr (attr_operands, queue_elem);
985 
986   bind_subst_iter_and_attr (attr_operands[1], attr_operands[0]);
987 
988   m = (struct mapping *) htab_find (substs.iterators, &attr_operands[1]);
989   if (!m)
990     {
991       m = add_mapping (&substs, subst_iters_table, attr_operands[1]);
992       end_ptr = &m->values;
993       end_ptr = add_map_value (end_ptr, 1, "");
994       end_ptr = add_map_value (end_ptr, 2, "");
995 
996       /* Add element to the queue.  */
997       XEXP (*queue, 1) = rtx_alloc (EXPR_LIST);
998       queue_elem = &XEXP (*queue, 1);
999 
1000       add_define_attr_for_define_subst (attr_operands[1], queue_elem);
1001     }
1002 
1003   m = add_mapping (&substs, subst_attrs_table, attr_operands[0]);
1004   end_ptr = &m->values;
1005   end_ptr = add_map_value (end_ptr, 1, attr_operands[2]);
1006   end_ptr = add_map_value (end_ptr, 2, attr_operands[3]);
1007 }
1008 
1009 /* Check newly-created code iterator ITERATOR to see whether every code has the
1010    same format.  */
1011 
1012 static void
check_code_iterator(struct mapping * iterator)1013 check_code_iterator (struct mapping *iterator)
1014 {
1015   struct map_value *v;
1016   enum rtx_code bellwether;
1017 
1018   bellwether = (enum rtx_code) iterator->values->number;
1019   for (v = iterator->values->next; v != 0; v = v->next)
1020     if (strcmp (GET_RTX_FORMAT (bellwether), GET_RTX_FORMAT (v->number)) != 0)
1021       fatal_with_file_and_line ("code iterator `%s' combines "
1022 				"different rtx formats", iterator->name);
1023 }
1024 
1025 /* Read an rtx-related declaration from the MD file, given that it
1026    starts with directive name RTX_NAME.  Return true if it expands to
1027    one or more rtxes (as defined by rtx.def).  When returning true,
1028    store the list of rtxes as an EXPR_LIST in *X.  */
1029 
1030 bool
read_rtx(const char * rtx_name,rtx * x)1031 read_rtx (const char *rtx_name, rtx *x)
1032 {
1033   static rtx queue_head;
1034 
1035   /* Do one-time initialization.  */
1036   if (queue_head == 0)
1037     {
1038       initialize_iterators ();
1039       queue_head = rtx_alloc (EXPR_LIST);
1040     }
1041 
1042   /* Handle various rtx-related declarations that aren't themselves
1043      encoded as rtxes.  */
1044   if (strcmp (rtx_name, "define_conditions") == 0)
1045     {
1046       read_conditions ();
1047       return false;
1048     }
1049   if (strcmp (rtx_name, "define_mode_attr") == 0)
1050     {
1051       read_mapping (&modes, modes.attrs);
1052       return false;
1053     }
1054   if (strcmp (rtx_name, "define_mode_iterator") == 0)
1055     {
1056       read_mapping (&modes, modes.iterators);
1057       return false;
1058     }
1059   if (strcmp (rtx_name, "define_code_attr") == 0)
1060     {
1061       read_mapping (&codes, codes.attrs);
1062       return false;
1063     }
1064   if (strcmp (rtx_name, "define_code_iterator") == 0)
1065     {
1066       check_code_iterator (read_mapping (&codes, codes.iterators));
1067       return false;
1068     }
1069   if (strcmp (rtx_name, "define_int_attr") == 0)
1070     {
1071       read_mapping (&ints, ints.attrs);
1072       return false;
1073     }
1074   if (strcmp (rtx_name, "define_int_iterator") == 0)
1075     {
1076       read_mapping (&ints, ints.iterators);
1077       return false;
1078     }
1079   if (strcmp (rtx_name, "define_subst_attr") == 0)
1080     {
1081       read_subst_mapping (substs.iterators, substs.attrs, &queue_head);
1082       *x = queue_head;
1083 
1084       /* READ_SUBST_MAPPING could generate a new DEFINE_ATTR.  Return
1085 	 TRUE to process it.  */
1086       return true;
1087     }
1088 
1089   apply_iterators (read_rtx_code (rtx_name), &queue_head);
1090   iterator_uses.truncate (0);
1091   attribute_uses.truncate (0);
1092 
1093   *x = queue_head;
1094   return true;
1095 }
1096 
1097 /* Subroutine of read_rtx and read_nested_rtx.  CODE_NAME is the name of
1098    either an rtx code or a code iterator.  Parse the rest of the rtx and
1099    return it.  */
1100 
1101 static rtx
read_rtx_code(const char * code_name)1102 read_rtx_code (const char *code_name)
1103 {
1104   int i;
1105   RTX_CODE code;
1106   struct mapping *iterator, *m;
1107   const char *format_ptr;
1108   struct md_name name;
1109   rtx return_rtx;
1110   int c;
1111   HOST_WIDE_INT tmp_wide;
1112   char *str;
1113   char *start, *end, *ptr;
1114   char tmpstr[256];
1115 
1116   /* Linked list structure for making RTXs: */
1117   struct rtx_list
1118     {
1119       struct rtx_list *next;
1120       rtx value;		/* Value of this node.  */
1121     };
1122 
1123   /* If this code is an iterator, build the rtx using the iterator's
1124      first value.  */
1125   iterator = (struct mapping *) htab_find (codes.iterators, &code_name);
1126   if (iterator != 0)
1127     code = (enum rtx_code) iterator->values->number;
1128   else
1129     code = (enum rtx_code) codes.find_builtin (code_name);
1130 
1131   /* If we end up with an insn expression then we free this space below.  */
1132   return_rtx = rtx_alloc (code);
1133   format_ptr = GET_RTX_FORMAT (code);
1134   memset (return_rtx, 0, RTX_CODE_SIZE (code));
1135   PUT_CODE (return_rtx, code);
1136 
1137   if (iterator)
1138     record_iterator_use (iterator, return_rtx);
1139 
1140   /* If what follows is `: mode ', read it and
1141      store the mode in the rtx.  */
1142 
1143   i = read_skip_spaces ();
1144   if (i == ':')
1145     {
1146       read_name (&name);
1147       record_potential_iterator_use (&modes, return_rtx, name.string);
1148     }
1149   else
1150     unread_char (i);
1151 
1152   for (i = 0; format_ptr[i] != 0; i++)
1153     switch (format_ptr[i])
1154       {
1155 	/* 0 means a field for internal use only.
1156 	   Don't expect it to be present in the input.  */
1157       case '0':
1158 	if (code == REG)
1159 	  ORIGINAL_REGNO (return_rtx) = REGNO (return_rtx);
1160 	break;
1161 
1162       case 'e':
1163       case 'u':
1164 	XEXP (return_rtx, i) = read_nested_rtx ();
1165 	break;
1166 
1167       case 'V':
1168 	/* 'V' is an optional vector: if a closeparen follows,
1169 	   just store NULL for this element.  */
1170 	c = read_skip_spaces ();
1171 	unread_char (c);
1172 	if (c == ')')
1173 	  {
1174 	    XVEC (return_rtx, i) = 0;
1175 	    break;
1176 	  }
1177 	/* Now process the vector.  */
1178 
1179       case 'E':
1180 	{
1181 	  /* Obstack to store scratch vector in.  */
1182 	  struct obstack vector_stack;
1183 	  int list_counter = 0;
1184 	  rtvec return_vec = NULL_RTVEC;
1185 
1186 	  c = read_skip_spaces ();
1187 	  if (c != '[')
1188 	    fatal_expected_char ('[', c);
1189 
1190 	  /* Add expressions to a list, while keeping a count.  */
1191 	  obstack_init (&vector_stack);
1192 	  while ((c = read_skip_spaces ()) && c != ']')
1193 	    {
1194 	      if (c == EOF)
1195 		fatal_expected_char (']', c);
1196 	      unread_char (c);
1197 	      list_counter++;
1198 	      obstack_ptr_grow (&vector_stack, read_nested_rtx ());
1199 	    }
1200 	  if (list_counter > 0)
1201 	    {
1202 	      return_vec = rtvec_alloc (list_counter);
1203 	      memcpy (&return_vec->elem[0], obstack_finish (&vector_stack),
1204 		      list_counter * sizeof (rtx));
1205 	    }
1206 	  else if (format_ptr[i] == 'E')
1207 	    fatal_with_file_and_line ("vector must have at least one element");
1208 	  XVEC (return_rtx, i) = return_vec;
1209 	  obstack_free (&vector_stack, NULL);
1210 	  /* close bracket gotten */
1211 	}
1212 	break;
1213 
1214       case 'S':
1215       case 'T':
1216       case 's':
1217 	{
1218 	  char *stringbuf;
1219 	  int star_if_braced;
1220 
1221 	  c = read_skip_spaces ();
1222 	  unread_char (c);
1223 	  if (c == ')')
1224 	    {
1225 	      /* 'S' fields are optional and should be NULL if no string
1226 		 was given.  Also allow normal 's' and 'T' strings to be
1227 		 omitted, treating them in the same way as empty strings.  */
1228 	      XSTR (return_rtx, i) = (format_ptr[i] == 'S' ? NULL : "");
1229 	      break;
1230 	    }
1231 
1232 	  /* The output template slot of a DEFINE_INSN,
1233 	     DEFINE_INSN_AND_SPLIT, or DEFINE_PEEPHOLE automatically
1234 	     gets a star inserted as its first character, if it is
1235 	     written with a brace block instead of a string constant.  */
1236 	  star_if_braced = (format_ptr[i] == 'T');
1237 
1238 	  stringbuf = read_string (star_if_braced);
1239 
1240 	  /* For insn patterns, we want to provide a default name
1241 	     based on the file and line, like "*foo.md:12", if the
1242 	     given name is blank.  These are only for define_insn and
1243 	     define_insn_and_split, to aid debugging.  */
1244 	  if (*stringbuf == '\0'
1245 	      && i == 0
1246 	      && (GET_CODE (return_rtx) == DEFINE_INSN
1247 		  || GET_CODE (return_rtx) == DEFINE_INSN_AND_SPLIT))
1248 	    {
1249 	      char line_name[20];
1250 	      const char *fn = (read_md_filename ? read_md_filename : "rtx");
1251 	      const char *slash;
1252 	      for (slash = fn; *slash; slash ++)
1253 		if (*slash == '/' || *slash == '\\' || *slash == ':')
1254 		  fn = slash + 1;
1255 	      obstack_1grow (&string_obstack, '*');
1256 	      obstack_grow (&string_obstack, fn, strlen (fn));
1257 	      sprintf (line_name, ":%d", read_md_lineno);
1258 	      obstack_grow (&string_obstack, line_name, strlen (line_name)+1);
1259 	      stringbuf = XOBFINISH (&string_obstack, char *);
1260 	    }
1261 
1262 	  /* Find attr-names in the string.  */
1263 	  ptr = &tmpstr[0];
1264 	  end = stringbuf;
1265 	  while ((start = strchr (end, '<')) && (end  = strchr (start, '>')))
1266 	    {
1267 	      if ((end - start - 1 > 0)
1268 		  && (end - start - 1 < (int)sizeof (tmpstr)))
1269 		{
1270 		  strncpy (tmpstr, start+1, end-start-1);
1271 		  tmpstr[end-start-1] = 0;
1272 		  end++;
1273 		}
1274 	      else
1275 		break;
1276 	      m = (struct mapping *) htab_find (substs.attrs, &ptr);
1277 	      if (m != 0)
1278 		{
1279 		  /* Here we should find linked subst-iter.  */
1280 		  str = find_subst_iter_by_attr (ptr);
1281 		  if (str)
1282 		    m = (struct mapping *) htab_find (substs.iterators, &str);
1283 		  else
1284 		    m = 0;
1285 		}
1286 	      if (m != 0)
1287 		record_iterator_use (m, return_rtx);
1288 	    }
1289 
1290 	  if (star_if_braced)
1291 	    XTMPL (return_rtx, i) = stringbuf;
1292 	  else
1293 	    XSTR (return_rtx, i) = stringbuf;
1294 	}
1295 	break;
1296 
1297       case 'w':
1298 	read_name (&name);
1299 	validate_const_int (name.string);
1300 #if HOST_BITS_PER_WIDE_INT == HOST_BITS_PER_INT
1301 	tmp_wide = atoi (name.string);
1302 #else
1303 #if HOST_BITS_PER_WIDE_INT == HOST_BITS_PER_LONG
1304 	tmp_wide = atol (name.string);
1305 #else
1306 	/* Prefer atoll over atoq, since the former is in the ISO C99 standard.
1307 	   But prefer not to use our hand-rolled function above either.  */
1308 #if defined(HAVE_ATOLL) || !defined(HAVE_ATOQ)
1309 	tmp_wide = atoll (name.string);
1310 #else
1311 	tmp_wide = atoq (name.string);
1312 #endif
1313 #endif
1314 #endif
1315 	XWINT (return_rtx, i) = tmp_wide;
1316 	break;
1317 
1318       case 'i':
1319       case 'n':
1320 	/* Can be an iterator or an integer constant.  */
1321 	read_name (&name);
1322 	record_potential_iterator_use (&ints, &XINT (return_rtx, i),
1323 				       name.string);
1324 	break;
1325 
1326       default:
1327 	gcc_unreachable ();
1328       }
1329 
1330   c = read_skip_spaces ();
1331   /* Syntactic sugar for AND and IOR, allowing Lisp-like
1332      arbitrary number of arguments for them.  */
1333   if (c == '('
1334       && (GET_CODE (return_rtx) == AND
1335 	  || GET_CODE (return_rtx) == IOR))
1336     return read_rtx_variadic (return_rtx);
1337 
1338   unread_char (c);
1339   return return_rtx;
1340 }
1341 
1342 /* Read a nested rtx construct from the MD file and return it.  */
1343 
1344 static rtx
read_nested_rtx(void)1345 read_nested_rtx (void)
1346 {
1347   struct md_name name;
1348   int c;
1349   rtx return_rtx;
1350 
1351   c = read_skip_spaces ();
1352   if (c != '(')
1353     fatal_expected_char ('(', c);
1354 
1355   read_name (&name);
1356   if (strcmp (name.string, "nil") == 0)
1357     return_rtx = NULL;
1358   else
1359     return_rtx = read_rtx_code (name.string);
1360 
1361   c = read_skip_spaces ();
1362   if (c != ')')
1363     fatal_expected_char (')', c);
1364 
1365   return return_rtx;
1366 }
1367 
1368 /* Mutually recursive subroutine of read_rtx which reads
1369    (thing x1 x2 x3 ...) and produces RTL as if
1370    (thing x1 (thing x2 (thing x3 ...)))  had been written.
1371    When called, FORM is (thing x1 x2), and the file position
1372    is just past the leading parenthesis of x3.  Only works
1373    for THINGs which are dyadic expressions, e.g. AND, IOR.  */
1374 static rtx
read_rtx_variadic(rtx form)1375 read_rtx_variadic (rtx form)
1376 {
1377   char c = '(';
1378   rtx p = form, q;
1379 
1380   do
1381     {
1382       unread_char (c);
1383 
1384       q = rtx_alloc (GET_CODE (p));
1385       PUT_MODE (q, GET_MODE (p));
1386 
1387       XEXP (q, 0) = XEXP (p, 1);
1388       XEXP (q, 1) = read_nested_rtx ();
1389 
1390       XEXP (p, 1) = q;
1391       p = q;
1392       c = read_skip_spaces ();
1393     }
1394   while (c == '(');
1395   unread_char (c);
1396   return form;
1397 }
1398