You are viewing the version of this documentation from Perl blead. This is the main development branch of Perl. (git commit 815d0d1337a0f328fa38b1a08c31a0c1a8253a1b)

Creates a new filename symbolically linked to the old filename. Returns 1 for success, 0 otherwise. On systems that don't support symbolic links, raises an exception. To check for that, use eval:

my $symlink_exists = eval { symlink("",""); 1 };

Portability issues: "symlink" in perlport.