CMPC - EIS string compare.

Alternate Entry Name: .CMPC

Usage:

B:
   diff = cmpc( string1, pos1, string2, pos2, length
          [, length2, fill, type ] );

C:
   int cmpc(const char *string1, int pos1,
            const char *string2, int pos2,
            [ int length, int length2, int fill,
              int type] );

Where:

string1

is a pointer to a string.

pos1

is a character offset into "string1".

string2

is a pointer to another string.

pos2

is a character offset into "string2".

length

is the number of characters to be compared.

length2

is the number of characters in "string2" to be compared against "length" characters from "string1", the shorter string being padded out with the character in "fill". If "length2" is not specified, the default value is "length".

fill

is a single character with which the shorter string is to be padded. If "fill" is not specified, the shorter string will be padded with blanks.

type

is one of 4, 6, or 9, indicating how many bits per character there are in the two strings. The default is nine bits per character, signifying ASCII characters.

Description:

CMPC uses the EIS "cmpc" instruction to compare the given strings. CMPC returns a zero if the two strings are the same, a -1 if string1<string2, and a +1 if string1>string2.

Note:

The functions EQUAL and COMPARE should be used whenever possible.

See Also:

expl b lib compare

expl b lib equal

Copyright © 1996, Thinkage Ltd.