Platforms to show: All Mac Windows Linux Cross-Platform

Back to NSURLMBS class.

Previous items

NSURLMBS.NSURLVolumeIsLocalKey as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method Cocoa Networking MBS MacBase Plugin 15.2 ✅ Yes ❌ No ❌ No ✅ Yes All
One of the property keys for volumes.
Example
dim f as FolderItem = GetFolderItem("/Volumes/Ablage1", FolderItem.PathTypeNative)

dim n as NSURLMBS = NSURLMBS.URLWithItem(f)
dim value as Variant
dim error as NSErrorMBS

dim Local as Boolean

// network volumes are not local
if n.getResourceValue(value, n.NSURLVolumeIsLocalKey, error) then
MsgBox "Local: "+value.StringValue
Local = value.BooleanValue
else
MsgBox error.LocalizedDescription
end if

// network volumes have an URL
if n.getResourceValue(value, n.NSURLVolumeURLForRemountingKey, error) then
MsgBox "URLForRemounting: "+value.StringValue
else
MsgBox error.LocalizedDescription
end if

Key for determining whether the volume is stored on a local device, returned as a Boolean (read-only).
Available in OS X v10.7 and later.

Some examples using this method:

NSURLMBS.NSURLVolumeIsReadOnlyKey as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method Cocoa Networking MBS MacBase Plugin 15.2 ✅ Yes ❌ No ❌ No ✅ Yes All
One of the property keys for volumes.

Key for determining whether the volume is read-only, returned as a Boolean (read-only).
Available in OS X v10.7 and later.

Some examples using this method:

NSURLMBS.NSURLVolumeIsRemovableKey as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method Cocoa Networking MBS MacBase Plugin 15.2 ✅ Yes ❌ No ❌ No ✅ Yes All
One of the property keys for volumes.
Example
dim f as FolderItem = GetFolderItem("/Volumes/Test", FolderItem.PathTypeNative)

dim n as NSURLMBS = NSURLMBS.URLWithItem(f)
dim value as Variant
dim error as NSErrorMBS

if n.getResourceValue(value, n.NSURLVolumeIsRemovableKey, error) then
MsgBox "Removable: "+value.StringValue
else
MsgBox error.LocalizedDescription
end if

Key for determining whether the volume is removable from the drive mechanism, returned as a Boolean (read-only).

Available in OS X v10.7 and later.

Some examples using this method:

NSURLMBS.NSURLVolumeIsRootFileSystemKey as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method Cocoa Networking MBS MacBase Plugin 21.2 ✅ Yes ❌ No ❌ No ✅ Yes All
One of the file system URL resource keys.

true if the volume is the root filesystem. (Read-only, value type boolean)

NSURLMBS.NSURLVolumeLocalizedFormatDescriptionKey as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method Cocoa Networking MBS MacBase Plugin 15.2 ✅ Yes ❌ No ❌ No ✅ Yes All
One of the property keys for volumes.

Key for the volume’s descriptive format name, returned as a string (read-only).
Available in OS X v10.6 and later.

Some examples using this method:

NSURLMBS.NSURLVolumeLocalizedNameKey as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method Cocoa Networking MBS MacBase Plugin 15.2 ✅ Yes ❌ No ❌ No ✅ Yes All
One of the property keys for volumes.

The name of the volume as it should be displayed in the user interface, returned as a string (read-only).
Available in OS X v10.7 and later.

Some examples using this method:

NSURLMBS.NSURLVolumeMaximumFileSizeKey as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method Cocoa Networking MBS MacBase Plugin 15.2 ✅ Yes ❌ No ❌ No ✅ Yes All
One of the property keys for volumes.

Key for the largest file size supported by the volume in bytes, returned as a Boolean, or nil if it cannot be determined (read-only).

Available in OS X v10.7 and later.

Some examples using this method:

NSURLMBS.NSURLVolumeNameKey as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method Cocoa Networking MBS MacBase Plugin 15.2 ✅ Yes ❌ No ❌ No ✅ Yes All
One of the property keys for volumes.

The name of the volume, returned as an NSString object (read-write). Settable only if NSURLVolumeSupportsRenamingKey is true.

Available in OS X v10.7 and later.

Some examples using this method:

NSURLMBS.NSURLVolumeResourceCountKey as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method Cocoa Networking MBS MacBase Plugin 15.2 ✅ Yes ❌ No ❌ No ✅ Yes All
One of the property keys for volumes.

Key for the total number of resources on the volume, returned as an integer (read-only).
Available in OS X v10.6 and later.

Some examples using this method:

NSURLMBS.NSURLVolumeSupportsAccessPermissionsKey as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method Cocoa Networking MBS MacBase Plugin 21.2 ✅ Yes ❌ No ❌ No ✅ Yes All
One of the file system URL resource keys.

true if the volume supports setting POSIX access permissions with the NSURLFileSecurityKey property (Read-only, value type boolean)

NSURLMBS.NSURLVolumeSupportsAdvisoryFileLockingKey as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method Cocoa Networking MBS MacBase Plugin 15.2 ✅ Yes ❌ No ❌ No ✅ Yes All
One of the property keys for volumes.

Key for determining whether the volume implements whole-file advisory locks in the style of flock, along with the O_EXLOCK and O_SHLOCK flags of the open function, returned as a Boolean NSNumber object (read-only).

Available in OS X v10.7 and later.

Some examples using this method:

NSURLMBS.NSURLVolumeSupportsCasePreservedNamesKey as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method Cocoa Networking MBS MacBase Plugin 15.2 ✅ Yes ❌ No ❌ No ✅ Yes All
One of the property keys for volumes.
Example
dim f as FolderItem = Volume(0)
dim n as new NSURLMBS(f)

dim v as Variant
dim e as NSErrorMBS
if n.getResourceValue(v, n.NSURLVolumeSupportsCasePreservedNamesKey, e) then
MsgBox "VolumeSupportsCasePreservedNames: "+str(v.BooleanValue)
else
MsgBox "Failed to query: "+e.LocalizedDescription
end if

Key for determining whether the volume supports case-preserved names, returned as a Boolean (read-only).
Available in OS X v10.6 and later.

Some examples using this method:

NSURLMBS.NSURLVolumeSupportsCaseSensitiveNamesKey as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method Cocoa Networking MBS MacBase Plugin 15.2 ✅ Yes ❌ No ❌ No ✅ Yes All
One of the property keys for volumes.
Example
dim f as FolderItem = Volume(0)
dim n as new NSURLMBS(f)

dim v as Variant
dim e as NSErrorMBS
if n.getResourceValue(v, n.NSURLVolumeSupportsCaseSensitiveNamesKey, e) then
MsgBox "VolumeSupportsCaseSensitiveNames: "+str(v.BooleanValue)
else
MsgBox "Failed to query: "+e.LocalizedDescription
end if

Key for determining whether the volume supports case-sensitive names, returned as a Boolean (read-only).
Available in OS X v10.6 and later.

Some examples using this method:

NSURLMBS.NSURLVolumeSupportsCompressionKey as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method Cocoa Networking MBS MacBase Plugin 21.2 ✅ Yes ❌ No ❌ No ✅ Yes All
One of the file system URL resource keys.

true if the volume supports transparent decompression of compressed files using decmpfs. (Read-only, value type boolean)

NSURLMBS.NSURLVolumeSupportsExclusiveRenamingKey as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method Cocoa Networking MBS MacBase Plugin 21.2 ✅ Yes ❌ No ❌ No ✅ Yes All
One of the file system URL resource keys.

true if the volume supports renamex_np(2)'s RENAME_EXCL option (Read-only, value type boolean)

NSURLMBS.NSURLVolumeSupportsExtendedSecurityKey as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method Cocoa Networking MBS MacBase Plugin 15.2 ✅ Yes ❌ No ❌ No ✅ Yes All
One of the property keys for volumes.

Key for determining whether the volume supports extended security (access control lists), returned as a Boolean (read-only) (read-only).

Available in OS X v10.7 and later.

Some examples using this method:

NSURLMBS.NSURLVolumeSupportsFileCloningKey as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method Cocoa Networking MBS MacBase Plugin 21.2 ✅ Yes ❌ No ❌ No ✅ Yes All
One of the file system URL resource keys.

true if the volume supports clonefile(2) (Read-only, value type boolean)

NSURLMBS.NSURLVolumeSupportsFileProtectionKey as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method Cocoa Networking MBS MacBase Plugin 21.2 ✅ Yes ❌ No ❌ No ✅ Yes All
One of the file system URL resource keys.

True if the volume supports the File Protection attribute (see NSURLFileProtectionKey). (Read-only, value type number)

NSURLMBS.NSURLVolumeSupportsHardLinksKey as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method Cocoa Networking MBS MacBase Plugin 15.2 ✅ Yes ❌ No ❌ No ✅ Yes All
One of the property keys for volumes.

Key for determining whether the volume supports hard links, returned as a Boolean.
Available in OS X v10.6 and later.

Some examples using this method:

NSURLMBS.NSURLVolumeSupportsImmutableFilesKey as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method Cocoa Networking MBS MacBase Plugin 21.2 ✅ Yes ❌ No ❌ No ✅ Yes All
One of the file system URL resource keys.

true if the volume supports making files immutable with the NSURLIsUserImmutableKey or NSURLIsSystemImmutableKey properties (Read-only, value type boolean)

NSURLMBS.NSURLVolumeSupportsJournalingKey as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method Cocoa Networking MBS MacBase Plugin 15.2 ✅ Yes ❌ No ❌ No ✅ Yes All
One of the property keys for volumes.

Key for determining whether the volume supports journaling, returned as a Boolean.
Available in OS X v10.6 and later.

Some examples using this method:

NSURLMBS.NSURLVolumeSupportsPersistentIDsKey as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method Cocoa Networking MBS MacBase Plugin 15.2 ✅ Yes ❌ No ❌ No ✅ Yes All
One of the property keys for volumes.

Key for determining whether the volume supports persistent IDs, returned as a Boolean (read-only).
Available in OS X v10.6 and later.

Some examples using this method:

NSURLMBS.NSURLVolumeSupportsRenamingKey as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method Cocoa Networking MBS MacBase Plugin 15.2 ✅ Yes ❌ No ❌ No ✅ Yes All
One of the property keys for volumes.

Key for determining whether the volume can be renamed, returned as a Boolean (read-only).
Available in OS X v10.7 and later.

Some examples using this method:

NSURLMBS.NSURLVolumeSupportsRootDirectoryDatesKey as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method Cocoa Networking MBS MacBase Plugin 15.2 ✅ Yes ❌ No ❌ No ✅ Yes All
One of the property keys for volumes.

Key for determining whether the volume supports reliable storage of times for the root directory, returned as a Boolean (read-only).

Available in OS X v10.7 and later.

Some examples using this method:

NSURLMBS.NSURLVolumeSupportsSparseFilesKey as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method Cocoa Networking MBS MacBase Plugin 15.2 ✅ Yes ❌ No ❌ No ✅ Yes All
One of the property keys for volumes.

Key for determining whether the volume supports sparse files, returned as a Boolean.
Available in OS X v10.6 and later.

Some examples using this method:

NSURLMBS.NSURLVolumeSupportsSwapRenamingKey as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method Cocoa Networking MBS MacBase Plugin 21.2 ✅ Yes ❌ No ❌ No ✅ Yes All
One of the file system URL resource keys.

true if the volume supports renamex_np(2)'s RENAME_SWAP option (Read-only, value type boolean)

NSURLMBS.NSURLVolumeSupportsSymbolicLinksKey as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method Cocoa Networking MBS MacBase Plugin 15.2 ✅ Yes ❌ No ❌ No ✅ Yes All
One of the property keys for volumes.

Key for determining whether the volume supports symbolic links, returned as a Boolean.
Available in OS X v10.6 and later.

Some examples using this method:

NSURLMBS.NSURLVolumeSupportsVolumeSizesKey as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method Cocoa Networking MBS MacBase Plugin 15.2 ✅ Yes ❌ No ❌ No ✅ Yes All
One of the property keys for volumes.

Key for determining whether the volume supports returning volume size information, returned as a Boolean (read-only). If true, volume size information is available as values of the NSURLVolumeTotalCapacityKey and NSURLVolumeAvailableCapacityKey keys.

Available in OS X v10.7 and later.

Some examples using this method:

NSURLMBS.NSURLVolumeSupportsZeroRunsKey as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method Cocoa Networking MBS MacBase Plugin 15.2 ✅ Yes ❌ No ❌ No ✅ Yes All
One of the property keys for volumes.

Key for determining whether the volume supports zero runs, returned as a Boolean. (read-only).
Available in OS X v10.6 and later.

Some examples using this method:

NSURLMBS.NSURLVolumeTotalCapacityKey as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method Cocoa Networking MBS MacBase Plugin 15.2 ✅ Yes ❌ No ❌ No ✅ Yes All
One of the property keys for volumes.

Key for the volume’s capacity in bytes, returned as an Int64 (read-only).

Available in OS X v10.6 and later.

Some examples using this method:

NSURLMBS.NSURLVolumeURLForRemountingKey as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method Cocoa Networking MBS MacBase Plugin 15.2 ✅ Yes ❌ No ❌ No ✅ Yes All
One of the property keys for volumes.

Key for the URL needed to remount the network volume, returned as an NSURL object, or nil if a URL is not available (read-only).

Available in OS X v10.7 and later.

Some examples using this method:

NSURLMBS.NSURLVolumeURLKey as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method Cocoa Networking MBS MacBase Plugin 15.2 ✅ Yes ❌ No ❌ No ✅ Yes All
One of the file system URL resource keys.

The root directory of the resource’s volume, returned as an NSURL object (read-only).
Available in OS X v10.6 and later.

Some examples using this method:

NSURLMBS.NSURLVolumeUUIDStringKey as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method Cocoa Networking MBS MacBase Plugin 15.2 ✅ Yes ❌ No ❌ No ✅ Yes All
One of the property keys for volumes.

Key for the volume’s persistent UUID, returned as an NSString object, or nil if a persistent UUID is not available (read-only).

Available in OS X v10.7 and later.

Some examples using this method:

NSURLMBS.URLsResourceValuesForKeys(URLs() as NSURLMBS, keys() as string, targetDelegate as URLsResourceValuesForKeysDelegateMBS, tag as Variant = nil, PrecacheIcons as boolean = false)

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method Cocoa Networking MBS MacBase Plugin 15.2 ✅ Yes ❌ No ❌ No ✅ Yes All
Queries several URLs for values.

Similar to resourceValuesForKeys, this method will start a preemptive thread and queries values for all URLs on all keys in background. Once done it calls the delegate on main thread.
For icons, you can set PrecacheIcons to true. In that case plugin will draw icon on the preemptive thread, so icon data is really loaded from disk. When you than draw on main thread, it's really quick.

the delegate is declared like this:
URLsResourceValuesForKeysDelegateMBS(URLs() as NSURLMBS, keys() as String, Values() as Dictionary, Errors() as NSErrorMBS, tag as Variant)

Some examples using this method:

NSURLMBS.URLWithHandle(Handle as Integer) as NSURLMBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method Cocoa Networking MBS MacBase Plugin 16.4 ✅ Yes ❌ No ❌ No ✅ Yes All
Creates a new URL object based on a handle value.

Will retain the reference.

NSURLMBS.URLWithItem(Item as FolderItem) as NSURLMBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method Cocoa Networking MBS MacBase Plugin 15.2 ✅ Yes ❌ No ❌ No ✅ Yes All
Creates an URL based on folderItem.
Example
dim f as FolderItem = GetFolderItem("/Volumes/Ablage1", FolderItem.PathTypeNative)
dim n as NSURLMBS = NSURLMBS.URLWithItem(f)
MsgBox n.absoluteString

NSURLMBS.URLWithString(URL as string) as NSURLMBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method Cocoa Networking MBS MacBase Plugin 15.2 ✅ Yes ❌ No ❌ No ✅ Yes All
Creates and returns an NSURL object initialized with a provided URL string.

See also:

NSURLMBS.URLWithString(URL as string, baseURL as NSURLMBS) as NSURLMBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method Cocoa Networking MBS MacBase Plugin 15.2 ✅ Yes ❌ No ❌ No ✅ Yes All
Creates and returns an NSURL object initialized with a base URL and a relative string.

This method allows you to create a URL relative to a base path or URL. For example, if you have the URL for a folder on disk and the name of a file within that folder, you can construct a URL for the file by providing the folder’s URL as the base path (with a trailing slash) and the filename as the string part.

This method expects URLString to contain only characters that are allowed in a properly formed URL. All other characters must be properly percent escaped. Any percent-escaped characters are interpreted using UTF-8 encoding.

See also:

Previous items

The items on this page are in the following plugins: MBS MacBase Plugin.


The biggest plugin in space...