libcsupport/src/assoc32tostring.c

0001 /* SPDX-License-Identifier: BSD-2-Clause */
0002
0003 /*
0004  * Copyright (c) 2016 embedded brains GmbH & Co. KG
0005  *
0006  * Redistribution and use in source and binary forms, with or without
0007  * modification, are permitted provided that the following conditions
0008  * are met:
0009  * 1. Redistributions of source code must retain the above copyright
0010  *    notice, this list of conditions and the following disclaimer.
0011  * 2. Redistributions in binary form must reproduce the above copyright
0012  *    notice, this list of conditions and the following disclaimer in the
0013  *    documentation and/or other materials provided with the distribution.
0014  *
0015  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
0016  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
0017  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
0018  * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
0019  * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
0020  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
0021  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
0022  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
0023  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
0024  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
0025  * POSSIBILITY OF SUCH DAMAGE.
0026  */
0027
0028 #ifdef HAVE_CONFIG_H
0029 #include "config.h"
0030 #endif
0031
0032 #include <rtems/assoc.h>
0033
0034 #include <stdbool.h>
0035 #include <string.h>
0036
0037 static size_t space( size_t buffer_size, size_t len )
0038 {
0039   if ( len < buffer_size ) {
0040     return buffer_size - len;
0041   } else {
0042     return 0;
0043   }
0044 }
0045
0046 size_t rtems_assoc_32_to_string(
0047   uint32_t                   value,
0048   char                      *buffer,
0049   size_t                     buffer_size,
0050   const rtems_assoc_32_pair *pairs,
0051   size_t                     pair_count,
0052   const char                *separator,
0053   const char                *fallback
0054 )
0055 {
0056   size_t len;
0057   size_t i;
0058
0059   len = 0;
0060
0061   for ( i = 0; i < pair_count ; ++i ) {
0062     const rtems_assoc_32_pair *p;
0063
0064     p = &pairs[ i ];
0065
0066     if ( ( value & p->bits ) != 0 ) {
0067       if ( len > 0 ) {
0068         len += strlcpy( &buffer[ len ], separator, space( buffer_size, len ) );
0069       }
0070
0071       len += strlcpy( &buffer[ len ], p->name, space( buffer_size, len ) );
0072     }
0073   }
0074
0075   if ( len == 0 ) {
0076     len += strlcpy( buffer, fallback, buffer_size );
0077   }
0078
0079   return len;
0080 }