/********************************************************************************************************************************/ /* Created: 15-MAR-2001 23:38:19 by OpenVMS SDL EV1-33 */ /* Source: 15-MAR-2001 23:34:46 _$11$DUA933:[BUILD.SDL]STR$ROUTINES.SDI;1 */ /********************************************************************************************************************************/ /*** MODULE str$routines ***/ #ifndef __STR$ROUTINES_LOADED #define __STR$ROUTINES_LOADED 1 #pragma nostandard #ifdef __cplusplus extern "C" { #define __unknown_params ... #else #define __unknown_params #endif #if !defined(__VAXC) && !defined(VAXC) #define __struct struct #define __union union #else #define __struct variant_struct #define __union variant_union #endif /**************************************************************************** */ /* * */ /* COPYRIGHT (c) 1988 BY * */ /* DIGITAL EQUIPMENT CORPORATION, MAYNARD, MASSACHUSETTS. * */ /* ALL RIGHTS RESERVED. * */ /* * */ /* THIS SOFTWARE IS FURNISHED UNDER A LICENSE AND MAY BE USED AND COPIED * */ /* ONLY IN ACCORDANCE WITH THE TERMS OF SUCH LICENSE AND WITH THE * */ /* INCLUSION OF THE ABOVE COPYRIGHT NOTICE. THIS SOFTWARE OR ANY OTHER * */ /* COPIES THEREOF MAY NOT BE PROVIDED OR OTHERWISE MADE AVAILABLE TO ANY * */ /* OTHER PERSON. NO TITLE TO AND OWNERSHIP OF THE SOFTWARE IS HEREBY * */ /* TRANSFERRED. * */ /* * */ /* THE INFORMATION IN THIS SOFTWARE IS SUBJECT TO CHANGE WITHOUT NOTICE * */ /* AND SHOULD NOT BE CONSTRUED AS A COMMITMENT BY DIGITAL EQUIPMENT * */ /* CORPORATION. * */ /* * */ /* DIGITAL ASSUMES NO RESPONSIBILITY FOR THE USE OR RELIABILITY OF ITS * */ /* SOFTWARE ON EQUIPMENT WHICH IS NOT SUPPLIED BY DIGITAL. * */ /* * */ /* * */ /**************************************************************************** */ /* STR$ADD */ /* */ /* Add Two Decimal Strings */ /* */ /* The Add Two Decimal Strings routine */ /* adds two decimal strings of digits. */ /* */ unsigned int str$add(__unknown_params); /* STR$ANALYZE_SDESC */ /* */ /* Analyze String Descriptor */ /* */ /* The Analyze String Descriptor routine extracts the */ /* length and starting address of the data */ /* for a variety of string descriptor classes. */ /* */ unsigned short int str$analyze_sdesc(__unknown_params); /* STR$APPEND */ /* */ /* Append String */ /* */ /* The Append String routine appends a source string to the end of a destination string. */ /* The destination string must be a dynamic or varying-length string. */ /* */ unsigned int str$append(__unknown_params); /* STR$CASE_BLIND_COMPARE */ /* */ /* Compare Strings Without Regard to Case */ /* */ /* The Compare Strings Without Regard to Case routine compares two input */ /* strings of any supported class */ /* and data type without regard to whether the alphabetic characters are uppercase */ /* or lowercase. */ /* */ int str$case_blind_compare(__unknown_params); /* STR$COMPARE */ /* */ /* Compare Two Strings */ /* */ /* The Compare Two Strings routine compares the */ /* contents of two strings. */ /* */ int str$compare(__unknown_params); /* STR$CONCAT */ /* */ /* Concatenate Two or More Strings */ /* */ /* The Concatenate Two or More Strings routine concatenates all specified */ /* source strings into a single destination string. */ /* */ unsigned int str$concat(__unknown_params); /* STR$COPY_DX */ /* */ /* Copy a Source String Passed by Descriptor to a Destination String */ /* */ /* The Copy a Source String Passed by Descriptor to */ /* a Destination String routine copies a source string to */ /* a destination string. Both strings are */ /* passed by descriptor. */ /* */ unsigned int str$copy_dx(__unknown_params); /* STR$COPY_R */ /* */ /* Copy a Source String Passed by Reference to a Destination String */ /* */ /* The Copy a Source String Passed by Reference to */ /* a Destination String routine copies a source string passed by reference to a destination */ /* string. */ /* */ unsigned int str$copy_r(__unknown_params); /* STR$DIVIDE */ /* */ /* Divide Two Decimal Strings */ /* */ /* The Divide Two Decimal Strings routine divides two decimal strings. */ /* */ unsigned int str$divide(__unknown_params); /* STR$DUPL_CHAR */ /* */ /* Duplicate Character Empty Times */ /* */ /* The Duplicate Character empty Times routine */ /* generates a string containing empty duplicates of the input */ /* character. If the destination string is an empty dynamic string descriptor, */ /* STR$DUPL_CHAR allocates and initializes the string. */ /* */ unsigned int str$dupl_char(__unknown_params); /* STR$ELEMENT */ /* */ /* Extract Delimited Element Substring */ /* */ /* The Extract Delimited Element Substring routine extracts an element */ /* from a string in which the elements are separated by a specified */ /* delimiter. */ /* */ unsigned int str$element(__unknown_params); /* STR$COMPARE_EQL */ /* */ /* Compare Two Strings for Equality */ /* */ /* The Compare Two Strings for Equality routine compares two */ /* strings to see if they have the same length */ /* and contents. Uppercase and lowercase characters are not considered equal. */ /* */ unsigned int str$compare_eql(__unknown_params); /* STR$FIND_FIRST_IN_SET */ /* */ /* Find First Character in a Set of Characters */ /* */ /* The Find First Character in a Set of */ /* Characters routine */ /* searches a string one character at a time, from */ /* left to right, comparing each character in the string to every character in */ /* a specified set of characters for which it is searching. */ /* */ int str$find_first_in_set(__unknown_params); /* STR$FIND_FIRST_NOT_IN_SET */ /* */ /* Find First That Does Not Occur in Set */ /* */ /* The Find First Character That Does Not */ /* Occur in Set routine */ /* searches a string, comparing each character to the */ /* characters in a specified set of characters. The string is searched character */ /* by character, from left to right. STR$FIND_FIRST_NOT_IN_SET returns the */ /* position of the first character in the string that does not match any of the */ /* characters in the selected set of characters. */ /* */ int str$find_first_not_in_set(__unknown_params); /* STR$FREE1_DX */ /* */ /* Free One Dynamic String */ /* */ /* The Free One Dynamic String routine */ /* deallocates one dynamic string. */ /* */ unsigned int str$free1_dx(__unknown_params); /* STR$FIND_FIRST_SUBSTRING */ /* */ /* Find First Substring in Input String */ /* */ /* The Find First Substring in Input String routine */ /* finds the first substring (in a provided list of */ /* substrings) occurring in a given string. */ /* */ unsigned int str$find_first_substring(__unknown_params); /* STR$GET1_DX */ /* */ /* Allocate One Dynamic String */ /* */ /* The Allocate One Dynamic String routine */ /* allocates a specified number of bytes of dynamic virtual memory */ /* to a specified dynamic string descriptor. */ /* */ unsigned int str$get1_dx(__unknown_params); /* STR$LEFT */ /* */ /* Extract a Substring of a String */ /* */ /* The Extract a Substring of a String routine copies a substring of a */ /* source string into a */ /* destination string. The relative starting position in the source */ /* string is 1. */ /* */ unsigned int str$left(__unknown_params); /* STR$LEN_EXTR */ /* */ /* Extract a Substring of a String */ /* */ /* The Extract a Substring of a String routine copies a */ /* substring of a source string into a */ /* destination string. */ /* */ unsigned int str$len_extr(__unknown_params); /* STR$MATCH_WILD */ /* */ /* Match Wildcard Specification */ /* */ /* The Match Wildcard Specification routine is used to compare a */ /* pattern string that includes wildcard */ /* characters with a candidate string. It returns a condition value of STR$_MATCH */ /* if the strings match and STR$_NOMATCH if they do not match. */ /* */ unsigned int str$match_wild(__unknown_params); /* STR$MUL */ /* */ /* Multiply Two Decimal Strings */ /* */ /* The Multiply Two Decimal Strings routine multiplies two decimal strings. */ /* */ unsigned int str$mul(__unknown_params); /* STR$COMPARE_MULTI */ /* */ /* Compare Two for Equality Using Multinational Character Set */ /* */ /* The Compare Two Strings for Equality Using */ /* Multinational Character Set routine compares two character */ /* strings for equality using the */ /* DEC Multinational Character Set. */ /* */ int str$compare_multi(__unknown_params); /* STR$POS_EXTR */ /* */ /* Extract a Substring of a String */ /* */ /* The Extract a Substring of a String routine */ /* copies a substring of a source string into a */ /* destination string. */ /* */ unsigned int str$pos_extr(__unknown_params); /* STR$POSITION */ /* */ /* Return Relative Position of Substring */ /* */ /* The Return Relative Position of Substring routine */ /* searches for the first occurrence of a */ /* single substring within a source string. If STR$POSITION finds the substring, */ /* it returns the relative position of that substring. */ /* If the substring is not found, STR$POSITION returns a zero. */ /* */ unsigned int str$position(__unknown_params); /* STR$PREFIX */ /* */ /* Prefix a String */ /* */ /* The Prefix a String routine */ /* inserts a source string at the beginning of a destination */ /* string. The destination string must be dynamic or varying length. */ /* */ unsigned int str$prefix(__unknown_params); /* STR$RECIP */ /* */ /* Reciprocal of a Decimal String */ /* */ /* The Reciprocal of a Decimal String routine */ /* takes the reciprocal of the first decimal string to the precision */ /* limit specified by the second decimal string and returns the result as a */ /* decimal string. */ /* */ unsigned int str$recip(__unknown_params); /* STR$REPLACE */ /* */ /* Replace a Substring */ /* */ /* The Replace a Substring routine */ /* copies a source string to a destination string, replacing part */ /* of the string with another string. The substring to be replaced is */ /* specified by its starting and ending positions. */ /* */ unsigned int str$replace(__unknown_params); /* STR$RIGHT */ /* */ /* Extract a Substring of a String */ /* */ /* The Extract a Substring of a String routine */ /* copies a substring of a source string into a */ /* destination string. */ /* */ unsigned int str$right(__unknown_params); /* STR$ROUND */ /* */ /* Round or Truncate a Decimal String */ /* */ /* The Round or Truncate a Decimal String routine */ /* rounds or truncates a decimal string to a specified number of */ /* significant digits and places the result in another decimal string. */ /* */ unsigned int str$round(__unknown_params); /* STR$TRANSLATE */ /* */ /* Translate Matched Characters */ /* */ /* The Translate Matched Characters routine successively compares each character in a source string */ /* to all characters in a match string. If a source character has a match, */ /* the destination character is taken from the translate string. Otherwise, */ /* STR$TRANSLATE moves the source character to the destination string. */ /* */ unsigned int str$translate(__unknown_params); /* STR$TRIM */ /* */ /* Trim Trailing Blanks and Tabs */ /* */ /* The Trim Trailing Blanks and Tabs routine */ /* copies a source string to a destination string and deletes the */ /* trailing blank and tab characters. */ /* */ unsigned int str$trim(__unknown_params); /* STR$UPCASE */ /* */ /* Convert String to All Uppercase Characters */ /* */ /* The Convert String to All Uppercase Characters routine */ /* converts a source string to uppercase. */ /* */ unsigned int str$upcase(__unknown_params); #ifdef __cplusplus } #endif #pragma standard #endif /* __STR$ROUTINES_LOADED */