GN_Fcm, Compress a filename

Register parameters

RST 20H, DEFW $4E09

 IN:
     BHL = source pointer
     HL = 0, not allowed
     HL = 1, not allowed
     HL = 2, not allowed
     String should be terminated by a control character
     (HL > 255, B = 0 means local pointer)

     DE = destination (local) pointer
          0: result to stream IX handle
          1: result to filter IX handle
          > 255: place string at (DE)
     C = limit of space to use

OUT, if call successful:
     Fc = 0
     DE = points to the character after the last one written
     (if DE(in) > 255)

     B = number of filename segments returned
     C = number of characters in compressed space

OUT, if call failed:
     Fc = 1
     A = error code:
          RC_BAD ($04), bad parameters, fatal error

Registers changed after return:
     ......HL/IXIY same
     AFBCDE../.... different

Notes

If the filename cannot be reproduced in the space available, ie. C(in), then on exit C =1, B = 0 and the expansion buffer (stream or filter) will be given a NULL. Setting C(in) = 18 will guarantee the return of a filename and extension.

Bugs

If the source is in segment 2 then problems may occur.

Related calls

GN_Esa, read & write to filename segments
GN_Fex, expand a filename
GN_Opw, Open wildcard handler
GN_Pfs, parse filename segment
GN_Prs, parse filename
GN_Wcl, close wildcard handle
GN_Wfn, fetch next match for wildcard string (handle)
GN_Wsm, match filename segment to wildcard string