strchr.hpp

Go to the documentation of this file.

// SPDX-License-Identifier: BSL-1.0
// SPDX-FileCopyrightText: Copyright (C) 2020 Tobias Hienzsch
 
#ifndef TETL_CSTRING_STRCHR_HPP
#define TETL_CSTRING_STRCHR_HPP
 
#include <etl/_config/all.hpp>
 
#include <etl/_contracts/check.hpp>
#include <etl/_cstddef/size_t.hpp>
#include <etl/_strings/cstr.hpp>
#include <etl/_type_traits/is_constant_evaluated.hpp>
 
namespace etl {
 
/// \ingroup cstring
/// @{
 
/// Finds the first occurrence of the character static_cast<char>(ch) in
/// the byte string pointed to by str.
///
/// The terminating null character is considered to be a part of the
/// string and can be found if searching for '\0'.
///
/// https://en.cppreference.com/w/cpp/string/byte/strchr
///
/// \ingroup cstring
[[nodiscard]] constexpr auto strchr(char const* str, int ch) -> char const*
{
    TETL_PRECONDITION(str != nullptr);
    if (not is_constant_evaluated()) {
#if __has_builtin(__builtin_strchr)
        return __builtin_strchr(str, ch);
#endif
    }
    return etl::detail::strchr<char const>(str, ch);
}
 
[[nodiscard]] constexpr auto strchr(char* str, int ch) -> char*
{
    TETL_PRECONDITION(str != nullptr);
    if (not is_constant_evaluated()) {
#if __has_builtin(__builtin_strchr)
        return __builtin_strchr(str, ch);
#endif
    }
    return etl::detail::strchr<char>(str, ch);
}
 
/// @}
 
} // namespace etl
 
#endif // TETL_CSTRING_STRCHR_HPP