<-- Previous || Up || Next -->

Add String Characters Function
String Numerics Class

Public Function AddStringCharacters( _
      ByVal vStringOne As Variant _
    , ByVal vStringTwo As Variant _
    , Optional ByVal vTruncate As Variant _
    ) As Variant

Adds the ASCII values of corresponding characters from two strings.

Examples:
    AddStringCharacters("AB", "CD") = Chr$(132) + Chr$(134)
    AddStringCharacters(Chr$(200) + Chr$(205), Chr$(150) + Chr$(175)) = Chr$(94) + Chr$(125) + Chr$(1)
See also:
    AverageStrings Function
vStringOne: First of two strings whose corresponding characters will be added together. Function returns Null if vStringOne is Null or cannot be fixed up to a String.

vStringTwo: Second of two strings whose corresponding characters will be added together. Function returns Null if vStringTwo is Null or cannot be fixed up to a String.

vTruncate: Determine what to do if the addition of the last corresponding characters results in an overflow condition. If True, an overflow will result in the addition of another character onto the end of the result string. If False, the overflow condition will be ignored. vTruncate defaults to False (the overflow will be carried to the next character) if it is missing or Null or cannot be fixed up to a number.

Note: This function assumes that the first string character represents the least-significant-byte within the string (unlike the usual interpretation of string values in which the first character represents the most-significant-byte).

Copyright 1996-1999 Entisoft
Entisoft Tools is a trademark of Entisoft.