ARSperl Programmer's Manual - ars_CreateContainer

## `ars_CreateContainer(ctrl, containerHash, removeFlag=TRUE)`

This function creates a new container. You must first populate the `containerHash` before calling this routine.

`containerHash` is a Container Attributes hash.

On success
  Returns 1
On failure
  Returns 0

Example:

> This example copies an existing container to a new container. I.e. it simply re-saves the active link under a new name.

          ($ct = ars_GetContainer($c, "C-foobar")) ||
    	    die $ars_errstr;
          $ct->{name} = "Copy of ".$ct->{name};
          ars_CreateContainer($c, $ct) || die $ars_errstr;

Notes: Hash keys `helpText, owner` and `changeDiary` are optional when calling this routine.

This function was introduced in version 1.90 of ARSperl

Back to Table of Contents