/** @file  ../include/strings.h

@internalComponent

*/

/** @fn  bcmp(const void *b1, const void *b2, size_t length)

@param b1

@param b2

@param length

@return   bcmp function returns 0 if the byte sequences are equal and non-zero 

  otherwise.

  The bcmp function compares byte string b1 against byte string b2, returning zero if they are identical and non-zero otherwise. Both 

strings are assumed to be length bytes long. Zero-length strings are always identical.

 The strings may overlap.

Examples:

@code

#include <string.h>

#include <stdio.h>

int main()

{

   int ret = 0;

   ret = bcmp("a","a",1);               

   printf("bcmp(\"a\",\"a\",1) is %d",ret);

   ret = bcmp("abcd","abce",4); 

   printf("

bcmp(\"abcd\",\"abce\",1) is %d",ret);

   ret = bcmp("abc","xyz",0);

   printf("

bcmp(\"abc\",\"xyz\",0) is %d",ret);

   return 0;

}

@endcode

 Output

@code

bcmp("a","a",1) is 0

bcmp("abcd","abce",1) is -1

bcmp("abc","xyz",0) is 0

@endcode

@see memcmp()

@see strcasecmp()

@see strcmp()

@see strcoll()

@see strxfrm()

@publishedAll

@externallyDefinedApi

*/

/** @fn  bcopy(const void *src0, void *dst0, size_t length)

@param src0

@param dst0

@param length

  The bcopy function copies length bytes from string src0 to string dst0 . The two strings may overlap. If length is zero no bytes are copied.

Examples:

@code

#include <string.h>

#include <stdio.h>

int main()

{

    char dst[50];

    bcopy("Hello World",dst,12);        

    printf("Destination string after bcopy = %s

",dst);

    return 0;

}

@endcode

 Output

@code

Destination string after bcopy = Hello World

@endcode

@see memccpy()

@see memcpy()

@see memmove()

@see strcpy()

@publishedAll

@externallyDefinedApi

*/

/** @fn  bzero(void *b, size_t len)

@param b

@param len

  The bzero function

writes len zero bytes to the string b. If len is zero, bzero does nothing.

Examples:

@code

#include <string.h>

#include <stdio.h>

int main()

{

    char dst[50] = "abcdef";

    bzero(dst + 2, 2);

    if(!strcmp(dst, "ab")) printf("dst =  %s

",dst);

    if(!strcmp(dst+3, "")) printf("zeros added to dst string

");

    if(!strcmp(dst + 4, "ef")) printf("dst + 4 = %s

",dst);

    return 0;

}

@endcode

 Output

@code

dst =  ab

zeros added to dst string

dst + 4 = ab

@endcode

@see memset()

@see swab()

@publishedAll

@externallyDefinedApi

*/

/** @fn  ffs(int mask)

@param mask

Note: This description also covers the following functions -

 ffsl()  fls()  flsl() 

@return  

  The ffs and ffsl functions find the first bit set in mask and return the index of that bit.

 The fls and flsl functions find the last bit set in mask and return the index of that bit.

 Bits are numbered starting from 1, starting at the right-most

(least significant) bit.

A return value of zero from any of these functions means that the

argument was zero.

Examples:

@code

#include <string.h>

#include <stdio.h>

int main()

{

    int i = 0x10;

    int j = ffs(i);

    if(j == 5) printf("First bit position in 0x10 is %d

",j);

    return 0;

}

@endcode

 Output

@code

First bit position in 0x10 is 5

@endcode

@publishedAll

@externallyDefinedApi

*/

/** @fn  index(const char *p, int ch)

@param p

@param ch

Note: This description also covers the following functions -

 rindex() 

@return   The functions index and rindex return a pointer to the located character, or NULL if the character does not appear in the string.

The  index function locates the first occurrence of  ch (converted to a char ) in the string pointed to by p. The terminating null character is considered part of the string; therefore if  ch is ‘\\0,’ the functions locate the terminating ‘\\0.’

The rindex function is identical to index, except it locates the last occurrence of ch.

Examples:

@code

#include <string.h>

#include <stdio.h>

int main()

{

    char one[50];

    char* ret;

    strcpy(one,"abcd");

    ret = index(one, ’c’);

    if(!strncmp(one+2,ret,1)) printf("index of \ ’c\ ’ in string \"abcd\" is %d \n",2);

    ret = index(one, ’z’);

    if(ret == NULL) printf("\ ’z\ ’ not found in string \"abcd\"\n");

    ret = index(one, ’\0’);

    if(!strncmp(one+4,ret,1)) printf("index of \ ’\ \0\ ’ in string \"abcd\" is %d\n",4);

    strcpy(one,"cdcab");

    ret = rindex(one, ’c’);

    if(!strncmp(one+2,ret,1)) printf("rindex of \ ’c\ ’ in string \"cscab\" is %d\n",2);

    strcpy(one,"dcab");

    ret = rindex(one, ’\0’);

    if(!strncmp(one+4,ret,1)) printf("index of \ ’\ \0\ ’ in string \"dcab\" is %d\n",4);

    return 0;

}

@endcode

 Output

@code

index of ’c’ in string "abcd" is 2

 ’z’ not found in string "abcd"

index of ’\0’ in string "abcd" is 4

rindex of ’c’ in string "cscab" is 2

index of ’\0’ in string "dcab" is 4

@endcode

@see memchr()

@see strchr()

@see strcspn()

@see strpbrk()

@see strsep()

@see strspn()

@see strstr()

@see strtok()

@publishedAll

@externallyDefinedApi

*/

/** @fn  rindex(const char *p, int ch)

@param p

@param ch

Refer to  index() for the documentation

@see memchr()

@see strchr()

@see strcspn()

@see strpbrk()

@see strsep()

@see strspn()

@see strstr()

@see strtok()

@publishedAll

@externallyDefinedApi

*/

/** @fn  strcasecmp(const char *s1, const char *s2)

@param s1

@param s2

Note: This description also covers the following functions -

 strncasecmp() 

@return   The strcasecmp and strncasecmp return an integer greater than, equal to, or less than 0, 

according to whether s1 is lexicographically greater than, equal to, or less than s2 after translation of each corresponding character to lower-case. The 

strings themselves are not modified.

  The strcasecmp and strncasecmp functions

compare the null-terminated strings s1 and s2. The  strcasecmp() function compares the two strings s1 and s2 , ignoring

the case of the characters.

 The strncasecmp compares at most len characters.

Examples:

@code

#include <string.h>

#include <stdio.h>

int main()

{

    int ret;

    ret = strcasecmp("ABC","abc");

    printf("strcasecmp of \"ABC\" \"abc\" is %d

",ret);

    ret = strcasecmp("abc","abc");

    printf("strcasecmp of \"abc\" \"abc\" is %d

",ret);

    return 0;   

}

@endcode

 Output

@code

strcasecmp of "ABC" "abc" is 0

strcasecmp of "abc" "abc" is 0

@endcode

@see bcmp()

@see memcmp()

@see strcmp()

@see strcoll()

@see strxfrm()

@see tolower()

@publishedAll

@externallyDefinedApi

*/

/** @fn  strncasecmp(const char *s1, const char *s2, size_t n)

@param s1

@param s2

@param n

Refer to  strcasecmp() for the documentation

@see bcmp()

@see memcmp()

@see strcmp()

@see strcoll()

@see strxfrm()

@see tolower()

@publishedAll

@externallyDefinedApi

*/