/*
 * custom - interface for custom software and hardware interfaces
 *
 * Copyright (C) 1999-2007,2021,2023,2026  Landon Curt Noll
 *
 * Calc is open software; you can redistribute it and/or modify it under
 * the terms of the version 2.1 of the GNU Lesser General Public License
 * as published by the Free Software Foundation.
 *
 * Calc 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 Lesser General
 * Public License for more details.
 *
 * A copy of version 2.1 of the GNU Lesser General Public License is
 * distributed with calc under the filename COPYING-LGPL.  You should have
 * received a copy with calc; if not, write to Free Software Foundation, Inc.
 * 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
 *
 * Under source code control:   1997/03/03 04:53:08
 * File existed as early as:    1997
 *
 * chongo <was here> /\oo/\     http://www.isthe.com/chongo/
 * Share and enjoy!  :-)        http://www.isthe.com/chongo/tech/comp/calc/
 */

/*
 * Be careful what you put in this file, upper .c files include
 * this file even when CUSTOM is not defined (ALLOW_CUSTOM="-UCUSTOM").
 *
 * Don't include anything, let the including .c file bring in:
 *
 *      value.h
 *
 * before they include this file.
 *
 * Keep this file down to a minimum.   Don't put custom builtin function
 * stuff in this file!
 */

#if !defined(CUSTOM_H)
#  define CUSTOM_H

/*
 * arg count definitions
 */
#  define MAX_CUSTOM_ARGS 100 /* maximum number of custom arguments */

/*
 * register count
 */
#  define CUSTOM_REG_MAX 31 /* maximum custom register number */

/*
 * custom function interface
 */
struct custom {
    char *name;                                        /* name of the custom builtin */
    char *desc;                                        /* very brief description of custom builtin */
    short minargs;                                     /* minimum number of arguments */
    short maxargs;                                     /* maximum number of arguments */
    VALUE (*func)(char *name, int argc, VALUE **argv); /* custom func */
};

/*
 * external declarations
 *
 * These are the required interfaces.  The dummy.c stubs these interfaces too.
 */
extern bool custom_compiled(void);          /* return true if libcustcalc compiled CUSTOM defined, false otherwise */
extern VALUE custom(char *, int, VALUE **); /* master custom interface */
extern bool allow_custom;                   /* true => custom builtins allowed */
extern void showcustom(void);               /* print custom functions */
extern void customhelp(char *);             /* direct custom help */
extern void init_custreg(void);             /* initialize custom registers */

#endif
