efl/legacy/eina/src/include/eina_inline_str.x

55 lines
1.7 KiB
Plaintext

/* EINA - EFL data type library
* Copyright (C) 2002-2008 Gustavo Sverzut Barbieri
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library;
* if not, see <http://www.gnu.org/licenses/>.
*/
#ifndef EINA_STR_INLINE_H_
#define EINA_STR_INLINE_H_
/**
* @addtogroup Eina_String_Group String
*
* @{
*/
/**
* @brief Count up to a given amount of bytes of the given string.
*
* @param str The string pointer.
* @param maxlen The maximum length to allow.
* @return the string size or (size_t)-1 if greater than @a maxlen.
*
* This function returns the size of @p str, up to @p maxlen
* characters. It avoid needless iterations after that size. @p str
* must be a valid pointer and MUST not be @c NULL, otherwise this
* function will crash. This function returns the string size, or
* (size_t)-1 if the size is greater than @a maxlen.
*/
static inline size_t
eina_strlen_bounded(const char *str, size_t maxlen)
{
const char *itr, *str_maxend = str + maxlen;
for (itr = str; *itr != '\0'; itr++)
if (itr == str_maxend) return (size_t)-1;
return itr - str;
}
/**
* @}
*/
#endif /* EINA_STR_INLINE_H_ */