CFURLMBS.AbsoluteURL as CFURLMBS

A URL contains normally a base and a relative part. This function creates one absolute URL from those parts.

CFURLMBS.AppendPathComponent(pathcomponent as CFStringMBS,isDirectory as boolean) as CFURLMBS

CFURLMBS.AppendPathExtension(extension as CFStringMBS) as CFURLMBS

CFURLMBS.BaseURL as CFURLMBS

A URL contains normally a base and a relative part.

CFURLMBS.CanBeDecomposed as boolean

CFURLMBS.Constructor(File as FolderItem)

Raises exception if not called on macOS or called with invalid URL.

See also:

• Constructor(URL as string)

CFURLMBS.Constructor(URL as string)

Raises exception if not called on macOS or called with invalid URL.

See also:

• Constructor(File as FolderItem)

CFURLMBS.Data(encoding as Integer, escapeWhitespace as boolean) as CFBinaryDataMBS

CFURLMBS.DeleteLastPathComponent as CFURLMBS

CFURLMBS.DeletePathExtension as CFURLMBS

CFURLMBS.DisplayName as CFStringMBS

Returns "" on any error.

CFURLMBS.file as folderitem

Works only on RB 4.5 or later and if the file exists.

CFURLMBS.Fragment(charactersToLeaveEscaped as CFStringMBS) as CFStringMBS

CFURLMBS.HasDirectoryPath as boolean

CFURLMBS.HFSFileSystemPath as CFStringMBS

CFURLMBS.HostName as CFStringMBS

CFURLMBS.isAbsolutePath as boolean

CFURLMBS.Kind as CFStringMBS

CFURLMBS.LastPathComponent as CFStringMBS

CFURLMBS.Launch as Integer

Returns a Mac OS error string or -1 if the function is not available.

CFURLMBS.NetLocation as CFStringMBS

CFURLMBS.ParameterString(charactersToLeaveEscaped as CFStringMBS) as CFStringMBS

CFURLMBS.Password as CFStringMBS

CFURLMBS.Path as CFStringMBS

See also:

• Path(resolveAgainstBase as boolean) as string

CFURLMBS.Path(resolveAgainstBase as boolean) as string

See also:

• Path as CFStringMBS

CFURLMBS.PathExtension as CFStringMBS

CFURLMBS.PortNumber as Integer

Returns -1 if no port specified and -2 on Windows and Mac OS Classic.

CFURLMBS.PosixFileSystemPath as CFStringMBS

Some examples using this method:

• /MacCF/CFBundle example

CFURLMBS.QueryString(charactersToLeaveEscaped as CFStringMBS) as CFStringMBS

CFURLMBS.ResourcePropertyForKey(key as CFStringMBS, byref value as Variant, byref error as CFErrorMBS) as boolean

dim f as FolderItem = SpecialFolder.Desktop.Child("test")
dim c as CFURLMBS = NewCFURLMBSFile(f)

dim v as Variant
dim e as CFErrorMBS

if c.ResourcePropertyForKey(c.kCFURLIsPackageKey, v1, e) then
  dim p as CFBooleanMBS = v
  
  MsgBox "IsPackage: "+str(p.Value)
else
  MsgBox "Error: "+e.Description
end if

key: The resource key that identifies the resource property.
Value: On output when the result is true, the resource value or nil.
error: On output when the result is false, the error that occurred.

Returns true if value is successfully populated; false if an error occurs.

ResourcePropertyForKey first checks if the URL object already caches the resource value. If so, it returns the cached resource value to the caller. If not, then ResourcePropertyForKey synchronously obtains the resource value from the backing store, adds the resource value to the URL object's cache, and returns the resource value to the caller. The type of the resource value varies by resource property (see resource key definitions). If this function returns true and v alue is populated with nil, it means the resource property is not available for the specified resource and no errors occurred when determining the resource property was not available. If this function returns false, the optional error is populated. This function is currently applicable only to URLs for file system resources.

CFURLMBS.ResourceSpecifier as CFStringMBS

CFURLMBS.Scheme as CFStringMBS

CFURLMBS.SetResourcePropertyForKey(key as CFStringMBS, value as Variant, byref error as CFErrorMBS) as boolean

Dim f As FolderItem = SpecialFolder.Desktop.Child("test")
Dim c As CFURLMBS = NewCFURLMBSFile(f)

Dim e As CFErrorMBS

If c.SetResourcePropertyForKey(c.kCFURLIsPackageKey, NewCFBooleanMBS(true), e) Then
  MsgBox "OK"
Else
  MsgBox "Error: "+e.Description
End If

key: The resource key that identifies the resource property.
Value: The resource value.
error: On output when the result is false, the error that occurred.

Returns true if the attempt to set the resource value completed with no errors; otherwise, false.

CFURLSetResourcePropertyForKey writes the new resource value out to the backing store. Attempts to set a read-only resource property or to set a resource property not supported by the resource are ignored and are not considered errors. If this function returns false, the optional error is populated. This function is currently applicable only to URLs for file system resources.

CFURLMBS.Str as CFStringMBS

CFURLMBS.StrictPath as CFStringMBS

CFURLMBS.UserName as CFStringMBS

CFURLMBS.WindowsFileSystemPath as CFStringMBS