F Changes and New Features in Version 2.0

 F.1 Obsolete routines
 F.2 Changes in behaviour of existing routines
 F.3 New routines
 F.4 Other changes

F.1 Obsolete routines

Several routines exist in CHR purely for historical reasons. These routines are obsolete and are only provided by the CHR library because existing Starlink code may depend upon them. They should not be used in any new software.

CHR_EQUAL
– Return whether two strings are equal.
CHR_INDEX
– Return the index of a substring within a string.
CHR_MOVE
– Move one string into another.
CHR_SIZE
– Return the declared length of a string.

F.2 Changes in behaviour of existing routines

CHR_DTOC
– The former algorithm has been replaced – this may result in the returned string being different from that returned from the previous version.
CHR_RTOC
– The former algorithm has been replaced – this may result in the returned string being different from that returned from the previous version.

F.3 New routines

CHR_ABBRV
– Return whether two strings are equal apart from case, permitting abbreviation.
CHR_ACHR
– Return the character for a given ASCII value.
CHR_ATOK
– Return the character for a given ASCII character token.
CHR_ATOM
– Translate a string from ASCII to machine’s characters set.
CHR_BTOI
– Read an INTEGER value from a binary string.
CHR_DTOAN
– Write a DOUBLE PRECISION value into a string as hr/deg:min:sec.
CHR_FIND
– Find the next occurrence of a given substring within a string.
CHR_IACHR
– Return the ASCII value for a given character.
CHR_ITOB
– Encode an INTEGER value as a binary string.
CHR_ITOH
– Encode an INTEGER value as a hexadecimal string.
CHR_ITOO
– Encode an INTEGER value as an octal string.
CHR_LINBR
– Break a line of text into a sequence of shorter lines.
CHR_MTOA
– Translate a string from machine’s characters set to ASCII.
CHR_NTH
– Return the two-character abbreviation for a specified integer.
CHR_PFORM
– Reformat a paragraph to a new width.
CHR_PREFX
– Prefix a string with a substring.
CHR_RJUST
– Right-justify a string.
CHR_RMCHR
– Remove all specified characters from a string.
CHR_SCOMP
– Compare two character strings using the ASCII character set.
CHR_SKCHR
– Skip over all specified characters in a string.
CHR_SORT
– Sort an array of character strings into alphabetical order.
CHR_TOCHR
– Skip to the next specified character in a string.
CHR_TRCHR
– Translate the specified characters in a string.
CHR_WILD
– Return whether a string matches a wild-card pattern.

F.4 Other changes

CHR_DIR:LOGICAL.COM
This file has been renamed CHR_DIR:CHR_DEV.COM.
CHR_DIR:CHRLINK.OPT
This file has been renamed CHR_DIR:CHR_LINK.OPT.