The following routines overlap in function with ones found in other Starlink packages, but are included in the HLP package for independence.
LOGICAL FUNCTION HLP_COMSTR(FULSTR,STR)
HLP_COMSTR compares two keywords for agreement, under the HLP package's rules for abbreviation (see Section 2). FULSTR is the full keyword read from the HLP library; STR is the abbreviated string, including wildcards etc, supplied by the user. A .TRUE. response is returned if the two strings match.
SUBROUTINE HLP_DEC(STRING,IPTR,NUM)
HLP_DEC decodes a decimal integer NUM from a string STRING, starting at position IPTR. The pointer IPTR is incremented ready for the next call.
INTEGER FUNCTION HLP_LENGTH(STRING)
The HLP_LENGTH function returns the length of a string STRING excluding any trailing spaces. An all-blank string is length 1. The routine is optimized for speed in the case where the string is mostly trailing spaces.
SUBROUTINE HLP_SPLIT(STRING,ISTART,IFROM,ITO)
HLP_SPLIT splits up a sentence into words. STRING consists of words separated by spaces. Starting at character position ISTART, this routine locates the beginning and end of the next word IFROM and ITO.
SUBROUTINE HLP_UPCASE(STRING)
HLP_UPCASE converts a string STRING to uppercase, in place.