safec  2.1
Safe C Library - ISO TR24731 Bounds Checking Interface
strzero_s.c
Go to the documentation of this file.
1 /*------------------------------------------------------------------
2  * strzero_s.c
3  *
4  * October 2008, Bo Berry
5  *
6  * Copyright (c) 2008-2011 by Cisco Systems, Inc
7  * All rights reserved.
8  *
9  * Permission is hereby granted, free of charge, to any person
10  * obtaining a copy of this software and associated documentation
11  * files (the "Software"), to deal in the Software without
12  * restriction, including without limitation the rights to use,
13  * copy, modify, merge, publish, distribute, sublicense, and/or
14  * sell copies of the Software, and to permit persons to whom the
15  * Software is furnished to do so, subject to the following
16  * conditions:
17  *
18  * The above copyright notice and this permission notice shall be
19  * included in all copies or substantial portions of the Software.
20  *
21  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
22  * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
23  * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
24  * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
25  * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
26  * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
27  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
28  * OTHER DEALINGS IN THE SOFTWARE.
29  *------------------------------------------------------------------
30  */
31 
32 #include "safeclib_private.h"
33 #include "safe_str_constraint.h"
34 #include "safe_str_lib.h"
35 
36 
59 errno_t
60 strzero_s (char *dest, rsize_t dmax)
61 {
62  if (dest == NULL) {
63  invoke_safe_str_constraint_handler("strzero_s: dest is null",
64  NULL, ESNULLP);
65  return (ESNULLP);
66  }
67 
68  if (dmax == 0) {
69  invoke_safe_str_constraint_handler("strzero_s: dmax is 0",
70  NULL, ESZEROL);
71  return (ESZEROL);
72  }
73 
74  if (dmax > RSIZE_MAX_STR) {
75  invoke_safe_str_constraint_handler("strzero_s: dmax exceeds max",
76  NULL, ESLEMAX);
77  return (ESLEMAX);
78  }
79 
80  /* null string to eliminate data */
81  while (dmax) {
82  *dest = '\0';
83  dmax--;
84  dest++;
85  }
86 
87  return (EOK);
88 }
errno_t strzero_s(char *dest, rsize_t dmax)
Nulls dmax characters of dest.
Definition: strzero_s.c:60
void invoke_safe_str_constraint_handler(const char *msg, void *ptr, errno_t error)
Invokes the currently set constraint handler or the default.