HELPLIB.HLB  —  RTL Routines, STR$  STR$GET1_DX
    The Allocate One Dynamic String routine allocates a specified
    number of bytes of virtual memory to a specified dynamic string
    descriptor.

    Format

      STR$GET1_DX  word-integer-length ,character-string

1  –  Corresponding JSB Entry Point

      STR$GET1_DX_R4

2  –  Returns

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

3  –  Arguments

 word-integer-length

    OpenVMS usage:word_unsigned
    type:         word (unsigned)
    access:       read only
    mechanism:    by reference

    Number of bytes that STR$GET1_DX allocates. The word-integer-
    length argument is the address of an unsigned word containing
    this number.

 character-string

    OpenVMS usage:char_string
    type:         character string
    access:       modify
    mechanism:    by descriptor

    Dynamic string descriptor to which STR$GET1_DX allocates the
    area. The character-string argument is the address of the
    descriptor. The descriptor's CLASS field is checked.
Close Help