Watcom C Library : strcmp, _fstrcmp, strcmpi, strcoll, strcpy, _fstrcpy, strcspn, _fstrcspn, strdup, _fstrdup

 

 

Watcom C Library Reference : strcmp, _fstrcmp, strcmpi, strcoll, strcpy, _fstrcpy, strcspn, _fstrcspn, strdup, _fstrdup

 

 

 

 

strcmp, _fstrcmp

 

Synopsis : #include <string.h> 

              int strcmp( const char *s1, const char *s2 );

              int _fstrcmp( const char __far *s1, const char __far *s2);


Description : The strcmp and _fstrcmp functions compare the string pointed to by s1 to the string pointed to by s2.

 

The _fstrcmp function is a data model independent form of the strcmp function that accepts far pointer arguments. It is most useful in mixed memory model applications.

 

 

Returns : The strcmp and _fstrcmp functions return an integer less than, equal to, or greater than zero, indicating that the string pointed to by s1 is less than, equal to, or greater than the string pointed to by s2.

 

 

See Also : stricmp, strncmp, strnicmp

 

Example :

#include <stdio.h> 

#include <string.h>

void main( )

{
    printf( "%d\n", strcmp( "abcdef", "abcdef" ) );

    printf( "%d\n", strcmp( "abcdef", "abc" ) );

    printf( "%d\n", strcmp( "abc", "abcdef" ) );

    printf( "%d\n", strcmp( "abcdef", "mnopqr" ) );

    printf( "%d\n", strcmp( "mnopqr", "abcdef" ) );

}

 

produces the following :
0

1

-1

-1

1

 

Classification : strcmp is ANSI, _fstrcmp is not ANSI
Systems : strcmp - All 

             _fstrcmp - All

 

 

 

 

 

 

 

strcmpi

 

Synopsis : #include <string.h> 

              int strcmpi( const char *s1, const char *s2 );

 

Description : The strcmpi function compares, with case insensitivity, the string pointed to by s1 to the string pointed to by s2. All uppercase characters from s1 and s2 are mapped to lowercase for the purposes of doing the comparison. The strcmpi function is identical to the stricmp function.

 

 

Returns : The strcmpi function returns an integer less than, equal to, or greater than zero, indicating that the string pointed to by s1 is less than, equal to, or greater than the string pointed to by s2.

 

 

See Also : strcmp, stricmp, strncmp, strnicmp

 

Example :

#include <stdio.h> 

#include <string.h>

void main( )

{
    printf( "%d\n", strcmpi( "AbCDEF", "abcdef" ) );

    printf( "%d\n", strcmpi( "abcdef", "ABC" ) );

    printf( "%d\n", strcmpi( "abc", "ABCdef" ) );

    printf( "%d\n", strcmpi( "Abcdef", "mnopqr" ) );

    printf( "%d\n", strcmpi( "Mnopar", "abcdef" ) );

}

 

produces the following :
0
100 

-100 

-12

12

 

Classification : WATCOM
Systems : All

 

 

 

 

 

 

 

strcoll

 

Synopsis : #include <string.h> 

              int strcoll( const char *s1, const char *s2 );


Description : The strcoll function compares the string pointed to by s1 to the string pointed to by s2. The comparison uses the collating sequence selected by the setlocale function. The function will be equivalent to the strcmp function when the collating sequence is selected from the "C" locale.

 

 

Returns : The strcoll function returns an integer less than, equal to, or greater than zero, indicating that the string pointed to by s1 is less than, equal to, or greater than the string pointed to by s2, according to the collating sequence selected.

 

 

See Also : setlocale, strncmp

 

Example :

#include <stdio.h> 

#include <string.h>

char buffer[80] = "world";

void main( )

{
    if( strcoll( buffer, "Hello" ) < 0 ) {
        printf( "Less than\n" );

    }

}

 

Classification : ANSI
Systems : All

 

 

 

 

 

 

 

strcpy, _fstrcpy

 

Synopsis : #include <string.h> 

              char *strcpy( char *dst, const char *src );

              char __far *_fstrcpy( char __far *dst, const char __far *src);


Description : The strcpy and _fstrcpy functions copy the string pointed to by src (including the terminating null character) into the array pointed to by dst. Copying of overlapping objects is not guaranteed to work properly. See the description for the memmove function to copy objects that overlap.

The _fstrcpy function is a data model independent form of the strcpy function. It accepts far pointer arguments and returns a far pointer. It is most useful in mixed memory model applications.

 

 

Returns : The value of dst is returned.

 

 

See Also : strdup, strncpy

 

Example :

#include <stdio.h> 

#include <string.h>

void main( )

{
    auto char buffer[80];

    strcpy( buffer, "Hello " );

    strcat( buffer, "world" );

    printf( "%s\n", buffer );

}

 

produces the following :
Hello world

 

Classification : strcpy is ANSI, _fstrcpy is not ANSI
Systems : strcpy - All

             _fstrcpy - All

 

 

 

 

 

 

 

strcspn, _fstrcspn

 

Synopsis : #include <string.h> 

              size_t strcspn( const char *str, const char *charset ); 

              size_t _fstrcspn( const char __far *str, const char __far *charset );

 

Description : The strcspn and _fstrcspn functions compute the length of the initial segment of the string pointed to by str which consists entirely of characters not from the string pointed to by charset. The terminating null character is not considered part of str.

The _fstrcspn function is a data model independent form of the strcspn function that accepts far pointer arguments. It is most useful in mixed memory model applications.

 

 

Returns : The length of the initial segment is returned.

 

 

See Also : strspn

 

Example :

#include <stdio.h> 

#include <string.h>

void main( )

{
    printf( "%d\n", strcspn( "abcbcadef", "cba" ) );

    printf( "%d\n", strcspn( "xxxbcadef", "cba" ) );

    printf( "%d\n", strcspn( "123456789", "cba" ) );

}

 

produces the following :
0

3

9

 

Classification : strcspn is ANSI, _fstrcspn is not ANSI
Systems : strcspn - All

             _fstrcspn - All

 

 

 

 

 

 

 

 

strdup, _fstrdup

 

Synopsis : #include <string.h> 

              char *strdup( const char *src );

              char __far *_fstrdup( const char __far *src );

 

Description : The strdup and _fstrdup functions create a duplicate copy of the string pointed to by src and returns a pointer to the new copy. For strdup, the memory for the new string is obtained by using the malloc function and can be freed using the free function. For _fstraup, the memory for the new string is obtained by using the _fmalloc function and can be freed using the _ffree function.

The _fstrdup function is a data model independent form of the strdup function that accepts far pointer arguments. It is most useful in mixed memory model applications.

 

 

Returns : The strdup and _fstrdup functions return the pointer to the new copy of the string if successful, otherwise it returns NULL.

 

 

See Also : free, malloc, strcpy, strncpy

 

Example :

#include <stdio.h> 

#include <string.h>

void main( )

{
    char     *dup;

    dup = strdup( "Make a copy" );

    printf( "%s\n", dup );

}

 

Classification : WATCOM
Systems : strdup - All 

             _fstrdup- All

 

 

 

 

 

 

 

 

 

This manual describes the WATCOM C library for DOS, Windows, and OS/2, It includes the Standard C Library (as defined in the ANSI C Standard).

 

WATCOM C Language Reference manual describes the ANSI C Programming language and extensions to it which are supported by WATCOM C/C++ (32bit)