table of contents
other versions
other sections
avr_string(3avr) | avr-libc | avr_string(3avr) |
NAME¶
avr_string - <string.h>: StringsMacros¶
#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.Sun Dec 13 2015 | Version 1.8.0svn |