/** @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

 */