winamp/Src/replicant/foundation/error.h

89 lines
5.1 KiB
C
Raw Normal View History

2024-09-24 12:54:57 +00:00
#pragma once
#ifdef __cplusplus
extern "C" {
#endif
enum
{
NErr_Success = 0,
NErr_True = 0,
NErr_Error = 1, // generic error
NErr_OutOfMemory = 2,
NErr_FileNotFound = 3,
NErr_NullPointer = 4,
NErr_NotImplemented = 5,// I'm a lazy programmer
NErr_EndOfFile = 6, // also used for "end of enumeration"
NErr_NeedMoreData = 7, // input buffer was too small to provide useful output. Use this instead of NErr_ReadTruncated when it is expected that the caller can call the function again with more data
NErr_False = 8, // returned from a bool-like function to indicate "false" as opposed to "i had an error while figuring it out"
NErr_FailedCreate = 9, // Object could not be created
NErr_Closed = 10,
NErr_TryAgain = 11, // often used in round-robin "isMine()" loops to indicate that you'll take it if no one else wants it first. can also be used for device I/O when the device is busy
NErr_NoDevice = 12,
NErr_UnsupportedFormat = 13,
NErr_Unknown = 14, // NOT meant to be "some unknown error". Usually returned when some passed in enumeration or keyword was an unknown, unexpected or unsupported value
NErr_Insufficient = 15, // output buffer was too small
NErr_Empty = 16,
NErr_LostSynchronization = 17,
NErr_TimedOut = 19,
NErr_BadParameter = 20,
NErr_NoAction = 21, // Returned when no action performed, for example when initializing but something has already been initialized
// Test case related values
NErr_TestFailed = 18, // Result on a test failure, typically used by unit tests and other test cases.
NErr_TestPassed = 0, // Result on a test success, typically used by unit tests and other test cases.
NErr_TestError = 1, // Result on a test error, typically used by unit tests and other test cases.
NErr_TestNotComplete = 22, // Result on a premature stop, typically used by unit tests and other test cases. This is to protect against a scenerio where a test case is in a 'PASSED' state up to a certain point but cannot finish execution due to data missing, environmental issues, etc.
NErr_Malformed = 23, // some peice of data was malformed or had unexpected value (typically returned by parsers)
NErr_WrongFormat = 24, // data was understood but is indicating a different format than expected. e.g. an layer 2 header being encountered by a layer 3 parser
NErr_Reserved = 25, // typically returned when a parser encounters data with a reserved flag set to true
NErr_Changed = 26, // something changed. e.g. samplerate changed mid-stream
NErr_Interrupted = 27,
NErr_ConnectionFailed = 28, // generic "can't connect" error
NErr_DNS = 29, // no DNS entry for the host
/* the follow map NError codes to HTTP error codes. but they can be used for other purposes, too */
NErr_BadRequest = 30, // aka HTTP 400
NErr_Unauthorized = 31, // aka HTTP 401
NErr_Forbidden = 32, // aka HTTP 403
NErr_NotFound = 33, // aka HTTP 404, differentiated from NErr_FileNotFound
NErr_BadMethod = 34, // aka HTTP 405
NErr_NotAcceptable = 35, // aka HTTP 406
NErr_ProxyAuthenticationRequired = 36, // aka HTTP 407
NErr_RequestTimeout = 37, // aka HTTP 408
NErr_Conflict = 38, // aka HTTP 409
NErr_Gone = 39, // aka HTTP 410
NErr_InternalServerError = 40, // aka HTTP 500
NErr_ServiceUnavailable = 41, // aka HTTP 503
NErr_Exception = 42, // Underlying library returns an error or exception that wasn't understood
NErr_Underrun = 43, // Asynchronous thread not supplying data fast enough, buffer has insufficient data
NErr_NoMatchingImplementation = 44, // Returned when a function that delegates functionality to a matching component is unable to find one e.g. api_playlistmanager::Load
NErr_IntegerOverflow = 45,
NErr_IncompatibleVersion = 46, // returned e.g. when a "size" field in a passed struct was larger than expected, or when a flag was set that's not understood
NErr_Disabled = 47,
NErr_ParameterOutOfRange = 48, // Used to signify that a paramater was passed in that is out of bounds for valid values.
NErr_OSNotSupported = 49, // something is not supported on this OS (e.g. WASAPI audio on Windows XP)
NErr_UnsupportedInterface = 50, // used for some APIs (notably svc_decode). It means that you can provide the requested functionality for the provided data (e.g. filename) but don't support the requested interface
NErr_DirectPointer = 51,
NErr_ReadOnly = 52,
NErr_EndOfEnumeration = NErr_EndOfFile, // we'll eventually make this its own number
NErr_ReadTruncated = 54, // somewhat similar to NErr_NeedMoreData. Meant to be used e.g. when a file or input buffer is shorter than expected. Use this instead of NErr_NeedMoreData when the caller cannot provide more data.
NErr_Aborted = 55,
NErr_BadReturnValue = 56, // e.g. a callback function returns an unexpected value
NErr_MaximumDepth = 57,
NErr_Stopped = 58,
NErr_LengthRequired = 59, // aka HTTP 411
NErr_PreconditionFailed = 60, // aka HTTP 411
NErr_TooLarge = 61, // aka HTTP 413
};
typedef int NError;
typedef int ns_error_t; // TODO: eventually make this the name of the enum
#ifdef __cplusplus
}
#endif
// be careful. only use this if your stack variables self-destruct
#define NSERROR_RETURN_ON_FAILURE(x) { int local_ret = x; if (local_ret != NErr_Success) return local_ret; }