HP OpenVMS Systems Documentation
OpenVMS RTL String Manipulation (STR$) Manual
Order Number: AA--PV6MD--TK
This manual documents the string manipulation routines contained in the STR$ facility of the OpenVMS Run-Time Library.
Revision/Update Information: This manual supersedes the OpenVMS RTL String Manipulation (STR$) Manual, OpenVMS Alpha Version 7.1 and OpenVMS VAX Version 7.1.
Software Version: OpenVMS Alpha Version 7.3 OpenVMS VAX Version 7.3
Compaq Computer Corporation
© 2001 Compaq Computer Corporation
Compaq, VAX, VMS, and the Compaq logo Registered in U.S. Patent and Trademark Office.
OpenVMS is a trademark of Compaq Information Technologies Group, L.P. in the United States and other countries.
All other product names mentioned herein may be trademarks of their respective companies.
Confidential computer software. Valid license from Compaq required for possession, use, or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license.
Compaq shall not be liable for technical or editorial errors or omissions contained herein. The information in this document is provided "as is" without warranty of any kind and is subject to change without notice. The warranties for Compaq products are set forth in the express limited warranty statements accompanying such products. Nothing herein should be construed as constituting an additional warranty.
The Compaq OpenVMS documentation set is available on CD-ROM.
This manual provides users of the OpenVMS operating system with detailed usage and reference information about the string manipulation routines supplied in the STR$ facility of the Run-Time Library.
This manual is intended for system and application programmers who write programs that call STR$ Run-Time Library routines.
This manual is organized into two parts as follows:
The Run-Time Library routines are documented in a series of reference manuals. A description of how the Run-Time Library routines are accessed and of the OpenVMS features and functionality available through calls to the STR$ Run-Time Library appear in the OpenVMS Programming Concepts Manual. Descriptions of other RTL facilities and their corresponding routines and usages are discussed in the following books:
The Guide to the POSIX Threads Library contains guidelines and reference information for Compaq POSIX Threads2, the Compaq Multithreading Run-Time Library.
The OpenVMS Calling Standard contains useful information for anyone who needs to call Run-Time Library routines.
Application programmers using any programming language can refer to the Guide to Creating OpenVMS Modular Procedures for writing modular and reentrant code.
High-level language programmers will find additional information on calling Run-Time Library routines in their language reference manual. Additional information may also be found in the language user's guide provided with your OpenVMS language software.
For a complete list and description of the manuals in the OpenVMS documentation set, see the OpenVMS Version 7.3 New Features and Documentation Overview.
For additional information about Compaq OpenVMS products and services, access the Compaq website at the following location:
Compaq welcomes your comments on this manual. Please send comments to either of the following addresses:
How To Order Additional Documentation
Use the following World Wide Web address to order additional documentation:
If you need help deciding which documentation best meets your needs, call 800-282-6672.
The following conventions are used in this manual:
This part of the OpenVMS RTL String Manipulation (STR$) Manual contains a tutorial for the OpenVMS RTL
String Manipulation (STR$) facility.
|STR$ADD||Add two decimal strings|
|STR$DIVIDE||Divide two decimal strings|
|STR$MUL||Multiply two decimal strings|
|STR$RECIP||Return the reciprocal of a decimal string|
|STR$ROUND||Round or truncate a decimal string|
|STR$CASE_BLIND_COMPARE||Compare strings without regard to case|
|STR$COMPARE||Compare two strings|
|STR$COMPARE_EQL||Compare two strings for equality|
|STR$COMPARE_MULTI||Compare two strings for equality using the DEC Multinational Character Set|
|STR$ELEMENT||Extract delimited element substring|
|STR$LEFT||Extract a substring of a string|
|STR$LEN_EXTR||Extract a substring of a string|
|STR$POS_EXTR||Extract a substring of a string|
|STR$REPLACE||Replace a substring|
|STR$RIGHT||Extract a substring of a string|
|STR$APPEND||Append a string|
|STR$CONCAT||Concatenate two or more strings|
|STR$PREFIX||Prefix a string|
|STR$COPY_DX||Copy a source string passed by descriptor to a destination string|
|STR$COPY_R||Copy a source string passed by reference to a destination string|
|++STR$COPY_R_64||Copy a source string passed by reference to a destination string|
|STR$FIND_FIRST_IN_SET||Find the first character in a set of characters|
|STR$FIND_FIRST_NOT_IN_SET||Find the first character that does not occur in the set|
|STR$FIND_FIRST_SUBSTRING||Find the first substring in the input string|
|STR$FREE1_DX||Free one dynamic string|
|STR$GET1_DX||Allocate one dynamic string|
|++STR$GET1_DX_64||Allocate one dynamic string|
|STR$ANALYZE_SDESC||Analyze a string descriptor|
|++STR$ANALYZE_SDESC_64||Analyze a string descriptor|
|STR$DUPL_CHAR||Duplicate character n times|
|STR$MATCH_WILD||Match a wildcard specification|
|STR$POSITION||Return relative position of a substring|
|STR$TRANSLATE||Translate matched characters|
|STR$TRIM||Trim trailing blanks and tabs|
|STR$UPCASE||Convert string to all uppercase|
On Alpha systems, the String Manipulation (STR$) routines provide 64-bit virtual addressing capabilities as follows: