Z88 Developers' Notes
Contents   Contents of System Calls

GN_Skc, skip character

RST 20H, DEFW $3209

IN:

     A = value to bypass
     HL = Sequense index:
          0 => read from stream IX
          1 => read from filter IX
          2 = not allowed
          > 255 = read at (HL)
     IX = optional handle
OUT, if call succeeded:
     HL(in) > 255: (HL) points to character which stopped scanning, else
     HL(in).
OUT, if call failed:
     Fc = 1
          Error code ???
Notes:

Bugs:

It is reported to be useless due to too many bugs. If (HL) < A then the error handler is called with A = (HL) OOPS!!! hence the routine bombs out when a character < A is passed to it in (HL). From stream IX it is even worse. It skips over the character correctly but (IX) < A or (IX) > A cause an error (always RC_QUIT!!!).
Related calls:
GN_Cls, classify character
GN_Skd, skip delimiter
GN_Skt, skip to value