Mikroelektronika MIKROE-350 データシート

493

- SOFTWARE AND HARDWARE SOLUTIONS FOR EMBEDDED WORLD

CHAPTER 6

sub function strncmp(dim byref s1, s2 as string[100], dim len as
byte) as short

The function lexicographically compares the first 

len

words of the strings 

s1

and

s2

and returns a value indicating their relationship:

< 0       s1 "less than" s2

= 0       s1 "equal to" s2

> 0       s1 "greater than" s2

The value returned by the function is determined by the difference between the
values of the first pair of words that differ in the strings being compared (within
first 

len

words).

sub procedure strncpy(dim byref s1, s2 as string[100], dim size
as word)

The function copies at most 

size

characters from the string 

s2

to the string 

s1

.

If 

s2

contains fewer characters than 

size

, 

s1

is padded out with null characters

up to the total length of the 

size

characters.

sub function strpbrk(dim byref s1, s2 as string[100]) as word

The function searches 

s1

for the first occurrence of any character from the

string 

s2.

The null terminator is not included in the search. The function returns

an index of the matching character in 

s1

. If 

s1

contains no characters from 

s2

,

the function returns 

0xFFFF

.

sub function strrchr(dim byref s as string[100], dim ch as byte)
as word

The function searches the string 

s

for the last occurrence of the character 

ch

.

The null character terminating 

s

is not included in the search. The function

returns an index of the last 

ch

found in 

s

; if no matching character was found,

the function returns 

0xFFFF

.