VMS Help  —  RTL Routines, STR$  STR$ADD
    The Add Two Decimal Strings routine adds two decimal strings of
    digits.

    Format

      STR$ADD  asign ,aexp ,adigits ,bsign ,bexp ,bdigits ,csign

               ,cexp ,cdigits

1  –  Returns

    OpenVMS usage:cond_value
    type:         longword (unsigned)
    access:       write only
    mechanism:    by value

2  –  Arguments

 asign

    OpenVMS usage:longword_unsigned
    type:         longword (unsigned)
    access:       read only
    mechanism:    by reference

    Sign of the first operand. The asign argument is the address
    of an unsigned longword containing this sign. A value of 0 is
    considered positive; a value of 1 is considered negative.

 aexp

    OpenVMS usage:longword_signed
    type:         longword (signed)
    access:       read only
    mechanism:    by reference

    Power of 10 by which adigits is multiplied to get the absolute
    value of the first operand. The aexp argument is the address of a
    signed longword containing this exponent.

 adigits

    OpenVMS usage:char_string
    type:         character string
    access:       read only
    mechanism:    by descriptor

    Text string of unsigned digits representing the absolute value of
    the first operand before aexp is applied. The adigits argument is
    the address of a descriptor pointing to this string. This string
    must be an unsigned decimal number.

 bsign

    OpenVMS usage:longword_unsigned
    type:         longword (unsigned)
    access:       read only
    mechanism:    by reference

    Sign of the second operand. The bsign argument is the address
    of an unsigned longword containing the second operand's sign.
    A value of 0 is considered positive; a value of 1 is considered
    negative.

 bexp

    OpenVMS usage:longword_signed
    type:         longword (signed)
    access:       read only
    mechanism:    by reference

    Power of 10 by which bdigits is multiplied to get the absolute
    value of the second operand. The bexp argument is the address of
    a signed longword containing the second operand's exponent.

 bdigits

    OpenVMS usage:char_string
    type:         character string
    access:       read only
    mechanism:    by descriptor

    Text string of unsigned digits representing the absolute value of
    the second operand before bexp is applied. The bdigits argument
    is the address of a descriptor pointing to this string. This
    string must be an unsigned decimal number.

 csign

    OpenVMS usage:longword_unsigned
    type:         longword (unsigned)
    access:       write only
    mechanism:    by reference

    Sign of the result. The csign argument is the address of an
    unsigned longword containing the result's sign. A value of 0
    is considered positive; a value of 1 is considered negative.

 cexp

    OpenVMS usage:longword_signed
    type:         longword (signed)
    access:       write only
    mechanism:    by reference

    Power of 10 by which cdigits is multiplied to get the absolute
    value of the result. The cexp argument is the address of a signed
    longword containing this exponent.

 cdigits

    OpenVMS usage:char_string
    type:         character string
    access:       write only
    mechanism:    by descriptor

    Text string of unsigned digits representing the absolute value
    of the result before cexp is applied. The cdigits argument is the
    address of a descriptor pointing to this string. This string is
    an unsigned decimal number.
Close Help