OSDN Git Service

2007-10-18 Francois-Xavier Coudert <fxcoudert@gcc.gnu.org>
[pf3gnuchains/gcc-fork.git] / libgfortran / libgfortran.h
1 /* Common declarations for all of libgfortran.
2    Copyright (C) 2002, 2003, 2004, 2005, 2006, 2007 Free Software Foundation, Inc.
3    Contributed by Paul Brook <paul@nowt.org>, and
4    Andy Vaught <andy@xena.eas.asu.edu>
5
6 This file is part of the GNU Fortran 95 runtime library (libgfortran).
7
8 Libgfortran is free software; you can redistribute it and/or
9 modify it under the terms of the GNU Lesser General Public
10 License as published by the Free Software Foundation; either
11 version 2.1 of the License, or (at your option) any later version.
12
13 Libgfortran is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
16 GNU Lesser General Public License for more details.
17
18 You should have received a copy of the GNU Lesser General Public
19 License along with libgfor; see the file COPYING.LIB.  If not,
20 write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
21 Boston, MA 02110-1301, USA.  */
22
23 /* As a special exception, if you link this library with other files,
24    some of which are compiled with GCC, to produce an executable,
25    this library does not by itself cause the resulting executable
26    to be covered by the GNU General Public License.
27    This exception does not however invalidate any other reasons why
28    the executable file might be covered by the GNU General Public License.  */
29
30
31 #ifndef LIBGFOR_H
32 #define LIBGFOR_H
33
34 /* config.h MUST be first because it can affect system headers.  */
35 #include "config.h"
36
37 #include <stdio.h>
38 #include <math.h>
39 #include <stddef.h>
40 #include <float.h>
41 #include <stdarg.h>
42
43 #if HAVE_COMPLEX_H
44 # include <complex.h>
45 #else
46 #define complex __complex__
47 #endif
48
49 #include "../gcc/fortran/libgfortran.h"
50
51 #include "c99_protos.h"
52
53 #if HAVE_IEEEFP_H
54 #include <ieeefp.h>
55 #endif
56
57 #include "gstdint.h"
58
59 #if HAVE_SYS_TYPES_H
60 #include <sys/types.h>
61 #endif
62 typedef off_t gfc_offset;
63
64 #ifndef NULL
65 #define NULL (void *) 0
66 #endif
67
68 #ifndef __GNUC__
69 #define __attribute__(x)
70 #endif
71
72
73 /* On mingw, work around the buggy Windows snprintf() by using the one
74    mingw provides, __mingw_snprintf().  We also provide a prototype for
75    __mingw_snprintf(), because the mingw headers currently don't have one.  */
76 #if HAVE_MINGW_SNPRINTF
77 extern int __mingw_snprintf (char *, size_t, const char *, ...);
78 #undef snprintf
79 #define snprintf __mingw_snprintf
80 #endif
81
82
83 /* For a library, a standard prefix is a requirement in order to partition
84    the namespace.  IPREFIX is for symbols intended to be internal to the
85    library.  */
86 #define PREFIX(x)       _gfortran_ ## x
87 #define IPREFIX(x)      _gfortrani_ ## x
88
89 /* Magic to rename a symbol at the compiler level.  You continue to refer
90    to the symbol as OLD in the source, but it'll be named NEW in the asm.  */
91 #define sym_rename(old, new) sym_rename1(old, __USER_LABEL_PREFIX__, new)
92 #define sym_rename1(old, ulp, new) sym_rename2(old, ulp, new)
93 #define sym_rename2(old, ulp, new) extern __typeof(old) old __asm__(#ulp #new)
94
95 /* There are several classifications of routines:
96
97      (1) Symbols used only within the library,
98      (2) Symbols to be exported from the library,
99      (3) Symbols to be exported from the library, but
100          also used inside the library.
101
102    By telling the compiler about these different classifications we can
103    tightly control the interface seen by the user, and get better code
104    from the compiler at the same time.
105
106    One of the following should be used immediately after the declaration
107    of each symbol:
108
109      internal_proto     Marks a symbol used only within the library,
110                         and adds IPREFIX to the assembly-level symbol
111                         name.  The later is important for maintaining
112                         the namespace partition for the static library.
113
114      export_proto       Marks a symbol to be exported, and adds PREFIX
115                         to the assembly-level symbol name.
116
117      export_proto_np    Marks a symbol to be exported without adding PREFIX.
118
119      iexport_proto      Marks a function to be exported, but with the 
120                         understanding that it can be used inside as well.
121
122      iexport_data_proto Similarly, marks a data symbol to be exported.
123                         Unfortunately, some systems can't play the hidden
124                         symbol renaming trick on data symbols, thanks to
125                         the horribleness of COPY relocations.
126
127    If iexport_proto or iexport_data_proto is used, you must also use
128    iexport or iexport_data after the *definition* of the symbol.  */
129
130 #if defined(HAVE_ATTRIBUTE_VISIBILITY)
131 # define internal_proto(x) \
132         sym_rename(x, IPREFIX (x)) __attribute__((__visibility__("hidden")))
133 #else
134 # define internal_proto(x)      sym_rename(x, IPREFIX(x))
135 #endif
136
137 #if defined(HAVE_ATTRIBUTE_VISIBILITY) && defined(HAVE_ATTRIBUTE_ALIAS)
138 # define export_proto(x)        sym_rename(x, PREFIX(x))
139 # define export_proto_np(x)     extern char swallow_semicolon
140 # define iexport_proto(x)       internal_proto(x)
141 # define iexport(x)             iexport1(x, IPREFIX(x))
142 # define iexport1(x,y)          iexport2(x,y)
143 # define iexport2(x,y) \
144         extern __typeof(x) PREFIX(x) __attribute__((__alias__(#y)))
145 /* ??? We're not currently building a dll, and it's wrong to add dllexport
146    to objects going into a static library archive.  */
147 #elif 0 && defined(HAVE_ATTRIBUTE_DLLEXPORT)
148 # define export_proto_np(x)     extern __typeof(x) x __attribute__((dllexport))
149 # define export_proto(x)    sym_rename(x, PREFIX(x)) __attribute__((dllexport))
150 # define iexport_proto(x)       export_proto(x)
151 # define iexport(x)             extern char swallow_semicolon
152 #else
153 # define export_proto(x)        sym_rename(x, PREFIX(x))
154 # define export_proto_np(x)     extern char swallow_semicolon
155 # define iexport_proto(x)       export_proto(x)
156 # define iexport(x)             extern char swallow_semicolon
157 #endif
158
159 /* TODO: detect the case when we *can* hide the symbol.  */
160 #define iexport_data_proto(x)   export_proto(x)
161 #define iexport_data(x)         extern char swallow_semicolon
162
163 /* The only reliable way to get the offset of a field in a struct
164    in a system independent way is via this macro.  */
165 #ifndef offsetof
166 #define offsetof(TYPE, MEMBER)  ((size_t) &((TYPE *) 0)->MEMBER)
167 #endif
168
169 /* The isfinite macro is only available with C99, but some non-C99
170    systems still provide fpclassify, and there is a `finite' function
171    in BSD.
172
173    Also, isfinite is broken on Cygwin.
174
175    When isfinite is not available, try to use one of the
176    alternatives, or bail out.  */
177
178 #if defined(HAVE_BROKEN_ISFINITE) || defined(__CYGWIN__)
179 #undef isfinite
180 #endif
181
182 #if defined(HAVE_BROKEN_ISNAN)
183 #undef isnan
184 #endif
185
186 #if defined(HAVE_BROKEN_FPCLASSIFY)
187 #undef fpclassify
188 #endif
189
190 #if !defined(isfinite)
191 #if !defined(fpclassify)
192 #define isfinite(x) ((x) - (x) == 0)
193 #else
194 #define isfinite(x) (fpclassify(x) != FP_NAN && fpclassify(x) != FP_INFINITE)
195 #endif /* !defined(fpclassify) */
196 #endif /* !defined(isfinite)  */
197
198 #if !defined(isnan)
199 #if !defined(fpclassify)
200 #define isnan(x) ((x) != (x))
201 #else
202 #define isnan(x) (fpclassify(x) == FP_NAN)
203 #endif /* !defined(fpclassify) */
204 #endif /* !defined(isfinite)  */
205
206 /* TODO: find the C99 version of these an move into above ifdef.  */
207 #define REALPART(z) (__real__(z))
208 #define IMAGPART(z) (__imag__(z))
209 #define COMPLEX_ASSIGN(z_, r_, i_) {__real__(z_) = (r_); __imag__(z_) = (i_);}
210
211 #include "kinds.h"
212
213 /* Define the type used for the current record number for large file I/O.
214    The size must be consistent with the size defined on the compiler side.  */
215 #ifdef HAVE_GFC_INTEGER_8
216 typedef GFC_INTEGER_8 GFC_IO_INT;
217 #else
218 #ifdef HAVE_GFC_INTEGER_4
219 typedef GFC_INTEGER_4 GFC_IO_INT;
220 #else
221 #error "GFC_INTEGER_4 should be available for the library to compile".
222 #endif
223 #endif
224
225 /* The following two definitions must be consistent with the types used
226    by the compiler.  */
227 /* The type used of array indices, amongst other things.  */
228 typedef ssize_t index_type;
229 /* The type used for the lengths of character variables.  */
230 typedef GFC_INTEGER_4 gfc_charlen_type;
231
232 /* This will be 0 on little-endian machines and one on big-endian machines.  */
233 extern int l8_to_l4_offset;
234 internal_proto(l8_to_l4_offset);
235
236 #define GFOR_POINTER_TO_L1(p, kind) \
237   (l8_to_l4_offset * (kind - 1) + (GFC_LOGICAL_1 *)(p))
238
239 #define GFC_INTEGER_1_HUGE \
240   (GFC_INTEGER_1)((((GFC_UINTEGER_1)1) << 7) - 1)
241 #define GFC_INTEGER_2_HUGE \
242   (GFC_INTEGER_2)((((GFC_UINTEGER_2)1) << 15) - 1)
243 #define GFC_INTEGER_4_HUGE \
244   (GFC_INTEGER_4)((((GFC_UINTEGER_4)1) << 31) - 1)
245 #define GFC_INTEGER_8_HUGE \
246   (GFC_INTEGER_8)((((GFC_UINTEGER_8)1) << 63) - 1)
247 #ifdef HAVE_GFC_INTEGER_16
248 #define GFC_INTEGER_16_HUGE \
249   (GFC_INTEGER_16)((((GFC_UINTEGER_16)1) << 127) - 1)
250 #endif
251
252 #define GFC_REAL_4_HUGE FLT_MAX
253 #define GFC_REAL_8_HUGE DBL_MAX
254 #ifdef HAVE_GFC_REAL_10
255 #define GFC_REAL_10_HUGE LDBL_MAX
256 #endif
257 #ifdef HAVE_GFC_REAL_16
258 #define GFC_REAL_16_HUGE LDBL_MAX
259 #endif
260
261 #define GFC_REAL_4_DIGITS FLT_MANT_DIG
262 #define GFC_REAL_8_DIGITS DBL_MANT_DIG
263 #ifdef HAVE_GFC_REAL_10
264 #define GFC_REAL_10_DIGITS LDBL_MANT_DIG
265 #endif
266 #ifdef HAVE_GFC_REAL_16
267 #define GFC_REAL_16_DIGITS LDBL_MANT_DIG
268 #endif
269
270 #define GFC_REAL_4_RADIX FLT_RADIX
271 #define GFC_REAL_8_RADIX FLT_RADIX
272 #ifdef HAVE_GFC_REAL_10
273 #define GFC_REAL_10_RADIX FLT_RADIX
274 #endif
275 #ifdef HAVE_GFC_REAL_16
276 #define GFC_REAL_16_RADIX FLT_RADIX
277 #endif
278
279
280 typedef struct descriptor_dimension
281 {
282   index_type stride;
283   index_type lbound;
284   index_type ubound;
285 }
286 descriptor_dimension;
287
288 #define GFC_ARRAY_DESCRIPTOR(r, type) \
289 struct {\
290   type *data;\
291   size_t offset;\
292   index_type dtype;\
293   descriptor_dimension dim[r];\
294 }
295
296 /* Commonly used array descriptor types.  */
297 typedef GFC_ARRAY_DESCRIPTOR (GFC_MAX_DIMENSIONS, void) gfc_array_void;
298 typedef GFC_ARRAY_DESCRIPTOR (GFC_MAX_DIMENSIONS, char) gfc_array_char;
299 typedef GFC_ARRAY_DESCRIPTOR (GFC_MAX_DIMENSIONS, GFC_INTEGER_1) gfc_array_i1;
300 typedef GFC_ARRAY_DESCRIPTOR (GFC_MAX_DIMENSIONS, GFC_INTEGER_2) gfc_array_i2;
301 typedef GFC_ARRAY_DESCRIPTOR (GFC_MAX_DIMENSIONS, GFC_INTEGER_4) gfc_array_i4;
302 typedef GFC_ARRAY_DESCRIPTOR (GFC_MAX_DIMENSIONS, GFC_INTEGER_8) gfc_array_i8;
303 #ifdef HAVE_GFC_INTEGER_16
304 typedef GFC_ARRAY_DESCRIPTOR (GFC_MAX_DIMENSIONS, GFC_INTEGER_16) gfc_array_i16;
305 #endif
306 typedef GFC_ARRAY_DESCRIPTOR (GFC_MAX_DIMENSIONS, GFC_REAL_4) gfc_array_r4;
307 typedef GFC_ARRAY_DESCRIPTOR (GFC_MAX_DIMENSIONS, GFC_REAL_8) gfc_array_r8;
308 #ifdef HAVE_GFC_REAL_10
309 typedef GFC_ARRAY_DESCRIPTOR (GFC_MAX_DIMENSIONS, GFC_REAL_10) gfc_array_r10;
310 #endif
311 #ifdef HAVE_GFC_REAL_16
312 typedef GFC_ARRAY_DESCRIPTOR (GFC_MAX_DIMENSIONS, GFC_REAL_16) gfc_array_r16;
313 #endif
314 typedef GFC_ARRAY_DESCRIPTOR (GFC_MAX_DIMENSIONS, GFC_COMPLEX_4) gfc_array_c4;
315 typedef GFC_ARRAY_DESCRIPTOR (GFC_MAX_DIMENSIONS, GFC_COMPLEX_8) gfc_array_c8;
316 #ifdef HAVE_GFC_COMPLEX_10
317 typedef GFC_ARRAY_DESCRIPTOR (GFC_MAX_DIMENSIONS, GFC_COMPLEX_10) gfc_array_c10;
318 #endif
319 #ifdef HAVE_GFC_COMPLEX_16
320 typedef GFC_ARRAY_DESCRIPTOR (GFC_MAX_DIMENSIONS, GFC_COMPLEX_16) gfc_array_c16;
321 #endif
322 typedef GFC_ARRAY_DESCRIPTOR (GFC_MAX_DIMENSIONS, GFC_LOGICAL_1) gfc_array_l1;
323 typedef GFC_ARRAY_DESCRIPTOR (GFC_MAX_DIMENSIONS, GFC_LOGICAL_2) gfc_array_l2;
324 typedef GFC_ARRAY_DESCRIPTOR (GFC_MAX_DIMENSIONS, GFC_LOGICAL_4) gfc_array_l4;
325 typedef GFC_ARRAY_DESCRIPTOR (GFC_MAX_DIMENSIONS, GFC_LOGICAL_8) gfc_array_l8;
326 #ifdef HAVE_GFC_LOGICAL_16
327 typedef GFC_ARRAY_DESCRIPTOR (GFC_MAX_DIMENSIONS, GFC_LOGICAL_16) gfc_array_l16;
328 #endif
329
330
331 #define GFC_DESCRIPTOR_RANK(desc) ((desc)->dtype & GFC_DTYPE_RANK_MASK)
332 #define GFC_DESCRIPTOR_TYPE(desc) (((desc)->dtype & GFC_DTYPE_TYPE_MASK) \
333                                    >> GFC_DTYPE_TYPE_SHIFT)
334 #define GFC_DESCRIPTOR_SIZE(desc) ((desc)->dtype >> GFC_DTYPE_SIZE_SHIFT)
335 #define GFC_DESCRIPTOR_DATA(desc) ((desc)->data)
336 #define GFC_DESCRIPTOR_DTYPE(desc) ((desc)->dtype)
337
338 /* Runtime library include.  */
339 #define stringize(x) expand_macro(x)
340 #define expand_macro(x) # x
341
342 /* Runtime options structure.  */
343
344 typedef struct
345 {
346   int stdin_unit, stdout_unit, stderr_unit, optional_plus;
347   int locus;
348
349   int separator_len;
350   const char *separator;
351
352   int use_stderr, all_unbuffered, unbuffered_preconnected, default_recl;
353   int fpe, dump_core, backtrace;
354 }
355 options_t;
356
357 extern options_t options;
358 internal_proto(options);
359
360 extern void handler (int);
361 internal_proto(handler);
362
363
364 /* Compile-time options that will influence the library.  */
365
366 typedef struct
367 {
368   int warn_std;
369   int allow_std;
370   int pedantic;
371   int convert;
372   int dump_core;
373   int backtrace;
374   int sign_zero;
375   size_t record_marker;
376   int max_subrecord_length;
377   int bounds_check;
378 }
379 compile_options_t;
380
381 extern compile_options_t compile_options;
382 internal_proto(compile_options);
383
384 extern void init_compile_options (void);
385 internal_proto(init_compile_options);
386
387 #define GFC_MAX_SUBRECORD_LENGTH 2147483639   /* 2**31 - 9 */
388
389 /* Structure for statement options.  */
390
391 typedef struct
392 {
393   const char *name;
394   int value;
395 }
396 st_option;
397
398
399 /* This is returned by notification_std to know if, given the flags
400    that were given (-std=, -pedantic) we should issue an error, a warning
401    or nothing.  */
402 typedef enum
403 { SILENT, WARNING, ERROR }
404 notification;
405
406 /* This is returned by notify_std and several io functions.  */
407 typedef enum
408 { SUCCESS = 1, FAILURE }
409 try;
410
411 /* The filename and line number don't go inside the globals structure.
412    They are set by the rest of the program and must be linked to.  */
413
414 /* Location of the current library call (optional).  */
415 extern unsigned line;
416 iexport_data_proto(line);
417
418 extern char *filename;
419 iexport_data_proto(filename);
420
421 /* Avoid conflicting prototypes of alloca() in system headers by using 
422    GCC's builtin alloca().  */
423 #define gfc_alloca(x)  __builtin_alloca(x)
424
425
426 /* Directory for creating temporary files.  Only used when none of the
427    following environment variables exist: GFORTRAN_TMPDIR, TMP and TEMP.  */
428 #define DEFAULT_TEMPDIR "/tmp"
429
430 /* The default value of record length for preconnected units is defined
431    here. This value can be overriden by an environment variable.
432    Default value is 1 Gb.  */
433 #define DEFAULT_RECL 1073741824
434
435
436 #define CHARACTER2(name) \
437               gfc_charlen_type name ## _len; \
438               char * name
439
440 typedef struct st_parameter_common
441 {
442   GFC_INTEGER_4 flags;
443   GFC_INTEGER_4 unit;
444   const char *filename;
445   GFC_INTEGER_4 line;
446   CHARACTER2 (iomsg);
447   GFC_INTEGER_4 *iostat;
448 }
449 st_parameter_common;
450
451 #undef CHARACTER2
452
453 #define IOPARM_LIBRETURN_MASK           (3 << 0)
454 #define IOPARM_LIBRETURN_OK             (0 << 0)
455 #define IOPARM_LIBRETURN_ERROR          (1 << 0)
456 #define IOPARM_LIBRETURN_END            (2 << 0)
457 #define IOPARM_LIBRETURN_EOR            (3 << 0)
458 #define IOPARM_ERR                      (1 << 2)
459 #define IOPARM_END                      (1 << 3)
460 #define IOPARM_EOR                      (1 << 4)
461 #define IOPARM_HAS_IOSTAT               (1 << 5)
462 #define IOPARM_HAS_IOMSG                (1 << 6)
463
464 #define IOPARM_COMMON_MASK              ((1 << 7) - 1)
465
466 #define IOPARM_OPEN_HAS_RECL_IN         (1 << 7)
467 #define IOPARM_OPEN_HAS_FILE            (1 << 8)
468 #define IOPARM_OPEN_HAS_STATUS          (1 << 9)
469 #define IOPARM_OPEN_HAS_ACCESS          (1 << 10)
470 #define IOPARM_OPEN_HAS_FORM            (1 << 11)
471 #define IOPARM_OPEN_HAS_BLANK           (1 << 12)
472 #define IOPARM_OPEN_HAS_POSITION        (1 << 13)
473 #define IOPARM_OPEN_HAS_ACTION          (1 << 14)
474 #define IOPARM_OPEN_HAS_DELIM           (1 << 15)
475 #define IOPARM_OPEN_HAS_PAD             (1 << 16)
476 #define IOPARM_OPEN_HAS_CONVERT         (1 << 17)
477
478 /* library start function and end macro.  These can be expanded if needed
479    in the future.  cmp is st_parameter_common *cmp  */
480
481 extern void library_start (st_parameter_common *);
482 internal_proto(library_start);
483
484 #define library_end()
485
486 /* main.c */
487
488 extern void stupid_function_name_for_static_linking (void);
489 internal_proto(stupid_function_name_for_static_linking);
490
491 extern void set_args (int, char **);
492 export_proto(set_args);
493
494 extern void get_args (int *, char ***);
495 internal_proto(get_args);
496
497 extern void store_exe_path (const char *);
498 export_proto(store_exe_path);
499
500 extern char * full_exe_path (void);
501 internal_proto(full_exe_path);
502
503 /* backtrace.c */
504
505 extern void show_backtrace (void);
506 internal_proto(show_backtrace);
507
508 /* error.c */
509
510 #define GFC_ITOA_BUF_SIZE (sizeof (GFC_INTEGER_LARGEST) * 3 + 2)
511 #define GFC_XTOA_BUF_SIZE (sizeof (GFC_UINTEGER_LARGEST) * 2 + 1)
512 #define GFC_OTOA_BUF_SIZE (sizeof (GFC_INTEGER_LARGEST) * 3 + 1)
513 #define GFC_BTOA_BUF_SIZE (sizeof (GFC_INTEGER_LARGEST) * 8 + 1)
514
515 extern void sys_exit (int) __attribute__ ((noreturn));
516 internal_proto(sys_exit);
517
518 extern const char *gfc_itoa (GFC_INTEGER_LARGEST, char *, size_t);
519 internal_proto(gfc_itoa);
520
521 extern const char *xtoa (GFC_UINTEGER_LARGEST, char *, size_t);
522 internal_proto(xtoa);
523
524 extern void os_error (const char *) __attribute__ ((noreturn));
525 iexport_proto(os_error);
526
527 extern void show_locus (st_parameter_common *);
528 internal_proto(show_locus);
529
530 extern void runtime_error (const char *, ...)
531      __attribute__ ((noreturn, format (printf, 1, 2)));
532 iexport_proto(runtime_error);
533
534 extern void runtime_error_at (const char *, const char *, ...)
535      __attribute__ ((noreturn, format (printf, 2, 3)));
536 iexport_proto(runtime_error_at);
537
538 extern void internal_error (st_parameter_common *, const char *)
539   __attribute__ ((noreturn));
540 internal_proto(internal_error);
541
542 extern const char *get_oserror (void);
543 internal_proto(get_oserror);
544
545 extern const char *translate_error (int);
546 internal_proto(translate_error);
547
548 extern void generate_error (st_parameter_common *, int, const char *);
549 iexport_proto(generate_error);
550
551 extern try notify_std (st_parameter_common *, int, const char *);
552 internal_proto(notify_std);
553
554 extern notification notification_std(int);
555 internal_proto(notification_std);
556
557 /* fpu.c */
558
559 extern void set_fpu (void);
560 internal_proto(set_fpu);
561
562 /* memory.c */
563
564 extern void *get_mem (size_t) __attribute__ ((malloc));
565 internal_proto(get_mem);
566
567 extern void free_mem (void *);
568 internal_proto(free_mem);
569
570 extern void *internal_malloc_size (size_t) __attribute__ ((malloc));
571 internal_proto(internal_malloc_size);
572
573 /* environ.c */
574
575 extern int check_buffered (int);
576 internal_proto(check_buffered);
577
578 extern void init_variables (void);
579 internal_proto(init_variables);
580
581 extern void show_variables (void);
582 internal_proto(show_variables);
583
584 unit_convert get_unformatted_convert (int);
585 internal_proto(get_unformatted_convert);
586
587 /* string.c */
588
589 extern int find_option (st_parameter_common *, const char *, gfc_charlen_type,
590                         const st_option *, const char *);
591 internal_proto(find_option);
592
593 extern gfc_charlen_type fstrlen (const char *, gfc_charlen_type);
594 internal_proto(fstrlen);
595
596 extern gfc_charlen_type fstrcpy (char *, gfc_charlen_type, const char *, gfc_charlen_type);
597 internal_proto(fstrcpy);
598
599 extern gfc_charlen_type cf_strcpy (char *, gfc_charlen_type, const char *);
600 internal_proto(cf_strcpy);
601
602 /* io/intrinsics.c */
603
604 extern void flush_all_units (void);
605 internal_proto(flush_all_units);
606
607 /* io.c */
608
609 extern void init_units (void);
610 internal_proto(init_units);
611
612 extern void close_units (void);
613 internal_proto(close_units);
614
615 extern int unit_to_fd (int);
616 internal_proto(unit_to_fd);
617
618 extern int st_printf (const char *, ...)
619   __attribute__ ((format (printf, 1, 2)));
620 internal_proto(st_printf);
621
622 extern int st_vprintf (const char *, va_list);
623 internal_proto(st_vprintf);
624
625 extern char * filename_from_unit (int);
626 internal_proto(filename_from_unit);
627
628 /* stop.c */
629
630 extern void stop_numeric (GFC_INTEGER_4) __attribute__ ((noreturn));
631 iexport_proto(stop_numeric);
632
633 /* reshape_packed.c */
634
635 extern void reshape_packed (char *, index_type, const char *, index_type,
636                             const char *, index_type);
637 internal_proto(reshape_packed);
638
639 /* Repacking functions.  */
640
641 /* ??? These aren't currently used by the compiler, though we
642    certainly could do so.  */
643 GFC_INTEGER_4 *internal_pack_4 (gfc_array_i4 *);
644 internal_proto(internal_pack_4);
645
646 GFC_INTEGER_8 *internal_pack_8 (gfc_array_i8 *);
647 internal_proto(internal_pack_8);
648
649 #if defined HAVE_GFC_INTEGER_16
650 GFC_INTEGER_16 *internal_pack_16 (gfc_array_i16 *);
651 internal_proto(internal_pack_16);
652 #endif
653
654 GFC_COMPLEX_4 *internal_pack_c4 (gfc_array_c4 *);
655 internal_proto(internal_pack_c4);
656
657 GFC_COMPLEX_8 *internal_pack_c8 (gfc_array_c8 *);
658 internal_proto(internal_pack_c8);
659
660 #if defined HAVE_GFC_COMPLEX_10
661 GFC_COMPLEX_10 *internal_pack_c10 (gfc_array_c10 *);
662 internal_proto(internal_pack_c10);
663 #endif
664
665 extern void internal_unpack_4 (gfc_array_i4 *, const GFC_INTEGER_4 *);
666 internal_proto(internal_unpack_4);
667
668 extern void internal_unpack_8 (gfc_array_i8 *, const GFC_INTEGER_8 *);
669 internal_proto(internal_unpack_8);
670
671 #if defined HAVE_GFC_INTEGER_16
672 extern void internal_unpack_16 (gfc_array_i16 *, const GFC_INTEGER_16 *);
673 internal_proto(internal_unpack_16);
674 #endif
675
676 extern void internal_unpack_c4 (gfc_array_c4 *, const GFC_COMPLEX_4 *);
677 internal_proto(internal_unpack_c4);
678
679 extern void internal_unpack_c8 (gfc_array_c8 *, const GFC_COMPLEX_8 *);
680 internal_proto(internal_unpack_c8);
681
682 #if defined HAVE_GFC_COMPLEX_10
683 extern void internal_unpack_c10 (gfc_array_c10 *, const GFC_COMPLEX_10 *);
684 internal_proto(internal_unpack_c10);
685 #endif
686
687 #if defined HAVE_GFC_COMPLEX_16
688 extern void internal_unpack_c16 (gfc_array_c16 *, const GFC_COMPLEX_16 *);
689 internal_proto(internal_unpack_c16);
690 #endif
691
692 /* string_intrinsics.c */
693
694 extern int compare_string (GFC_INTEGER_4, const char *,
695                            GFC_INTEGER_4, const char *);
696 iexport_proto(compare_string);
697
698 /* random.c */
699
700 extern void random_seed_i4 (GFC_INTEGER_4 * size, gfc_array_i4 * put,
701                             gfc_array_i4 * get);
702 iexport_proto(random_seed_i4);
703 extern void random_seed_i8 (GFC_INTEGER_8 * size, gfc_array_i8 * put,
704                             gfc_array_i8 * get);
705 iexport_proto(random_seed_i8);
706
707 /* size.c */
708
709 typedef GFC_ARRAY_DESCRIPTOR (GFC_MAX_DIMENSIONS, void) array_t;
710
711 extern index_type size0 (const array_t * array); 
712 iexport_proto(size0);
713
714 #endif  /* LIBGFOR_H  */