Modern Fs ReadLink

Home › Filesystem › Filesystem Library › ReadLink

ReadLink

Returns the target a symbolic link points to, as stored; fails if it is not a link.

Syntax

ReadLink( lnk )

Notes

• FsResultUStr

Examples

#import "std/fs"
using fs

dim td as FsResultUStr = CreateTempDir( "fbdoc" )
dim as ustring dir_ = td.Value( )
dim as ustring p = PathJoin( dir_, "f.txt" )
WriteAllText( p, "hello" )

'' The target a symlink points at, WITHOUT following it or checking
'' that it exists -- a dangling link still reads
dim as ustring lnk = PathJoin( dir_, "link.txt" )

if CreateSymlink( p, lnk ).IsOk( ) then
    print ReadLink( lnk ).Value( ) = p       '' -1 (true)
end if

'' On something that is not a link it FAILS rather than answering with
'' the path itself
dim r as FsResultUStr = ReadLink( p )
print r.IsOk( )              '' false

RemoveDirAll( dir_ )

---

Library: Filesystem Library
Category: Filesystem
Documented under: Links And Permissions