welibc
A clear, secure, and well documented standard C library
strerror.c
Go to the documentation of this file.
1 /*******************************************************************************
2  Copyright (c) 2021 Walt Elam
3  All rights reserved.
4 
5  Redistribution and use in source and binary forms, with or without
6  modification, are permitted provided that the following conditions are met:
7 
8  1. Redistributions of source code must retain the above copyright notice,
9  this list of conditions and the following disclaimer.
10 
11  2. Redistributions in binary form must reproduce the above copyright
12  notice, this list of conditions and the following disclaimer in the
13  documentation and/or other materials provided with the distribution.
14 
15  3. Neither the name of the copyright holder nor the names of its
16  contributors may be used to endorse or promote products derived from
17  this software without specific prior written permission.
18 
19  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
20  AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
21  IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
22  ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
23  LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
24  CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
25  SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
26  INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
27  CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
28  ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
29  POSSIBILITY OF SUCH DAMAGE.
30 *******************************************************************************/
31 /***************************************************************************//**
32  @file strerror.c
33 
34  @brief Defines the strerror function
35 *******************************************************************************/
36 #include <errno.h>
37 #include <string.h>
38 
39 /*******************************************************************************
40  strerror
41 *//**
42  @brief Maps an error number to an error message string
43  @param errnum Error number being mapped
44 
45  The strerror function maps the error number in errnum to an error message
46  string.
47 
48  The implementation shall behave as if no library function calls the strerror
49  function.
50 
51  @return A pointer to a string representation of the error number
52 *******************************************************************************/
53 char *
54 strerror(int errnum)
55 {
56  char *str = NULL;
57 
58  switch (errnum)
59  {
60  case EDOM:
61  str = "EDOM - An input argument is outside the domain over which the mathematical function is defined";
62  break;
63 
64  case ERANGE:
65  str = "ERANGE - The result of the function cannot be represented as a double value";
66  break;
67 
68  default:
69  str = "E??? - Unknown error number";
70  break;
71  }
72 
73  return str;
74 }
75 
NULL
#define NULL
Definition: stddef.h:57
string.h
Declares types, functions, and macros for manipulating arrays of character type and other objects tre...
ERANGE
#define ERANGE
Definition: errno.h:49
strerror
char * strerror(int errnum)
Maps an error number to an error message string.
Definition: strerror.c:54
EDOM
#define EDOM
Definition: errno.h:43
errno.h
Defines macros relating to error reporting conditions.