NAME

       avr_string - <string.h>: Strings

   Macros
       #define _FFS(x)

   Functions
       char * strdup (const char *s1)
       size_t strlcat (char *, const char *, size_t)
       size_t strlcpy (char *, const char *, size_t)
       char * strtok (char *, const char *)

Detailed Description

       #include <string.h>

       The string functions perform string operations on NULL terminated strings.

       Note:
           If the strings you are working on resident in program space (flash), you will need to use the string
           functions described in <avr/pgmspace.h>: Program Space Utilities.

Macro Definition Documentation

   #define _FFS(x)
       This macro finds the first (least significant) bit set in the input value.

       This macro is very similar to the function ffs() except that it evaluates its argument at compile-time,
       so it should only be applied to compile-time constant expressions where it will reduce to a constant
       itself. Application of this macro to expressions that are not constant at compile-time is not
       recommended, and might result in a huge amount of code generated.

       Returns:
           The _FFS() macro returns the position of the first (least significant) bit set in the word val, or 0
           if no bits are set. The least significant bit is position 1. Only 16 bits of argument are evaluted.

Function Documentation

   char * strdup (const char * s1)
       Duplicate a string. The strdup() function allocates memory and copies into it the string addressed by s1,
       including the terminating null character.

       Warning:
           The strdup() function calls malloc() to allocate the memory for the duplicated string! The user is
           responsible for freeing the memory by calling free().

       Returns:
           The strdup() function returns a pointer to the resulting string dest. If malloc() cannot allocate
           enough storage for the string, strdup() will return NULL.

       Warning:
           Be sure to check the return value of the strdup() function to make sure that the function has
           succeeded in allocating the memory!

   size_t strlcat (char * dst, const char * src, size_t siz)
       Concatenate two strings. Appends src to string dst of size siz (unlike strncat(), siz is the full size of
       dst, not space left). At most siz-1 characters will be copied. Always NULL terminates (unless siz <=
       strlen(dst)).

       Returns:
           The strlcat() function returns strlen(src) + MIN(siz, strlen(initial dst)). If retval >= siz,
           truncation occurred.

   size_t strlcpy (char * dst, const char * src, size_t siz)
       Copy a string. Copy src to string dst of size siz. At most siz-1 characters will be copied. Always NULL
       terminates (unless siz == 0).

       Returns:
           The strlcpy() function returns strlen(src). If retval >= siz, truncation occurred.

   char * strtok (char * s, const char * delim)
       Parses the string s into tokens. strtok parses the string s into tokens. The first call to strtok should
       have s as its first argument. Subsequent calls should have the first argument set to NULL. If a token
       ends with a delimiter, this delimiting character is overwritten with a '\0' and a pointer to the next
       character is saved for the next call to strtok. The delimiter string delim may be different for each
       call.

       Returns:
           The strtok() function returns a pointer to the next token or NULL when no more tokens are found.

       Note:
           strtok() is NOT reentrant. For a reentrant version of this function see strtok_r().

Author

       Generated automatically by Doxygen for avr-libc from the source code.