Watcom C Library : strncmp, _fstrncmp, strncpy, _fstrncpy, strnicmp, _fstrnicmp, strnset, _fstrnset, strpbrk, _fstrpbrk,
Watcom C Reference/S 2021. 11. 16. 19:53
Watcom C Library Reference : strncmp, _fstrncmp, strncpy, _fstrncpy, strnicmp, _fstrnicmp, strnset, _fstrnset, strpbrk, _fstrpbrk,
strncmp, _fstrncmp
Synopsis : #include <string.h>
int strncmp( const char *s1, const char *s2, size_t n );
int _fstrncmp( const char __far *s1, const char __far *s2, size_t n );
Description : The strncmp and _fstrncmp functions compare not more than n characters from the string pointed to by s1 to the string pointed to by s2.
The _fstrncmp function is a data model independent form of the strncmp function that accepts far pointer arguments. It is most useful in mixed memory model applications.
Returns : The strncmp and _fstrncmp 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 : strcmp, stricmp, strnicmp
Example :
#include <stdio.h>
#include <string.h>
void main( )
{
printf( "%d\n", strncmp( "abcdef", "abcDEF", 10 ) );
printf( "%d\n", strncmp( "abcdef", "abcDEF", 6 ) );
printf( "%d\n", strncmp( "abcdef", "abcDEF", 3 ) );
printf( "%d\n", strncmp( "abcdef", "abcDEF", 0 ) );
}
produces the following :
1
1
0
0
Classification : strncmp is ANSI, _fstrncmp is not ANSI
Systems : strncmp - All
_fstrncmp - All
strncpy, _fstrncpy
Synopsis : #include <string.h>
char *strncpy( char *dst, const char *src, size_t n );
char __far *_fstrncpy( char __far *dst, const char __far *src, size_t n );
Description : The strncpy and _fstrncpy functions copy no more than n characters from the string pointed to by src into the array pointed to by dst. Copying of overlapping objects is not guaranteed to work properly. See the memmove function if you wish to copy objects that overlap.
If the string pointed to by src is shorter than n characters, null characters are appended to the copy in the array pointed to by dst, until n characters in all have been written. If the string pointed to by src is longer than n characters, then the result will not be terminated by a null character.
The _fstrncpy function is a data model independent form of the strncpy function. It accepts far pointer arguments and returns a far pointer. It is most useful in mixed memory model applications.
Returns : The strncpy and _fstrncpy functions return the value of dst.
See Also : strcpy, strdup
Example :
#include <stdio.h>
#include <string.h>
void main( )
{
char buffer[15];
printf( "%s\n", strncpy( buffer, "abcdefg", 10 ) );
printf( "%s\n", strncpy( buffer, "1234567", 6) );
printf( "%s\n", strncpy( buffer, "abcdefg", 3 ) );
printf( "%s\n", strncpy( buffer, "*******", 0) );
}
produces the following :
abcdefg
123456g
abc456g
abc456g
Classification : strncpy is ANSI, _fstrncpy is not ANSI
Systems : strncpy - All
_fstrncpy - All
strnicmp, _fstrnicmp
Synopsis : #include <string.h>
int strnicmp( const char *s1, const char *s2, size_t len );
int _fstrnicmp( const char __far *s1, const char __far *s2, size_t len );
Description : The strnicmp and _fstrnicmp functions compare, without case sensitivity, the string pointed to by s1 to the string pointed to by s2, for at most len characters.
The _fstrnicmp function is a data model independent form of the strnicmp function that accepts far pointer arguments. It is most useful in mixed memory model applications.
Returns : The strnicmp and _fstrnicmp 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 : strcmp, stricmp, strncmp
Example :
#include <stdio.h>
#include <string.h>
void main( )
{
printf( "%d\n", strnicmp( "abcdef", "ABCXXX", 10 ) );
printf( "%d\n", strnicmp( "abcdef", "ABCXXX", 6 ) );
printf( "%d\n", strnicmp( "abcdef", "ABCXXX", 3 ) );
printf( "%d\n", strnicmp( "abcdef", "ABCXXX", 0) );
}
produces the following :
-20
-20
0
0
Classification : WATCOM
Systems : strnicmp - All
_fstrnicmp - All
strnset, _fstrnset
Synopsis : #include <string.h>
char *strnset( char *s1, int fill, size_t len );
char __far *_fstrnset( char -_far *s1, int fill, size_t len );
Description : The strnset and _fstrnset functions fill the string s1 with the value of the argument fill, converted to be a character value. When the value of len is greater than the length of the string, the entire string is filled. Otherwise, that number of characters at the start of the string are set to the fill character.
The _fstrnset function is a data model independent form of the strnset function. It accepts far pointer arguments and returns a far pointer. It is most useful in mixed memory model applications.
Returns : The address of the original string s1 is returned.
See Also : strset
Example :
#include <stdio.h>
#include <string.h>
char source[] = { "A sample STRING" };
void main( )
{
printf( "%s\n", source );
printf( "%s\n", strnset( source, '=' , 100 ) );
printf( "%s\n", strnset( source, '*', 7 ) );
}
produces the following :
A sample STRING
===============
*******========
Classification : WATCOM
Systems : strnset - All
_fstrnset - All
strpbrk, _fstrpbrk
Synopsis : #include <string.h>
char *strpbrk( const char *str, const char *charset );
char __far *_fstrpbrk( const char __far *str, const char __far *charset );
Description : The strpbrk and _fstrpbrk functions locate the first occurrence in the string pointed to by str of any character from the string pointed to by charset.
The _fstrpbrk function is a data model independent form of the strpbrk function. It accepts far pointer arguments and returns a far pointer. It is most useful in mixed memory model applications.
Returns : The strpbrk and _fstrpbrk functions return a pointer to the located character, or NULL if no character from charset occurs in str.
See Also : strchr, strrchr, strtok
Example :
#include <stdio.h>
#include <string.h>
void main( )
{
char *p = "Find all vowels";
while( p != NULL ) {
printf( "%s\n", p );
p = strpbrk( p+1, "aeiouAEIOU" );
}
}
produces the following :
Find all vowels
ind all vowels
all vowels
owels
els
Classification : strpbrk is ANSI, _fstrpbrk is not ANSI
Systems : strpbrk - All
_fstrpbrk - 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)
