It seems to me all your questions are answered by the very documentation
you referenced.
>> Does *@dirs mean I can give it multiple directories as an array?
Remove the invocant .... in sub form .... of the provided directories in
the given list .....
Example:
-------------------------
# mkdir {a,b} ; ls -ld a b ; `which perl6` -e "rmdir('a','b')" ; ls -ld a b
drwxr-xr-x 2 root wheel 2 Dec 2 22:22 a
drwxr-xr-x 2 root wheel 2 Dec 2 22:22 b
ls: a: No such file or directory
ls: b: No such file or directory
>> What does "--> List:D" give me back?
It gives you back a list of directories that it successfully removed.
Example:
--------------------------------
# mkdir a ; ls -ld a b ; `which perl6` -e "rmdir('a','b').perl.say"
ls: b: No such file or directory
drwxr-xr-x 2 root wheel 2 Dec 2 22:23 a
["a"]
# mkdir {a,b} ; ls -ld a b ; `which perl6` -e "rmdir('a','b').perl.say"
drwxr-xr-x 2 root wheel 2 Dec 2 22:23 a
drwxr-xr-x 2 root wheel 2 Dec 2 22:23 b
["a", "b"]
>> And what is a "List:D?" anyway?
https://docs.perl6.org/type/Signature#Constraining_argument_definiteness
The above link explains it fully. Though it uses "Int:D" as an example it
still applies.
>> ...throws an exception of type X::IO::Rmdir if
>> the directory cannot be removed
>>
>> Does this crash the program or just return a "false"?
On success it return a Bool::True.
On failure it throws an exception.
It doesn't crash the program.
If you are interested in handling the exception, add logic to handle it.
Examples:
---------------------------
# mkdir a ; `which perl6` -e "'a'.IO.rmdir.perl.say"
Bool::True
# mkdir a ; `which perl6` -e "'b'.IO.rmdir.perl.say"
Failure.new(exception => X::IO::Rmdir.new(path => "/root/test/b", os-error
=> "Failed to rmdir: no such file or directory"), backtrace =>
Backtrace.new)
# mkdir a ; `which perl6` -e "try { 'b'.IO.rmdir.perl.say; CATCH { default
{ 'tsk tsk'.say }}}"
tsk tsk
>> Does it tell me what went wrong, as in "so and so" has "such and such"
file(s) open and locked?
See previous example. It throws an exception with a detailed error message.
>> To delete non-empty directory, see rmtree in File::Directory::Tree
module.
>>
>> Seems to me I should not have to import a module for
>> this. Most rmdir command have a "parents" flag. Am
>> I missing something?
It's true that most binaries with the name rmdir have a p switch for
removing "empty directories" which I won't argue could be added to perl6
proper.
That documentation you are referencing though is concerning "non-empty
directories" and there no such flag for any rmdir binary I've seen.
~Paul
On Mon, Dec 2, 2019 at 9:39 PM ToddAndMargo via perl6-users <
perl6-us...@perl.org> wrote:
> Hi All,
>
> From the manual page of rmdir:
> https://docs.perl6.org/routine/rmdir
>
> sub rmdir(*@dirs --> List:D)
> method rmdir(IO::Path:D: --> True)
>
> Does *@dirs mean I can give it multiple directories
> as an array?
>
> What does "--> List:D" give me back? An array
> of Booleans as to which directories successfully removed?
> And what is a "List:D?" anyway?
>
>
> ...throws an exception of type X::IO::Rmdir if
> the directory cannot be removed
>
> Does this crash the program or just return a "false"?
> Does it tell me what went wrong, as in "so and so" has
> "such and such" file(s) open and locked?
>
> To delete non-empty directory, see rmtree in File::Directory::Tree module.
>
> Seems to me I should not have to import a module for
> this. Most rmdir command have a "parents" flag. Am
> I missing something?
>
> Many thanks,
> -T
>
>
>
> --
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
> A computer without Microsoft is like
> a chocolate cake without the mustard
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
--
__________________
:(){ :|:& };:
