hs_container::extract_ds

Source: master/hs_container__extract_ds.pro

 hs_container::extract_ds
        Extract a dataset from an hs_container object.

 Usage:
        dsref = hsref -> extract_ds([group=group, menu=menu])

 Keywords:
        group   long    input   The widget ID of a group leader.
        menu            input   If set, then create a widget menu,
                                otherwise it will be done in the
                                terminal.


 Notes:
        This routine is only intended to be used on a container which
        was restored via the restore_ds method of the top-level
        container. It should NEVER be applied to the top level
        container itself (use the get_ds_info method directly for
        that), this method deliberately destroys the dataset reference
        in the container so that the container can be destroyed on
        return with out destroying the dataset.

 History:
        Original: 21/3/01; SJT
        Allow return of all datasets: 11/5/01; SJT