Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

                                             ◄Up► ◄Contents► ◄Index► ◄Back►
────────────────────────────────────────────────────────────────────────────
 
  Include:   DOS.INC
 
  Syntax:    @GetStr buffer [,[terminator] [,[limit] [,segment]]]
 
  Summary:   Gets a string from the keyboard
 
  Arguments: <buffer>         Offset of buffer for string. Must be an
                              offset address.
 
                              Byte 1    Maximum length of string before
                                        call.
                              Byte 2    Actual length of string after
                                        call.
                              Byte 3+   Bytes of string.
 
             <terminator>     Terminating byte: null (0) or $ (24h).
                              May be a constant or register, but not memory.
 
             <limit>          Maximum length of string. Must be a
                              constant. If not given as an argument,
                              must be in buffer before call.
 
             <segment>        Segment of buffer; DS if not given.
 
  Returns:   Pointer to string in SI, length of string in BX
 
  Modifies:  AX, DX, BX, SI
 
  See also:  Int 21h, Function 0Ah, @GetChar
                                    -♦-