mirror of
https://git.savannah.gnu.org/git/make.git
synced 2024-11-25 04:35:44 +00:00
2fb91e19a0
Expand the characters which are legal in a function name, and check the name for validity. Create a type for the function pointer. Convert the last argument from a boolean to flags, to allow for expansion.
79 lines
2.8 KiB
C
79 lines
2.8 KiB
C
/* External interfaces usable by dynamic objects loaded into GNU Make.
|
|
--THIS API IS A "TECHNOLOGY PREVIEW" ONLY. IT IS NOT A STABLE INTERFACE--
|
|
|
|
Copyright (C) 2013 Free Software Foundation, Inc.
|
|
This file is part of GNU Make.
|
|
|
|
GNU Make 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 of the License, or (at your option) any later
|
|
version.
|
|
|
|
GNU Make 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
|
|
this program. If not, see <http://www.gnu.org/licenses/>. */
|
|
|
|
#ifndef _GNUMAKE_H_
|
|
#define _GNUMAKE_H_
|
|
|
|
/* Specify the location of elements read from makefiles. */
|
|
typedef struct
|
|
{
|
|
const char *filenm;
|
|
unsigned long lineno;
|
|
} gmk_floc;
|
|
|
|
typedef char *(*gmk_func_ptr)(const char *nm, unsigned int argc, char **argv);
|
|
|
|
#ifdef _WIN32
|
|
# ifdef GMK_BUILDING_MAKE
|
|
# define GMK_EXPORT __declspec(dllexport)
|
|
# else
|
|
# define GMK_EXPORT __declspec(dllimport)
|
|
# endif
|
|
#else
|
|
# define GMK_EXPORT
|
|
#endif
|
|
|
|
/* Free memory returned by the gmk_expand() function. */
|
|
GMK_EXPORT void gmk_free (char *str);
|
|
|
|
/* Allocate memory in GNU make's context. */
|
|
GMK_EXPORT char *gmk_alloc (unsigned int len);
|
|
|
|
/* Run $(eval ...) on the provided string BUFFER. */
|
|
GMK_EXPORT void gmk_eval (const char *buffer, const gmk_floc *floc);
|
|
|
|
/* Run GNU make expansion on the provided string STR.
|
|
Returns an allocated buffer that the caller must free with gmk_free(). */
|
|
GMK_EXPORT char *gmk_expand (const char *str);
|
|
|
|
/* Register a new GNU make function NAME (maximum of 255 chars long).
|
|
When the function is expanded in the makefile, FUNC will be invoked with
|
|
the appropriate arguments.
|
|
|
|
The return value of FUNC must be either NULL, in which case it expands to
|
|
the empty string, or a pointer to the result of the expansion in a string
|
|
created by gmk_alloc(). GNU make will free the memory when it's done.
|
|
|
|
MIN_ARGS is the minimum number of arguments the function requires.
|
|
MAX_ARGS is the maximum number of arguments (or 0 if there's no maximum).
|
|
MIN_ARGS and MAX_ARGS may not exceed 255.
|
|
|
|
The FLAGS value may be GMK_FUNC_DEFAULT, or one or more of the following
|
|
flags OR'd together:
|
|
|
|
GMK_FUNC_NOEXPAND: the arguments to the function will be not be expanded
|
|
before FUNC is called.
|
|
*/
|
|
GMK_EXPORT void gmk_add_function (const char *name, gmk_func_ptr func,
|
|
unsigned int min_args, unsigned int max_args,
|
|
unsigned int flags);
|
|
|
|
#define GMK_FUNC_DEFAULT 0x00
|
|
#define GMK_FUNC_NOEXPAND 0x01
|
|
|
|
#endif /* _GNUMAKE_H_ */
|