29 lines
1.2 KiB
C
29 lines
1.2 KiB
C
//
|
|
// Copyright 2016 Garrett D'Amore <garrett@damore.org>
|
|
//
|
|
// This software is supplied under the terms of the MIT License, a
|
|
// copy of which should be located in the distribution where this
|
|
// file was obtained (LICENSE.txt). A copy of the license may also be
|
|
// found online at https://opensource.org/licenses/MIT.
|
|
//
|
|
|
|
#ifndef CORE_PANIC_H
|
|
#define CORE_PANIC_H
|
|
|
|
// nni_panic is used to terminate the process with prejudice, and
|
|
// should only be called in the face of a critical programming error,
|
|
// or other situation where it would be unsafe to attempt to continue.
|
|
// As this crashes the program, it should never be used when factors outside
|
|
// the program can cause it, such as receiving protocol errors, or running
|
|
// out of memory. Its better in those cases to return an error to the
|
|
// program and let the caller handle the error situation.
|
|
extern void nni_panic(const char *, ...);
|
|
|
|
// nni_println is used to print output to a debug console. This should only
|
|
// be used in the most dire of circumstances -- such as during an assertion
|
|
// failure that is going to cause the program to crash. After the string is
|
|
// emitted, a new line character is emitted, so the string should not
|
|
// include one.
|
|
extern void nni_println(const char *);
|
|
|
|
#endif // CORE_PANIC_H
|