wcsncat.hpp

Go to the documentation of this file.

// SPDX-License-Identifier: BSL-1.0
// SPDX-FileCopyrightText: Copyright (C) 2020 Tobias Hienzsch
 
#ifndef TETL_CWCHAR_WCSNCAT_HPP
#define TETL_CWCHAR_WCSNCAT_HPP
 
#include <etl/_cstddef/size_t.hpp>
#include <etl/_strings/cstr.hpp>
 
namespace etl {
 
/// \brief Appends at most count wide characters from the wide string pointed to
/// by src to the end of the character string pointed to by dest, stopping if
/// the null terminator is copied. The wide character src[0] replaces the null
/// terminator at the end of dest. The null terminator is always appended in the
/// end (so the maximum number of wide characters the function may write is
/// count+1).
///
/// \details The destination byte string must have enough space for the contents
/// of both dest and src plus the terminating null character, except that the
/// size of src is limited to count. The behavior is undefined if the strings
/// overlap.
constexpr auto wcsncat(wchar_t* dest, wchar_t const* src, etl::size_t const count) -> wchar_t*
{
    return etl::detail::strncat<wchar_t, etl::size_t>(dest, src, count);
}
 
} // namespace etl
 
#endif // TETL_CWCHAR_WCSNCAT_HPP