X-Git-Url: http://sigrok.org/gitweb/?a=blobdiff_plain;f=error.c;h=ce1b0401ddbad2a8dc2aeb54d4d62335ec2db31d;hb=46a743c1fa77b1b68ada2b642c095b4f9034edce;hp=c9b8589e218991059c3dcc4cd4eeeb6fb4f340e7;hpb=393fb9cb18c5746d8567c9cf74b872804043345a;p=libsigrok.git diff --git a/error.c b/error.c index c9b8589e..ce1b0401 100644 --- a/error.c +++ b/error.c @@ -1,5 +1,5 @@ /* - * This file is part of the sigrok project. + * This file is part of the libsigrok project. * * Copyright (C) 2012 Uwe Hermann * @@ -41,10 +41,14 @@ * Return a human-readable error string for the given libsigrok error code. * * @param error_code A libsigrok error code number, such as SR_ERR_MALLOC. + * * @return A const string containing a short, human-readable (English) * description of the error, such as "memory allocation error". * The string must NOT be free'd by the caller! + * * @see sr_strerror_name + * + * @since 0.2.0 */ SR_API const char *sr_strerror(int error_code) { @@ -65,12 +69,18 @@ SR_API const char *sr_strerror(int error_code) case SR_ERR_MALLOC: str = "memory allocation error"; break; + case SR_ERR_ARG: + str = "invalid argument"; + break; case SR_ERR_BUG: str = "internal error"; break; case SR_ERR_SAMPLERATE: str = "invalid samplerate"; break; + case SR_ERR_NA: + str = "not applicable"; + break; default: str = "unknown error"; break; @@ -89,9 +99,13 @@ SR_API const char *sr_strerror(int error_code) * a libsigrok error code is useful. * * @param error_code A libsigrok error code number, such as SR_ERR_MALLOC. + * * @return A const string containing the "name" of the error code as string. * The string must NOT be free'd by the caller! + * * @see sr_strerror + * + * @since 0.2.0 */ SR_API const char *sr_strerror_name(int error_code) { @@ -112,12 +126,18 @@ SR_API const char *sr_strerror_name(int error_code) case SR_ERR_MALLOC: str = "SR_ERR_MALLOC"; break; + case SR_ERR_ARG: + str = "SR_ERR_ARG"; + break; case SR_ERR_BUG: str = "SR_ERR_BUG"; break; case SR_ERR_SAMPLERATE: str = "SR_ERR_SAMPLERATE"; break; + case SR_ERR_NA: + str = "SR_ERR_NA"; + break; default: str = "unknown error code"; break;