HPlogo MPE/iX Intrinsics Reference Manual > Chapter 9 Command Definitions (MAIL-PUTJCW)

NLMATCH

MPE documents

Complete PDF
Table of Contents
Index

Edition 7 E0701 ♥
Edition 7 E0300
Edition 6 E0195

Compares a string against a pattern which has previously been compiled with the NLMATCHINIT intrinsic.

Syntax



  I                  BA            BA      IV
  result := NLMATCH (comp_pattern, string, length);

Functional Return


Zero is returned in result if the string matches the compiled comp_pattern. If there is no match, the mismatch location is returned.

result Meaning
1NLS is not installed
2The specified language is not configured
100+nn is the mismatch location

Parameters


comp_pattern

Byte array (required)

A byte array containing the compiled form of a comp_pattern as returned by NLMATCHINIT.

A pattern consists of a series of special characters that indicate the type of data to be selected. These characters are:

string

Byte array (required)

The string to be compared against the comp_pattern.

length

Integer by value (required)

Length, in bytes, of the string to be compared.

Related Information


Intrinsics NLMATCHINIT
Manuals Native Language Programmer's Guide




NLKEYCOMPARE


NLMATCHINIT