VMS Help  —  RTL Routines, STR$  STR$DIVIDE
    The Divide Two Decimal Strings routine divides two decimal
    strings.

    Format

      STR$DIVIDE  asign ,aexp ,adigits ,bsign ,bexp ,bdigits

                  ,total-digits ,round-truncate-indicator ,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 the sign of the first operand.
    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
    the first operand's exponent.

 adigits

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

    First operand's numeric text string. The adigits argument is the
    address of a descriptor pointing to the first operand's numeric
    string. The 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 string.
    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
    the second operand's exponent.

 bdigits

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

    Second operand's numeric text string. The bdigits argument is the
    address of a descriptor pointing to the second operand's number
    string. The string must be an unsigned decimal number.

 total-digits

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

    Number of digits to the right of the decimal point. The total-
    digits argument is the address of a signed longword containing
    the number of total digits. STR$DIVIDE uses this number to carry
    out the division.

 round-truncate-indicator

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

    Indicator of whether STR$DIVIDE is to round or truncate the
    result; a value of 0 means truncate; a value of 1 means round.
    The round-truncate-indicator argument is the address of a
    longword bit mask containing this indicator.

 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 sign of the result. 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 the exponent.

 cdigits

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

    Result's numeric text string. The cdigits argument is the address
    of a descriptor pointing to the numeric string of the result.
    This string is an unsigned decimal number.
Close Help