[thirdparty/gcc.git] / gcc / m2 / mc-boot / GmcSearch.h

/* do not edit automatically generated by mc from mcSearch.  */
/* mcSearch.def mcSearch provides a mechanism to search selected directories.

Copyright (C) 2015-2023 Free Software Foundation, Inc.
Contributed by Gaius Mulley <gaius.mulley@southwales.ac.uk>.

This file is part of GNU Modula-2.

GNU Modula-2 is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 3, or (at your option)
any later version.

GNU Modula-2 is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
General Public License for more details.

You should have received a copy of the GNU General Public License
along with GNU Modula-2; see the file COPYING3.  If not see
<http://www.gnu.org/licenses/>.  */


#if !defined (_mcSearch_H)
#   define _mcSearch_H

#include "config.h"
#include "system.h"
#   ifdef __cplusplus
extern "C" {
#   endif
#   if !defined (PROC_D)
#      define PROC_D
       typedef void (*PROC_t) (void);
       typedef struct { PROC_t proc; } PROC;
#   endif

#   include "GDynamicStrings.h"

#   if defined (_mcSearch_C)
#      define EXTERN
#   else
#      define EXTERN extern
#   endif


/*
   initSearchPath - initialise the compiler search, path.
                    The string path may take the form:

                    Path           ::= IndividualPath { ":" IndividualPath }
                    IndividualPath ::= "." | DirectoryPath
                    DirectoryPath  ::= [ "/" ] Name { "/" Name }
                    Name           ::= Letter { (Letter | Number) }
                    Letter         ::= A..Z | a..z
                    Number         ::= 0..9
*/

EXTERN void mcSearch_initSearchPath (DynamicStrings_String path);

/*
   prependSearchPath - prepends a new path to the initial search path.
*/

EXTERN void mcSearch_prependSearchPath (DynamicStrings_String path);

/*
   findSourceFile - attempts to locate the source file FileName.
                    If a file is found then TRUE is returned otherwise
                    FALSE is returned.
                    The parameter FullPath is set indicating the
                    absolute location of source FileName.
                    FullPath will be totally overwritten and should
                    not be initialized by InitString before this function
                    is called.
                    FindSourceFile sets FullPath to a new string if successful.
*/

EXTERN unsigned int mcSearch_findSourceFile (DynamicStrings_String FileName, DynamicStrings_String *fullPath);

/*
   findSourceDefFile - attempts to find the definition module for
                       a module, Stem. If successful it returns
                       the full path and returns TRUE. If unsuccessful
                       then FALSE is returned and FullPath is set to NIL.
*/

EXTERN unsigned int mcSearch_findSourceDefFile (DynamicStrings_String stem, DynamicStrings_String *fullPath);

/*
   findSourceModFile - attempts to find the implementation module for
                       a module, Stem. If successful it returns
                       the full path and returns TRUE. If unsuccessful
                       then FALSE is returned and FullPath is set to NIL.
*/

EXTERN unsigned int mcSearch_findSourceModFile (DynamicStrings_String stem, DynamicStrings_String *fullPath);

/*
   setDefExtension - sets the default extension for definition modules to, ext.
                     The string, ext, should be deallocated by the caller at
                     an appropriate time.
*/

EXTERN void mcSearch_setDefExtension (DynamicStrings_String ext);

/*
   setModExtension - sets the default extension for implementation and program
                     modules to, ext. The string, ext, should be deallocated
                     by the caller at an appropriate time.
*/

EXTERN void mcSearch_setModExtension (DynamicStrings_String ext);
#   ifdef __cplusplus
}
#   endif

#   undef EXTERN
#endif
Commit	Line	Data
1eee94d3 GM	1	/* do not edit automatically generated by mc from mcSearch. */
	2	/* mcSearch.def mcSearch provides a mechanism to search selected directories.
	3
83ffe9cd	4	Copyright (C) 2015-2023 Free Software Foundation, Inc.
1eee94d3 GM	5	Contributed by Gaius Mulley <gaius.mulley@southwales.ac.uk>.
	6
	7	This file is part of GNU Modula-2.
	8
	9	GNU Modula-2 is free software; you can redistribute it and/or modify
	10	it under the terms of the GNU General Public License as published by
	11	the Free Software Foundation; either version 3, or (at your option)
	12	any later version.
	13
	14	GNU Modula-2 is distributed in the hope that it will be useful, but
	15	WITHOUT ANY WARRANTY; without even the implied warranty of
	16	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
	17	General Public License for more details.
	18
	19	You should have received a copy of the GNU General Public License
	20	along with GNU Modula-2; see the file COPYING3. If not see
	21	<http://www.gnu.org/licenses/>. */
	22
	23
	24	#if !defined (_mcSearch_H)
	25	# define _mcSearch_H
	26
	27	#include "config.h"
	28	#include "system.h"
	29	# ifdef __cplusplus
	30	extern "C" {
	31	# endif
	32	# if !defined (PROC_D)
	33	# define PROC_D
	34	typedef void (*PROC_t) (void);
	35	typedef struct { PROC_t proc; } PROC;
	36	# endif
	37
	38	# include "GDynamicStrings.h"
	39
	40	# if defined (_mcSearch_C)
	41	# define EXTERN
	42	# else
	43	# define EXTERN extern
	44	# endif
	45
	46
	47	/*
	48	initSearchPath - initialise the compiler search, path.
	49	The string path may take the form:
	50
	51	Path ::= IndividualPath { ":" IndividualPath }
	52	IndividualPath ::= "." \| DirectoryPath
	53	DirectoryPath ::= [ "/" ] Name { "/" Name }
	54	Name ::= Letter { (Letter \| Number) }
	55	Letter ::= A..Z \| a..z
	56	Number ::= 0..9
	57	*/
	58
	59	EXTERN void mcSearch_initSearchPath (DynamicStrings_String path);
	60
	61	/*
	62	prependSearchPath - prepends a new path to the initial search path.
	63	*/
	64
	65	EXTERN void mcSearch_prependSearchPath (DynamicStrings_String path);
	66
	67	/*
	68	findSourceFile - attempts to locate the source file FileName.
69	If a file is found then TRUE is returned otherwise
70	FALSE is returned.
71	The parameter FullPath is set indicating the
72	absolute location of source FileName.
73	FullPath will be totally overwritten and should
74	not be initialized by InitString before this function
75	is called.
76	FindSourceFile sets FullPath to a new string if successful.
77	*/
78
79	EXTERN unsigned int mcSearch_findSourceFile (DynamicStrings_String FileName, DynamicStrings_String *fullPath);
80
81	/*
82	findSourceDefFile - attempts to find the definition module for
83	a module, Stem. If successful it returns
84	the full path and returns TRUE. If unsuccessful
85	then FALSE is returned and FullPath is set to NIL.
86	*/
87
88	EXTERN unsigned int mcSearch_findSourceDefFile (DynamicStrings_String stem, DynamicStrings_String *fullPath);
89
90	/*
91	findSourceModFile - attempts to find the implementation module for
92	a module, Stem. If successful it returns
93	the full path and returns TRUE. If unsuccessful
94	then FALSE is returned and FullPath is set to NIL.
95	*/
96
97	EXTERN unsigned int mcSearch_findSourceModFile (DynamicStrings_String stem, DynamicStrings_String *fullPath);
98
99	/*
100	setDefExtension - sets the default extension for definition modules to, ext.
101	The string, ext, should be deallocated by the caller at
102	an appropriate time.
103	*/
104
105	EXTERN void mcSearch_setDefExtension (DynamicStrings_String ext);
106
107	/*
108	setModExtension - sets the default extension for implementation and program
109	modules to, ext. The string, ext, should be deallocated
110	by the caller at an appropriate time.
111	*/
112
113	EXTERN void mcSearch_setModExtension (DynamicStrings_String ext);
114	# ifdef __cplusplus
115	}
116	# endif
117
118	# undef EXTERN
119	#endif