Classes
Protocols
Constants
Functions
Macros
Types
Variables

### Classes

NSAffineTransform
NSAppleEventDescriptor
NSAppleEventManager
NSAppleScript
NSArchiver
NSArray
NSAssertionHandler
NSAttributedString
NSAutoreleasePool
NSBackgroundActivityScheduler
NSBlockOperation
NSBundle
NSByteCountFormatter
NSCache
NSCachedURLResponse
NSCalendar
NSCalendarDate
NSCharacterSet
NSClassDescription
NSCoder
NSComparisonPredicate
NSCompoundPredicate
NSCondition
NSConditionLock
NSConnection
NSCountedSet
NSData
NSDate
NSDateComponents
NSDateComponentsFormatter
NSDateFormatter
NSDateInterval
NSDateIntervalFormatter
NSDecimalNumber
NSDecimalNumberHandler
NSDeserializer
NSDictionary
NSDimension
NSDirectoryEnumerator
NSDistantObject
NSDistributedLock
NSDistributedNotificationCenter
NSEnergyFormatter
NSEnumerator
NSError
NSException
NSExpression
NSExtensionContext
NSExtensionItem
NSFileAccessIntent
NSFileCoordinator
NSFileHandle
NSFileManager
NSFileVersion
NSFileWrapper
NSFormatter
NSGarbageCollector
NSHTTPCookie
NSHTTPCookieStorage
NSHTTPURLResponse
NSHashTable
NSHost
NSISO8601DateFormatter
NSIndexPath
NSIndexSet
NSInputStream
NSInvocation
NSInvocationOperation
NSItemProvider
NSItemProviderReadingWriting
NSJSONSerialization
NSKeyedArchiver
NSKeyedUnarchiver
NSLengthFormatter
NSLinguisticTagger
NSLocale
NSLock
NSMapTable
NSMassFormatter
NSMeasurement
NSMeasurementFormatter
NSMessagePort
NSMessagePortNameServer
NSMetadataItem
NSMetadataQuery
NSMetadataQueryAttributeValueTuple
NSMetadataQueryResultGroup
NSMethodSignature
NSMutableArray
NSMutableAttributedString
NSMutableCharacterSet
NSMutableData
NSMutableDictionary
NSMutableIndexSet
NSMutableOrderedSet
NSMutableSet
NSMutableString
NSMutableURLRequest
NSNetService
NSNetServiceBrowser
NSNotification
NSNotificationCenter
NSNotificationQueue
NSNull
NSNumber
NSNumberFormatter
NSObject
NSObjectScripting
NSOperation
NSOperationQueue
NSOrderedSet
NSOrthography
NSOutputStream
NSPersonNameComponents
NSPersonNameComponentsFormatter
NSPipe
NSPointerArray
NSPointerFunctions
NSPort
NSPortCoder
NSPortMessage
NSPortNameServer
NSPredicate
NSProcessInfo
NSProgress
NSPropertyListSerialization
NSProtocolChecker
NSProxy
NSRecursiveLock
NSRegularExpression
NSRunLoop
NSScanner
NSScriptClassDescription
NSScriptCoercionHandler
NSScriptCommand
NSScriptCommandDescription
NSScriptExecutionContext
NSScriptKeyValueCoding
NSScriptObjectSpecifiers
NSScriptStandardSuiteCommands
NSScriptSuiteRegistry
NSSerializer
NSSet
NSSocketPort
NSSocketPortNameServer
NSSortDescriptor
NSSpellServer
NSStream
NSString
NSTask
NSTextCheckingResult
NSThread
NSTimeZone
NSTimeZoneDetail
NSTimer
NSURL
NSURLAuthenticationChallenge
NSURLCache
NSURLComponents
NSURLConnection
NSURLCredential
NSURLCredentialStorage
NSURLDownload
NSURLHandle
NSURLProtectionSpace
NSURLProtocol
NSURLQueryItem
NSURLRequest
NSURLResponse
NSURLSession
NSURLSessionConfiguration
NSURLSessionDataTask
NSURLSessionDownloadTask
NSURLSessionStreamTask
NSURLSessionTask
NSURLSessionUploadTask
NSUUID
NSUbiquitousKeyValueStore
NSUnarchiver
NSUndoManager
NSUnit
NSUnitAcceleration
NSUnitAngle
NSUnitArea
NSUnitConcentrationMass
NSUnitConverter
NSUnitConverterLinear
NSUnitDispersion
NSUnitDuration
NSUnitElectricCharge
NSUnitElectricCurrent
NSUnitElectricPotentialDifference
NSUnitElectricResistance
NSUnitEnergy
NSUnitFrequency
NSUnitFuelEfficiency
NSUnitIlluminance
NSUnitLength
NSUnitMass
NSUnitPower
NSUnitPressure
NSUnitSpeed
NSUnitTemperature
NSUnitVolume
NSUserActivity
NSUserDefaults
NSUserNotification
NSUserNotificationCenter
NSUserScriptTask
NSValue
NSValueTransformer
NSXMLDTD
NSXMLDTDNode
NSXMLDocument
NSXMLElement
NSXMLNode
NSXMLParser
NSXPCConnection
NSXPCInterface
NSXPCListener
NSXPCListenerEndpoint
NXConstantString

### Protocols

<GSLogDelegate>
<NSCacheDelegate>
<NSCoding>
<NSCopying>
<NSDecimalNumberBehaviors>
<NSDiscardableContent>
<NSExtensionRequestHandling>
<NSFastEnumeration>
<NSFileManagerDelegate>
<NSFilePresenter>
<NSItemProviderReading>
<NSItemProviderWriting>
<NSLocking>
<NSMetadataQueryDelegate>
<NSMutableCopying>
<NSNetServiceBrowserDelegate>
<NSNetServiceDelegate>
<NSObjCTypeSerializationCallBack>
<NSObject>
<NSProgressReporting>
<NSSecureCoding>
<NSStreamDelegate>
<NSURLAuthenticationChallengeSender>
<NSURLConnectionDataDelegate>
<NSURLHandleClient>
<NSURLProtocolClient>
<NSURLSessionDataDelegate>
<NSURLSessionDelegate>
<NSURLSessionDownloadDelegate>
<NSURLSessionTaskDelegate>
<NSUserNotificationCenterDelegate>
<NSXMLParserDelegate>
<NSXPCListenerDelegate>
<NSXPCProxyCreating>
<RunLoopEvents>
(GSTraceLocks)
(NSComparisonMethods)
(NSConnectionDelegate)
(NSErrorRecoveryAttempting)
(NSFileManagerDelegate)
(NSFileManagerHandler)
(NSFilePresenter)
(NSKeyValueCoding)
(NSMetadataQueryDelegate)
(NSNetServiceBrowserDelegateMethods)
(NSNetServiceDelegateMethods)
(NSSpellServerDelegate)
(NSStreamDelegate)
(NSUserNotificationCenterDelegateMethods)
(RunLoopEvents)
(TimedPerformers)

### Constants

GSCACertificateFilePath
GSConfigDomain
GSFileHandleConnectCompletionNotification
GSFileHandleNotificationError
GSFileHandleWriteCompletionNotification
GSHTTPPropertyCertificateFileKey
GSHTTPPropertyKeyFileKey
GSHTTPPropertyLocalHostKey
GSHTTPPropertyMethodKey
GSHTTPPropertyPasswordKey
GSHTTPPropertyProxyHostKey
GSHTTPPropertyProxyPortKey
GSLocale
GSNetworkNotificationCenterType
GSPublicNotificationCenterType
GSTLSCAFile
GSTLSCertificateFile
GSTLSCertificateKeyFile
GSTLSCertificateKeyPassword
GSTLSDebug
GSTLSIssuers
GSTLSOwners
GSTLSPriority
GSTLSRemoteHosts
GSTLSRevokeFile
GSTLSServerName
GSTLSVerify
NSAMPMDesignation
NSArgumentDomain
NSAssertionHandlerKey
NSBuddhistCalendar
NSBundleDidLoadNotification
NSCalendarIdentifierBuddhist
NSCalendarIdentifierChinese
NSCalendarIdentifierCoptic
NSCalendarIdentifierEthiopicAmeteAlem
NSCalendarIdentifierEthiopicAmeteMihret
NSCalendarIdentifierGregorian
NSCalendarIdentifierHebrew
NSCalendarIdentifierISO8601
NSCalendarIdentifierIndian
NSCalendarIdentifierIslamic
NSCalendarIdentifierIslamicCivil
NSCalendarIdentifierIslamicTabular
NSCalendarIdentifierIslamicUmmAlQura
NSCalendarIdentifierJapanese
NSCalendarIdentifierPersian
NSCalendarIdentifierRepublicOfChina
NSCharacterConversionException
NSChineseCalendar
NSClassDescriptionNeededForClassNotification
NSConnectionDidDieNotification
NSConnectionDidInitializeNotification
NSConnectionLocalCount
NSConnectionProxyCount
NSConnectionRepliesReceived
NSConnectionRepliesSent
NSConnectionReplyMode
NSConnectionRequestsReceived
NSConnectionRequestsSent
NSCurrencyString
NSCurrencySymbol
NSCurrentLocaleDidChangeNotification
NSDateFormatString
NSDateTimeOrdering
NSDecimalDigits
NSDecimalSeparator
NSDestinationInvalidException
NSEarlierTimeDesignations
NSEdgeInsetsZero
NSErrorFailingURLStringKey
NSExtensionHostDidBecomeActiveNotification
NSExtensionHostDidEnterBackgroundNotification
NSExtensionHostWillEnterForegroundNotification
NSExtensionHostWillResignActiveNotification
NSExtensionItemAttachmentsKey
NSExtensionItemAttributedContentTextKey
NSExtensionItemAttributedTitleKey
NSExtensionItemsAndErrorsKey
NSExtensionJavaScriptFinalizeArgumentKey
NSExtensionJavaScriptPreprocessingResultsKey
NSFailedAuthenticationException
NSFileAppendOnly
NSFileCreationDate
NSFileDeviceIdentifier
NSFileExtensionHidden
NSFileGroupOwnerAccountID
NSFileGroupOwnerAccountName
NSFileHFSCreatorCode
NSFileHFSTypeCode
NSFileHandleConnectionAcceptedNotification
NSFileHandleDataAvailableNotification
NSFileHandleNotificationDataItem
NSFileHandleNotificationFileHandleItem
NSFileHandleNotificationMonitorModes
NSFileHandleOperationException
NSFileHandleReadCompletionNotification
NSFileHandleReadToEndOfFileCompletionNotification
NSFileImmutable
NSFileModificationDate
NSFileOwnerAccountID
NSFileOwnerAccountName
NSFilePathErrorKey
NSFilePosixPermissions
NSFileReferenceCount
NSFileSize
NSFileSystemFileNumber
NSFileSystemFreeNodes
NSFileSystemFreeSize
NSFileSystemNodes
NSFileSystemNumber
NSFileSystemSize
NSFileType
NSFileTypeBlockSpecial
NSFileTypeCharacterSpecial
NSFileTypeDirectory
NSFileTypeFifo
NSFileTypeRegular
NSFileTypeSocket
NSFileTypeSymbolicLink
NSFileTypeUnknown
NSFormalName
NSGenericException
NSGlobalDomain
NSGrammarCorrections
NSGrammarRange
NSGrammarUserDescription
NSGregorianCalendar
NSHTTPCookieComment
NSHTTPCookieCommentURL
NSHTTPCookieDiscard
NSHTTPCookieDomain
NSHTTPCookieExpires
NSHTTPCookieManagerAcceptPolicyChangedNotification
NSHTTPCookieManagerCookiesChangedNotification
NSHTTPCookieMaximumAge
NSHTTPCookieName
NSHTTPCookieOriginURL
NSHTTPCookiePath
NSHTTPCookiePort
NSHTTPCookieSecure
NSHTTPCookieValue
NSHTTPCookieVersion
NSHTTPPropertyErrorPageDataKey
NSHTTPPropertyRedirectionHeadersKey
NSHTTPPropertyServerHTTPVersionKey
NSHTTPPropertyStatusCodeKey
NSHTTPPropertyStatusReasonKey
NSHebrewCalendar
NSHourNameDesignations
NSISO8601Calendar
NSInconsistentArchiveException
NSIndianCalendar
NSIntHashCallBacks
NSIntMapKeyCallBacks
NSIntMapValueCallBacks
NSIntegerHashCallBacks
NSIntegerMapKeyCallBacks
NSIntegerMapValueCallBacks
NSInternalInconsistencyException
NSInternationalCurrencyString
NSInvalidArchiveOperationException
NSInvalidArgumentException
NSInvalidReceivePortException
NSInvalidSendPortException
NSInvalidUnarchiveOperationException
NSInvocationOperationCancelledException
NSInvocationOperationVoidResultException
NSIsNilTransformerName
NSIsNotNilTransformerName
NSIslamicCalendar
NSIslamicCivilCalendar
NSItemProviderErrorDomain
NSItemProviderPreferredImageSizeKey
NSJapaneseCalendar
NSKeyValueChangeIndexesKey
NSKeyValueChangeKindKey
NSKeyValueChangeNewKey
NSKeyValueChangeNotificationIsPriorKey
NSKeyValueChangeOldKey
NSLanguageCode
NSLanguageName
NSLaterTimeDesignations
NSLoadedClasses
NSLocalNotificationCenterType
NSLocaleAlternateQuotationBeginDelimiterKey
NSLocaleAlternateQuotationEndDelimiterKey
NSLocaleCalendar
NSLocaleCalendarIdentifier
NSLocaleCollationIdentifier
NSLocaleCollatorIdentifier
NSLocaleCountryCode
NSLocaleCurrencyCode
NSLocaleCurrencySymbol
NSLocaleDecimalSeparator
NSLocaleExemplarCharacterSet
NSLocaleGroupingSeparator
NSLocaleIdentifier
NSLocaleLanguageCode
NSLocaleMeasurementSystem
NSLocaleQuotationBeginDelimiterKey
NSLocaleQuotationEndDelimiterKey
NSLocaleScriptCode
NSLocaleUsesMetricSystem
NSLocaleVariantCode
NSLocalizedDescriptionKey
NSLocalizedFailureReasonErrorKey
NSLocalizedRecoveryOptionsErrorKey
NSLocalizedRecoverySuggestionErrorKey
NSMallocException
NSMatchingAnchored
NSMatchingCompleted
NSMatchingHitEnd
NSMatchingInternalError
NSMatchingProgress
NSMatchingReportCompletion
NSMatchingReportProgress
NSMatchingRequiredEnd
NSMatchingWithTransparentBounds
NSMatchingWithoutAnchoringBounds
NSMetadataItemAcquisitionMakeKey
NSMetadataItemAcquisitionModelKey
NSMetadataItemAlbumKey
NSMetadataItemAltitudeKey
NSMetadataItemApertureKey
NSMetadataItemAppleLoopDescriptorsKey
NSMetadataItemAppleLoopsKeyFilterTypeKey
NSMetadataItemAppleLoopsLoopModeKey
NSMetadataItemAppleLoopsRootKeyKey
NSMetadataItemApplicationCategoriesKey
NSMetadataItemAttributeChangeDateKey
NSMetadataItemAudiencesKey
NSMetadataItemAudioBitRateKey
NSMetadataItemAudioChannelCountKey
NSMetadataItemAudioEncodingApplicationKey
NSMetadataItemAudioSampleRateKey
NSMetadataItemAudioTrackNumberKey
NSMetadataItemAuthorAddressesKey
NSMetadataItemAuthorEmailAddressesKey
NSMetadataItemAuthorsKey
NSMetadataItemBitsPerSampleKey
NSMetadataItemCFBundleIdentifierKey
NSMetadataItemCameraOwnerKey
NSMetadataItemCityKey
NSMetadataItemCodecsKey
NSMetadataItemColorSpaceKey
NSMetadataItemCommentKey
NSMetadataItemComposerKey
NSMetadataItemContactKeywordsKey
NSMetadataItemContentCreationDateKey
NSMetadataItemContentModificationDateKey
NSMetadataItemContentTypeKey
NSMetadataItemContentTypeTreeKey
NSMetadataItemContributorsKey
NSMetadataItemCopyrightKey
NSMetadataItemCountryKey
NSMetadataItemCoverageKey
NSMetadataItemCreatorKey
NSMetadataItemDateAddedKey
NSMetadataItemDeliveryTypeKey
NSMetadataItemDescriptionKey
NSMetadataItemDirectorKey
NSMetadataItemDisplayNameKey
NSMetadataItemDownloadedDateKey
NSMetadataItemDueDateKey
NSMetadataItemDurationSecondsKey
NSMetadataItemEXIFGPSVersionKey
NSMetadataItemEXIFVersionKey
NSMetadataItemEditorsKey
NSMetadataItemEmailAddressesKey
NSMetadataItemEncodingApplicationsKey
NSMetadataItemExecutableArchitecturesKey
NSMetadataItemExecutablePlatformKey
NSMetadataItemExposureModeKey
NSMetadataItemExposureProgramKey
NSMetadataItemExposureTimeSecondsKey
NSMetadataItemExposureTimeStringKey
NSMetadataItemFNumberKey
NSMetadataItemFSContentChangeDateKey
NSMetadataItemFSCreationDateKey
NSMetadataItemFSNameKey
NSMetadataItemFSSizeKey
NSMetadataItemFinderCommentKey
NSMetadataItemFlashOnOffKey
NSMetadataItemFocalLength35mmKey
NSMetadataItemFocalLengthKey
NSMetadataItemFontsKey
NSMetadataItemGPSAreaInformationKey
NSMetadataItemGPSDOPKey
NSMetadataItemGPSDateStampKey
NSMetadataItemGPSDestBearingKey
NSMetadataItemGPSDestDistanceKey
NSMetadataItemGPSDestLatitudeKey
NSMetadataItemGPSDestLongitudeKey
NSMetadataItemGPSDifferentalKey
NSMetadataItemGPSMapDatumKey
NSMetadataItemGPSMeasureModeKey
NSMetadataItemGPSProcessingMethodKey
NSMetadataItemGPSStatusKey
NSMetadataItemGPSTrackKey
NSMetadataItemGenreKey
NSMetadataItemHasAlphaChannelKey
NSMetadataItemHeadlineKey
NSMetadataItemISOSpeedKey
NSMetadataItemIdentifierKey
NSMetadataItemImageDirectionKey
NSMetadataItemInformationKey
NSMetadataItemInstantMessageAddressesKey
NSMetadataItemInstructionsKey
NSMetadataItemIsApplicationManagedKey
NSMetadataItemIsGeneralMIDISequenceKey
NSMetadataItemIsLikelyJunkKey
NSMetadataItemIsUbiquitousKey
NSMetadataItemKeySignatureKey
NSMetadataItemKeywordsKey
NSMetadataItemKindKey
NSMetadataItemLanguagesKey
NSMetadataItemLastUsedDateKey
NSMetadataItemLatitudeKey
NSMetadataItemLayerNamesKey
NSMetadataItemLensModelKey
NSMetadataItemLongitudeKey
NSMetadataItemLyricistKey
NSMetadataItemMaxApertureKey
NSMetadataItemMediaTypesKey
NSMetadataItemMeteringModeKey
NSMetadataItemMusicalGenreKey
NSMetadataItemMusicalInstrumentCategoryKey
NSMetadataItemMusicalInstrumentNameKey
NSMetadataItemNamedLocationKey
NSMetadataItemNumberOfPagesKey
NSMetadataItemOrganizationsKey
NSMetadataItemOrientationKey
NSMetadataItemOriginalFormatKey
NSMetadataItemOriginalSourceKey
NSMetadataItemPageHeightKey
NSMetadataItemPageWidthKey
NSMetadataItemParticipantsKey
NSMetadataItemPathKey
NSMetadataItemPerformersKey
NSMetadataItemPhoneNumbersKey
NSMetadataItemPixelCountKey
NSMetadataItemPixelHeightKey
NSMetadataItemPixelWidthKey
NSMetadataItemProducerKey
NSMetadataItemProfileNameKey
NSMetadataItemProjectsKey
NSMetadataItemPublishersKey
NSMetadataItemRecipientAddressesKey
NSMetadataItemRecipientEmailAddressesKey
NSMetadataItemRecipientsKey
NSMetadataItemRecordingDateKey
NSMetadataItemRecordingYearKey
NSMetadataItemRedEyeOnOffKey
NSMetadataItemResolutionHeightDPIKey
NSMetadataItemResolutionWidthDPIKey
NSMetadataItemRightsKey
NSMetadataItemSecurityMethodKey
NSMetadataItemSpeedKey
NSMetadataItemStarRatingKey
NSMetadataItemStateOrProvinceKey
NSMetadataItemStreamableKey
NSMetadataItemSubjectKey
NSMetadataItemTempoKey
NSMetadataItemTextContentKey
NSMetadataItemThemeKey
NSMetadataItemTimeSignatureKey
NSMetadataItemTimestampKey
NSMetadataItemTitleKey
NSMetadataItemTotalBitRateKey
NSMetadataItemURLKey
NSMetadataItemVersionKey
NSMetadataItemVideoBitRateKey
NSMetadataItemWhereFromsKey
NSMetadataItemWhiteBalanceKey
NSMetadataQueryDidFinishGatheringNotification
NSMetadataQueryDidStartGatheringNotification
NSMetadataQueryDidUpdateNotification
NSMetadataQueryGatheringProgressNotification
NSMetadataQueryLocalComputerScope
NSMetadataQueryNetworkScope
NSMetadataQueryUbiquitousDataScope
NSMetadataQueryUbiquitousDocumentsScope
NSMetadataQueryUserHomeScope
NSMetadataUbiquitousItemContainerDisplayNameKey
NSMetadataUbiquitousItemDownloadRequestedKey
NSMetadataUbiquitousItemDownloadingErrorKey
NSMetadataUbiquitousItemDownloadingStatusCurrent
NSMetadataUbiquitousItemDownloadingStatusDownloaded
NSMetadataUbiquitousItemDownloadingStatusKey
NSMetadataUbiquitousItemDownloadingStatusNotDownloaded
NSMetadataUbiquitousItemHasUnresolvedConflictsKey
NSMetadataUbiquitousItemIsDownloadedKey
NSMetadataUbiquitousItemIsDownloadingKey
NSMetadataUbiquitousItemIsExternalDocumentKey
NSMetadataUbiquitousItemIsSharedKey
NSMetadataUbiquitousItemIsUploadedKey
NSMetadataUbiquitousItemIsUploadingKey
NSMetadataUbiquitousItemPercentDownloadedKey
NSMetadataUbiquitousItemPercentUploadedKey
NSMetadataUbiquitousItemURLInLocalContainerKey
NSMetadataUbiquitousItemUploadingErrorKey
NSMetadataUbiquitousSharedItemCurrentUserPermissionsKey
NSMetadataUbiquitousSharedItemCurrentUserRoleKey
NSMetadataUbiquitousSharedItemMostRecentEditorNameComponentsKey
NSMetadataUbiquitousSharedItemOwnerNameComponentsKey
NSMetadataUbiquitousSharedItemPermissionsReadOnly
NSMetadataUbiquitousSharedItemPermissionsReadWrite
NSMetadataUbiquitousSharedItemRoleOwner
NSMetadataUbiquitousSharedItemRoleParticipant
NSMonthNameArray
NSNegateBooleanTransformerName
NSNetServicesErrorCode
NSNetServicesErrorDomain
NSNextDayDesignations
NSNextNextDayDesignations
NSNonOwnedPointerHashCallBacks
NSNonOwnedPointerMapKeyCallBacks
NSNonOwnedPointerMapValueCallBacks
NSNonOwnedPointerOrNullMapKeyCallBacks
NSNonRetainedObjectHashCallBacks
NSNonRetainedObjectMapKeyCallBacks
NSNonRetainedObjectMapValueCallBacks
NSObjectHashCallBacks
NSObjectInaccessibleException
NSObjectMapKeyCallBacks
NSObjectMapValueCallBacks
NSObjectNotAvailableException
NSOldStyleException
NSOwnedPointerHashCallBacks
NSOwnedPointerMapKeyCallBacks
NSOwnedPointerMapValueCallBacks
NSParseErrorException
NSPersianCalendar
NSPersonNameComponentDelimiter
NSPersonNameComponentFamilyName
NSPersonNameComponentGivenName
NSPersonNameComponentKey
NSPersonNameComponentMiddleName
NSPersonNameComponentNickname
NSPersonNameComponentPrefix
NSPersonNameComponentSuffix
NSPointerToStructHashCallBacks
NSPortDidBecomeInvalidNotification
NSPortReceiveException
NSPortSendException
NSPortTimeoutException
NSPriorDayDesignations
NSRangeException
NSRecoveryAttempterErrorKey
NSRegistrationDomain
NSRegularExpressionAllowCommentsAndWhitespace
NSRegularExpressionAnchorsMatchLines
NSRegularExpressionCaseInsensitive
NSRegularExpressionDotMatchesLineSeparators
NSRegularExpressionIgnoreMetacharacters
NSRegularExpressionUseUnicodeWordBoundaries
NSRegularExpressionUseUnixLineSeparators
NSRepublicOfChinaCalendar
NSShortDateFormatString
NSShortMonthNameArray
NSShortTimeDateFormatString
NSShortWeekDayNameArray
NSShowNonLocalizedStrings
NSStreamDataWrittenToMemoryStreamKey
NSStreamFileCurrentOffsetKey
NSStreamSOCKSErrorDomain
NSStreamSOCKSProxyConfigurationKey
NSStreamSOCKSProxyHostKey
NSStreamSOCKSProxyPasswordKey
NSStreamSOCKSProxyPortKey
NSStreamSOCKSProxyUserKey
NSStreamSOCKSProxyVersion4
NSStreamSOCKSProxyVersion5
NSStreamSOCKSProxyVersionKey
NSStreamSocketSSLErrorDomain
NSStreamSocketSecurityLevelKey
NSStreamSocketSecurityLevelNegotiatedSSL
NSStreamSocketSecurityLevelNone
NSStreamSocketSecurityLevelSSLv2
NSStreamSocketSecurityLevelSSLv3
NSStreamSocketSecurityLevelTLSv1
NSStringEncodingErrorKey
NSSystemClockDidChangeNotification
NSSystemTimeZoneDidChangeNotification
NSTaskDidTerminateNotification
NSThisDayDesignations
NSThousandsSeparator
NSThreadDidStartNotification
NSThreadWillExitNotification
NSThumbnail1024x1024SizeKey
NSTimeDateFormatString
NSTimeFormatString
NSTimeIntervalSince1970
NSURLAddedToDirectoryDateKey
NSURLApplicationIsScriptableKey
NSURLAttributeModificationDateKey
NSURLAuthenticationMethodClientCertificate
NSURLAuthenticationMethodDefault
NSURLAuthenticationMethodHTMLForm
NSURLAuthenticationMethodHTTPBasic
NSURLAuthenticationMethodHTTPDigest
NSURLAuthenticationMethodNTLM
NSURLAuthenticationMethodNegotiate
NSURLAuthenticationMethodServerTrust
NSURLContentAccessDateKey
NSURLContentModificationDateKey
NSURLCreationDateKey
NSURLCredentialStorageChangedNotification
NSURLCustomIconKey
NSURLDocumentIdentifierKey
NSURLEffectiveIconKey
NSURLErrorDomain
NSURLErrorFailingURLErrorKey
NSURLErrorFailingURLStringErrorKey
NSURLErrorKey
NSURLFileAllocatedSizeKey
NSURLFileResourceIdentifierKey
NSURLFileResourceTypeBlockSpecial
NSURLFileResourceTypeCharacterSpecial
NSURLFileResourceTypeDirectory
NSURLFileResourceTypeKey
NSURLFileResourceTypeNamedPipe
NSURLFileResourceTypeRegular
NSURLFileResourceTypeSocket
NSURLFileResourceTypeSymbolicLink
NSURLFileResourceTypeUnknown
NSURLFileScheme
NSURLFileSecurityKey
NSURLFileSizeKey
NSURLGenerationIdentifierKey
NSURLHasHiddenExtensionKey
NSURLIsAliasFileKey
NSURLIsApplicationKey
NSURLIsDirectoryKey
NSURLIsExcludedFromBackupKey
NSURLIsExecutableKey
NSURLIsHiddenKey
NSURLIsMountTriggerKey
NSURLIsPackageKey
NSURLIsReadableKey
NSURLIsRegularFileKey
NSURLIsSymbolicLinkKey
NSURLIsSystemImmutableKey
NSURLIsUbiquitousItemKey
NSURLIsUserImmutableKey
NSURLIsVolumeKey
NSURLIsWritableKey
NSURLLabelColorKey
NSURLLabelNumberKey
NSURLLinkCountKey
NSURLLocalizedLabelKey
NSURLLocalizedNameKey
NSURLLocalizedTypeDescriptionKey
NSURLNameKey
NSURLParentDirectoryURLKey
NSURLPathKey
NSURLPreferredIOBlockSizeKey
NSURLProtectionSpaceFTPProxy
NSURLProtectionSpaceHTTPProxy
NSURLProtectionSpaceHTTPSProxy
NSURLProtectionSpaceSOCKSProxy
NSURLQuarantinePropertiesKey
NSURLSessionTaskPriorityDefault
NSURLSessionTaskPriorityHigh
NSURLSessionTaskPriorityLow
NSURLSessionTransferSizeUnknown
NSURLTagNamesKey
NSURLTotalFileAllocatedSizeKey
NSURLTotalFileSizeKey
NSURLTypeIdentifierKey
NSURLUbiquitousItemContainerDisplayNameKey
NSURLUbiquitousItemDownloadRequestedKey
NSURLUbiquitousItemDownloadingErrorKey
NSURLUbiquitousItemDownloadingStatusCurrent
NSURLUbiquitousItemDownloadingStatusDownloaded
NSURLUbiquitousItemDownloadingStatusKey
NSURLUbiquitousItemDownloadingStatusNotDownloaded
NSURLUbiquitousItemHasUnresolvedConflictsKey
NSURLUbiquitousItemIsDownloadingKey
NSURLUbiquitousItemIsUploadedKey
NSURLUbiquitousItemIsUploadingKey
NSURLUbiquitousItemUploadingErrorKey
NSURLVolumeAvailableCapacityKey
NSURLVolumeCreationDateKey
NSURLVolumeIdentifierKey
NSURLVolumeIsAutomountedKey
NSURLVolumeIsBrowsableKey
NSURLVolumeIsEjectableKey
NSURLVolumeIsInternalKey
NSURLVolumeIsJournalingKey
NSURLVolumeIsLocalKey
NSURLVolumeIsReadOnlyKey
NSURLVolumeIsRemovableKey
NSURLVolumeLocalizedFormatDescriptionKey
NSURLVolumeLocalizedNameKey
NSURLVolumeMaximumFileSizeKey
NSURLVolumeNameKey
NSURLVolumeResourceCountKey
NSURLVolumeSupportsAdvisoryFileLockingKey
NSURLVolumeSupportsCasePreservedNamesKey
NSURLVolumeSupportsCaseSensitiveNamesKey
NSURLVolumeSupportsExtendedSecurityKey
NSURLVolumeSupportsHardLinksKey
NSURLVolumeSupportsJournalingKey
NSURLVolumeSupportsPersistentIDsKey
NSURLVolumeSupportsRenamingKey
NSURLVolumeSupportsRootDirectoryDatesKey
NSURLVolumeSupportsSparseFilesKey
NSURLVolumeSupportsSymbolicLinksKey
NSURLVolumeSupportsVolumeSizesKey
NSURLVolumeSupportsZeroRunsKey
NSURLVolumeTotalCapacityKey
NSURLVolumeURLForRemountingKey
NSURLVolumeURLKey
NSURLVolumeUUIDStringKey
NSUbiquitousKeyValueStoreChangeReasonKey
NSUbiquitousKeyValueStoreDidChangeExternallyNotification
NSUnarchiveFromDataTransformerName
NSUndefinedKeyException
NSUnderlyingErrorKey
NSUndoManagerCheckpointNotification
NSUndoManagerDidOpenUndoGroupNotification
NSUndoManagerDidRedoChangeNotification
NSUndoManagerDidUndoChangeNotification
NSUndoManagerWillCloseUndoGroupNotification
NSUndoManagerWillRedoChangeNotification
NSUndoManagerWillUndoChangeNotification
NSUserDefaultsDidChangeNotification
NSUserNotificationDefaultSoundName
NSWeekDayNameArray
NSWillBecomeMultiThreadedNotification
NSXMLParserErrorDomain
NSYearMonthWeekDesignations
NSZeroPoint
NSZeroRect
NSZeroSize

### Functions

GNUstepConfig
GNUstepUserConfig
GSDebugAllocationActive
GSDebugAllocationAdd
GSDebugAllocationBytes
GSDebugAllocationClassList
GSDebugAllocationCount
GSDebugAllocationList
GSDebugAllocationListAll
GSDebugAllocationListRecordedObjects
GSDebugAllocationPeak
GSDebugAllocationRecordAndTrace
GSDebugAllocationRecordObjects
GSDebugAllocationRemove
GSDebugAllocationTagRecordedObject
GSDebugAllocationTaggedObjects
GSDebugAllocationTotal
GSDebugSet
GSDefaultsRootForUser
GSInitializeProcess
GSInitializeProcessAndroid
GSInitializeProcessAndroidWithArgs
GSLogLock
GSNSURLSessionDataCompletionHandler
GSNSURLSessionDownloadCompletionHandler
GSOutOfMemory
GSRegisterCurrentThread
GSSetDebugAllocationFunctions
GSSetUserName
GSSpellServerName
GSSwapBigI128ToHost
GSSwapBigI16ToHost
GSSwapBigI32ToHost
GSSwapBigI64ToHost
GSSwapHostI128ToBig
GSSwapHostI128ToLittle
GSSwapHostI16ToBig
GSSwapHostI16ToLittle
GSSwapHostI32ToBig
GSSwapHostI32ToLittle
GSSwapHostI64ToBig
GSSwapHostI64ToLittle
GSSwapI128
GSSwapI16
GSSwapI32
GSSwapI64
GSSwapLittleI128ToHost
GSSwapLittleI16ToHost
GSSwapLittleI32ToHost
GSSwapLittleI64ToHost
GSUPurge
GSUSet
GSUnique
GSUniquing
GSUnregisterCurrentThread
NSAllHashTableObjects
NSAllMapTableKeys
NSAllMapTableValues
NSAllocateCollectable
NSAllocateMemoryPages
NSAllocateObject
NSClassFromString
NSCompareHashTables
NSCompareMapTables
NSContainsRect
NSConvertHostDoubleToSwapped
NSConvertHostFloatToSwapped
NSConvertSwappedDoubleToHost
NSConvertSwappedFloatToHost
NSCopyHashTableWithZone
NSCopyMapTableWithZone
NSCopyMemoryPages
NSCopyObject
NSCountFrames
NSCountHashTable
NSCountMapTable
NSCreateHashTable
NSCreateHashTableWithZone
NSCreateMapTable
NSCreateMapTableWithZone
NSCreateZone
NSDeallocateMemoryPages
NSDeallocateObject
NSDecimalAdd
NSDecimalCompact
NSDecimalCompare
NSDecimalCopy
NSDecimalDivide
NSDecimalDouble
NSDecimalFromComponents
NSDecimalFromString
NSDecimalIsNotANumber
NSDecimalMax
NSDecimalMin
NSDecimalMultiply
NSDecimalMultiplyByPowerOf10
NSDecimalNormalize
NSDecimalPower
NSDecimalRound
NSDecimalString
NSDecimalSubtract
NSDecrementExtraRefCountWasZero
NSDefaultMallocZone
NSDivideRect
NSEdgeInsetsEqual
NSEdgeInsetsMake
NSEndHashTableEnumeration
NSEndMapTableEnumeration
NSEnumerateHashTable
NSEnumerateMapTable
NSEqualPoints
NSEqualRanges
NSEqualRects
NSEqualSizes
NSExtraRefCount
NSFileTypeForHFSTypeCode
NSFrameAddress
NSFreeHashTable
NSFreeMapTable
NSFullUserName
NSGetSizeAndAlignment
NSGetUncaughtExceptionHandler
NSHFSTypeCodeFromFileType
NSHFSTypeOfFile
NSHashGet
NSHashInsert
NSHashInsertIfAbsent
NSHashInsertKnownAbsent
NSHashRemove
NSHeight
NSHomeDirectory
NSHomeDirectoryForUser
NSHostByteOrder
NSIncrementExtraRefCount
NSInsetRect
NSIntegralRect
NSIntegralRectWithOptions
NSIntersectionRange
NSIntersectionRect
NSIntersectsRect
NSIsEmptyRect
NSLocationInRange
NSLock_error_handler
NSLog
NSLogPageSize
NSLog_printf_handler
NSLogv
NSMakeCollectable
NSMakePoint
NSMakeRange
NSMakeRect
NSMakeSize
NSMapGet
NSMapInsert
NSMapInsertIfAbsent
NSMapInsertKnownAbsent
NSMapMember
NSMapRemove
NSMaxRange
NSMaxX
NSMaxY
NSMidX
NSMidY
NSMinX
NSMinY
NSMouseInRect
NSNextHashEnumeratorItem
NSNextMapEnumeratorPair
NSOffsetRect
NSOpenStepRootDirectory
NSPageSize
NSPointFromCGPoint
NSPointFromString
NSPointInRect
NSPointToCGPoint
NSProtocolFromString
NSRangeFromString
NSRealMemoryAvailable
NSReallocateCollectable
NSRectFromCGRect
NSRectFromString
NSRectToCGRect
NSRecycleZone
NSResetHashTable
NSResetMapTable
NSReturnAddress
NSRoundDownToMultipleOfPageSize
NSRoundUpToMultipleOfPageSize
NSSearchPathForDirectoriesInDomains
NSSelectorFromString
NSSetUncaughtExceptionHandler
NSSetZoneName
NSShouldRetainWithZone
NSSizeFromCGSize
NSSizeFromString
NSSizeToCGSize
NSStandardApplicationPaths
NSStandardLibraryPaths
NSStringFromClass
NSStringFromHashTable
NSStringFromMapTable
NSStringFromPoint
NSStringFromProtocol
NSStringFromRange
NSStringFromRect
NSStringFromSelector
NSStringFromSize
NSSwapBigDoubleToHost
NSSwapBigFloatToHost
NSSwapBigIntToHost
NSSwapBigLongLongToHost
NSSwapBigLongToHost
NSSwapBigShortToHost
NSSwapDouble
NSSwapFloat
NSSwapHostDoubleToBig
NSSwapHostDoubleToLittle
NSSwapHostFloatToBig
NSSwapHostFloatToLittle
NSSwapHostIntToBig
NSSwapHostIntToLittle
NSSwapHostLongLongToBig
NSSwapHostLongLongToLittle
NSSwapHostLongToBig
NSSwapHostLongToLittle
NSSwapHostShortToBig
NSSwapHostShortToLittle
NSSwapInt
NSSwapLittleDoubleToHost
NSSwapLittleFloatToHost
NSSwapLittleIntToHost
NSSwapLittleLongLongToHost
NSSwapLittleLongToHost
NSSwapLittleShortToHost
NSSwapLong
NSSwapLongLong
NSSwapShort
NSTemporaryDirectory
NSUncaughtExceptionHandler
NSUnionRange
NSUnionRect
NSUserName
NSWidth
NSZoneCalloc
NSZoneCheck
NSZoneFree
NSZoneFromPointer
NSZoneMalloc
NSZoneName
NSZoneRealloc
NSZoneStats
_NSAddHandler
_NSRangeExceptionRaise
_NSRemoveHandler
_gcc3_1_hack
gs_consumed

### Macros

FOUNDATION_EXPORT
GS_API_LATEST
GS_API_MACOSX
GS_API_NONE
GS_API_OPENSTEP
GS_API_OSSPEC
GS_API_VERSION
GS_CLANG_MINREQ
GS_DEPRECATED_FUNC
GS_EXPOSE
GS_GCC_MINREQ
GS_NORETURN_METHOD
GS_UNIMPLEMENTED
GS_UNUSED_ARG
GS_UNUSED_FUNC
GS_UNUSED_IVAR
MAC_OS_X_VERSION_MAX_ALLOWED
NSAssert
NSAssert1
NSAssert2
NSAssert3
NSAssert4
NSAssert5
NSCAssert
NSCAssert1
NSCAssert2
NSCAssert3
NSCAssert4
NSCAssert5
NSCParameterAssert
NSDecimalMaxDigit
NSDecimalMaxSize
NSDecimalNoScale
NSLocalizedString
NSLocalizedStringFromTable
NSLocalizedStringFromTableInBundle
NSParameterAssert
NS_AVAILABLE
NS_AVAILABLE_MAC
NS_CLASS_AVAILABLE
NS_CLASS_AVAILABLE_MAC
NS_CLASS_DEPRECATED
NS_CLASS_DEPRECATED_MAC
NS_CONSUMED
NS_CONSUMES_SELF
NS_DEPRECATED
NS_DEPRECATED_MAC
NS_DESIGNATED_INITIALIZER
NS_ENUM_AVAILABLE
NS_ENUM_AVAILABLE_MAC
NS_ENUM_DEPRECATED
NS_ENUM_DEPRECATED_MAC
NS_INVOCATION
NS_MESSAGE
NS_RETURNS_NOT_RETAINED
NS_RETURNS_RETAINED
NS_ROOT_CLASS
NS_UNAVAILABLE
OS_API_VERSION
__has_feature

### Types

GSDebugAllocationTraceFunction
GSFileWrapperType
GSRegexEnumerationCallback
NSActivityOptions
NSAlignmentOptions
NSAttributedStringKey
NSBackgroundActivityResult
NSBinarySearchingOptions
NSByteCountFormatterCountStyle
NSByteCountFormatterUnits
NSByteOrder
NSCalculationError
NSCalendarOptions
NSCalendarUnit
NSComparisonPredicateModifier
NSComparisonPredicateOptions
NSComparisonResult
NSCompoundPredicateType
NSDataBase64DecodingOptions
NSDataBase64EncodingOptions
NSDataSearchOptions
NSDateComponentsFormatterUnitsStyle
NSDateComponentsFormatterZeroFormattingBehavior
NSDateFormatterBehavior
NSDateFormatterStyle
NSDateIntervalFormatterStyle
NSDirectoryEnumerationOptions
NSEnergyFormatterUnit
NSEnumerationOptions
NSErrorDomain
NSExceptionName
NSExpressionType
NSFileCoordinatorReadingOptions
NSFileCoordinatorWritingOptions
NSFileVersionAddingOptions
NSFileVersionReplacingOptions
NSFileWrapperReadingOptions
NSFileWrapperWritingOptions
NSFormattingContext
NSFormattingUnitStyle
NSHTTPCookieAcceptPolicy
NSHashTableOptions
NSISO8601DateFormatOptions
NSInteger
NSItemProviderErrorCode
NSItemProviderFileOptions
NSItemProviderRepresentationVisibility
NSJSONReadingOptions
NSJSONWritingOptions
NSKeyValueChange
NSKeyValueChangeKey
NSKeyValueObservingOptions
NSKeyValueSetMutationKind
NSLengthFormatterUnit
NSLinguisticTag
NSLinguisticTagScheme
NSLinguisticTaggerOptions
NSLinguisticTaggerUnit
NSLocaleLanguageDirection
NSMapTableOptions
NSMapTableValueCallBacks
NSMassFormatterUnit
NSMatchingFlags
NSMatchingOptions
NSMeasurementFormatterUnitOptions
NSNetServiceOptions
NSNetServicesError
NSNotificationCoalescing
NSNotificationName
NSNotificationSuspensionBehavior
NSNumberFormatterBehavior
NSNumberFormatterPadPosition
NSNumberFormatterRoundingMode
NSNumberFormatterStyle
NSOperationQueuePriority
NSPersonNameComponentsFormatterOptions
NSPersonNameComponentsFormatterStyle
NSPoint
NSPointArray
NSPointPointer
NSPointerFunctionsOptions
NSPostingStyle
NSPredicateOperatorType
NSProgressFileOperationKind
NSProgressKind
NSProgressUserInfoKey
NSPropertyListFormat
NSPropertyListMutabilityOptions
NSPropertyListReadOptions
NSPropertyListWriteOptions
NSQualityOfService
NSRange
NSRangePointer
NSRect
NSRectArray
NSRectEdge
NSRectPointer
NSRegularExpressionOptions
NSRoundingMode
NSRunLoopMode
NSSearchPathDirectory
NSSearchPathDomainMask
NSSize
NSSizeArray
NSSizePointer
NSSocketNativeHandle
NSSortOptions
NSStreamEvent
NSStreamStatus
NSStringCompareOptions
NSStringEncoding
NSStringEncodingConversionOptions
NSStringEnumerationOptions
NSSwappedDouble
NSSwappedFloat
NSTaskTerminationReason
NSTextCheckingType
NSTextCheckingTypes
NSTimeInterval
NSTimeZoneNameStyle
NSUInteger
NSURLBookmarkResolutionOptions
NSURLCacheStoragePolicy
NSURLCredentialPersistence
NSURLHandleStatus
NSURLRequestCachePolicy
NSURLRequestNetworkServiceType
NSURLSessionAuthChallengeDisposition
NSURLSessionResponseDisposition
NSURLSessionTaskState
NSUserNotificationActivationType
NSXMLDTDNodeKind
NSXMLDocumentContentKind
NSXMLNodeKind
NSXMLParserError
NSXPCConnectionOptions
NSZone
OSType
RunLoopEventType
_NSObjCValueType
gid_t
gsuuid_t
pid_t
struct NSEdgeInsets
struct _NSHandler
struct _NSHashTableCallBacks
struct _NSMapTableKeyCallBacks
struct autorelease_array_list
struct autorelease_thread_vars
uid_t
unichar

### Variables

NSCocoaErrorDomain
NSDeallocateZombies
NSDebugEnabled
NSDefaultRunLoopMode
NSLinguisticTagAdjective
NSLinguisticTagAdverb
NSLinguisticTagClassifier
NSLinguisticTagCloseParenthesis
NSLinguisticTagCloseQuote
NSLinguisticTagConjunction
NSLinguisticTagDash
NSLinguisticTagDeterminer
NSLinguisticTagIdiom
NSLinguisticTagInterjection
NSLinguisticTagNoun
NSLinguisticTagNumber
NSLinguisticTagOpenParenthesis
NSLinguisticTagOpenQuote
NSLinguisticTagOrganizationName
NSLinguisticTagOther
NSLinguisticTagOtherPunctuation
NSLinguisticTagOtherWhitespace
NSLinguisticTagOtherWord
NSLinguisticTagParagraphBreak
NSLinguisticTagParticle
NSLinguisticTagPersonalName
NSLinguisticTagPlaceName
NSLinguisticTagPreposition
NSLinguisticTagPronoun
NSLinguisticTagPunctuation
NSLinguisticTagSchemeLanguage
NSLinguisticTagSchemeLemma
NSLinguisticTagSchemeLexicalClass
NSLinguisticTagSchemeNameType
NSLinguisticTagSchemeNameTypeOrLexicalClass
NSLinguisticTagSchemeScript
NSLinguisticTagSchemeTokenType
NSLinguisticTagSentenceTerminator
NSLinguisticTagVerb
NSLinguisticTagWhitespace
NSLinguisticTagWord
NSLinguisticTagWordJoiner
NSMACHErrorDomain
NSOSStatusErrorDomain
NSPOSIXErrorDomain
NSRunLoopCommonModes
NSZombieEnabled
_NSConstantStringClassReference
_NSLock_error_handler
_NSLogDescriptor
_NSLog_printf_handler
enum _NSDirectoryEnumerationOptions
struct NSZoneStats
struct _NSMapTableValueCallBacks
struct _NSNotificationQueueList
struct _NSRange

Up

# NSFileManager class reference

### Authors

Mircea Oancea (`mircea@jupiter.elcom.pub.ro`)
Ovidiu Predescu (`ovidiu@net-community.com`)
Nicola Pero (`n.pero@mi.flashnet.it`)
Richard Frith-Macdonald (`rfm@gnu.org`)

Date: Generated at 2025-09-10 09:16:48 +0000

Copyright: (C) 1997,1999-2005 Free Software Foundation, Inc.

### Contents -

1. File management
2. Path handling
3. unix
   1. windows
   2. gnustep
   3. Portability
   4. Tilde substitution

- Software documentation for the NSDirectoryEnumerator class
- Software documentation for the NSFileManager class
- Software documentation for the NSDictionary(NSFileAttributes) category
- Software documentation for the NSObject(NSFileManagerDelegate) informal protocol
- Software documentation for the NSObject(NSFileManagerHandler) informal protocol
- Software documentation for the NSFileManagerDelegate protocol

# File management

## Path handling

The rules for path handling depend on the value in the `GNUSTEP_PATH_HANDLING` environment variable and, to some extent, on the platform on which the program is running.
The understood values of GNUSTEP_PATH_HANDLING are unix and windows. If GNUSTEP_PATH_HANDLING is any other value (or has not been set), GNUstep interprets this as meaning it should try to do-the-right-thing
In the default mode of operation the system is very tolerant of paths and allows you to work with both unix and windows style paths. The consequences of this are apparent in the path handling methods of NSString rather than in NSFileManager .

### unix

On all Unix platforms, Path components are separated by slashes and file names may contain any character other than slash.
The file names. and.. are special cases meaning current directory and the parent of the current directory respectively.
Multiple adjacent slash characters are treated as a single separator.

/
  An absolute path to the root directory.
/etc/motd
  An absolute path to the file named motd in the subdirectory etc of the root directory.
..
  A relative path to the parent of the current directory.
program.m
  A relative path to the file program.m in the current directory.
Source/program.m
  A relative path to the file program.m in the subdirectory Source of the current directory.
../GNUmakefile
  A relative path to the file GNUmakefile in the directory above the current directory.

### windows

On Microsoft Windows the native paths may be either UNC or drive-relative, so GNUstep supports both.
Either or both slash (/) and backslash (\) may be used as separators for path components in either type of name.
UNC paths follow the general form //host/share/path/file, but must at least contain the host and share parts, i.e. //host/share is a UNC path, but //host is not
Drive-relative names consist of an optional drive specifier (consisting of a single letter followed by a single colon) followed by an absolute or relative path.
In both forms, the names. and.. are refer to the current directory and the parent directory as in unix paths.

//host/share/file
  An absolute UNC path to a file called file in the top directory of the export point share on host.
C:
  A relative path to the current directory on drive C.
C:program.m
  A relative path to the file program.m on drive C.
C:\program.m
  An absolute path to the file program.m in the top level directory on drive C.
/Source\program.m
  A drive-relative path to program.m in the directory Source on the current drive.
\\name
  A drive-relative path to name in the top level directory on the current drive. The '\\' is treated as a single backslash as this is not a UNC name (there must be both a host and a share part in a UNC name).

### gnustep

In the default mode, GNUstep handles both unix and windows paths so it treats both slash (/) and backslash (\) as separators and understands the windows UNC and drive relative path roots.
However, it treats any path beginning with a slash (/) as an absolute path if running on a unix system.

### Portability

Attempting to pass absolute paths between applications working on different systems is fraught with difficulty... just don't do it.
Where paths need to be passed around (eg. in property lists or archives) you should pass relative paths and use a standard mechanism to construct an absolute path in the receiving application, for instance, appending the relative path to the home directory of a user.

- Use only the slash (/) as a path separator, not backslash (\).
- Never use a backslash (\) in a file name.
- Avoid colons in file names.
- Use no more than three letters in a path extension.

### Tilde substitution

GNUstep handles substitution of tilde (~) as follows:
If a path is just ~ or begins ~/ then the value returned by NSHomeDirectory() is substituted for the tilde.
If a path is of the form ~name or begins with a string like ~name/ then name is used as the argument to NSHomeDirectoryForUser() and the return value from that method (if non-nil) is used to replace the tilde.

# Software documentation for the NSDirectoryEnumerator class

## NSDirectoryEnumerator : NSEnumerator

> Declared in:
>   Foundation/NSFileManager.h

Availability: MacOS-X 10.0.0

This is a subclass of `NSEnumerator` which provides a full listing of all the files beneath a directory and its subdirectories. Instances can be obtained through [NSFileManager -enumeratorAtPath:] .

This implementation is optimized and performance should be comparable to the speed of standard Unix tools for large directories.

The order in which directory contents are enumerated is undefined, and in the current implementation the natural order of the underlying filesystem is used.

### Method summary

- -directoryAttributes
- -fileAttributes
- -skipDescendents

### directoryAttributes

- (NSDictionary*) directoryAttributes;
Availability: MacOS-X 10.0.0
Returns a dictionary containing the attributes of the directory at which enumeration started.
The contents of this dictionary are as produced by [NSFileManager -fileAttributesAtPath:traverseLink:]

### fileAttributes

- (NSDictionary*) fileAttributes;
Availability: MacOS-X 10.0.0
Returns a dictionary containing the attributes of the file currently being enumerated.
The contents of this dictionary are as produced by [NSFileManager -fileAttributesAtPath:traverseLink:]

### skipDescendents

- (void) skipDescendents;
Availability: MacOS-X 10.0.0
Informs the receiver that any descendents of the current directory should be skipped rather than enumerated. Use this to avoid enumerating the contents of directories you are not interested in.

# Software documentation for the NSFileManager class

## NSFileManager : NSObject

> Declared in:
>   Foundation/NSFileManager.h

Availability: MacOS-X 10.0.0
This is the main class for platform-independent management of the local filesystem, which allows you to read and save files, create/list directories, and move or delete files and directories. In addition to simply listing directories, you may obtain an NSDirectoryEnumerator instance for recursive directory contents enumeration.

### Method summary

- +defaultManager
- -URLForDirectory:inDomain:appropriateForURL:create:error:
- -URLsForDirectory:inDomains:
- -attributesOfFileSystemForPath:error:
- -attributesOfItemAtPath:error:
- -changeCurrentDirectoryPath:
- -changeFileAttributes:atPath:
- -componentsToDisplayForPath:
- -contentsAtPath:
- -contentsEqualAtPath:andPath:
- -contentsOfDirectoryAtPath:error:
- -contentsOfDirectoryAtURL:includingPropertiesForKeys:options:error:
- -copyItemAtPath:toPath:error:
- -copyItemAtURL:toURL:error:
- -copyPath:toPath:handler:
- -createDirectoryAtPath:attributes:
- -createDirectoryAtPath:withIntermediateDirectories:attributes:error:
- -createDirectoryAtURL:withIntermediateDirectories:attributes:error:
- -createFileAtPath:contents:attributes:
- -createSymbolicLinkAtPath:pathContent:
- -createSymbolicLinkAtPath:withDestinationPath:error:
- -currentDirectoryPath
- -delegate
- -directoryContentsAtPath:
- -displayNameAtPath:
- -enumeratorAtPath:
- -enumeratorAtURL:includingPropertiesForKeys:options:errorHandler:
- -fileAttributesAtPath:traverseLink:
- -fileExistsAtPath:
- -fileExistsAtPath:isDirectory:
- -fileSystemAttributesAtPath:
- -fileSystemRepresentationWithPath:
- -isDeletableFileAtPath:
- -isExecutableFileAtPath:
- -isReadableFileAtPath:
- -isWritableFileAtPath:
- -linkPath:toPath:handler:
- -moveItemAtPath:toPath:error:
- -moveItemAtURL:toURL:error:
- -movePath:toPath:handler:
- -pathContentOfSymbolicLinkAtPath:
- -removeFileAtPath:handler:
- -removeItemAtPath:error:
- -removeItemAtURL:error:
- -setAttributes:ofItemAtPath:error:
- -setDelegate:
- -stringWithFileSystemRepresentation:length:
- -subpathsAtPath:

### defaultManager

+ (NSFileManager*) defaultManager;
Availability: MacOS-X 10.0.0
Returns a shared default file manager which may be used throughout an application.

### URLForDirectory: inDomain: appropriateForURL: create: error:

- (NSURL*) URLForDirectory: (NSSearchPathDirectory)directory inDomain: (NSSearchPathDomainMask)domain appropriateForURL: (NSURL*)url create: (BOOL)shouldCreate error: (NSError**)error;
Availability: MacOS-X 10.6.0
Locates and, optionally, creates the specified common directory in domain

### URLsForDirectory: inDomains:

- (NSArray*) URLsForDirectory: (NSSearchPathDirectory)directory inDomains: (NSSearchPathDomainMask)domain;
Availability: MacOS-X 10.6.0
Returns an array of search paths to look at for resources.
The paths are returned in domain order: USER, LOCAL, NETWORK then SYSTEM.
The presence of a path in this list does not mean that the path actually exists in the filesystem.
If you are wanting to locate an existing resource, you should normally call this method with NSAllDomainsMask, but if you wish to find the path in which you should create a new file, you would generally specify a particular domain, and then create the path in the file system if it does not already exist.

### attributesOfFileSystemForPath: error:

- (NSDictionary*) attributesOfFileSystemForPath: (NSString*)path error: (NSError**)error;
Availability: MacOS-X 10.5.0
Description forthcoming.

### attributesOfItemAtPath: error:

- (NSDictionary*) attributesOfItemAtPath: (NSString*)path error: (NSError**)error;
Availability: MacOS-X 10.5.0
If a file (or directory etc) exists at the specified path, and can be queried for its attributes, this method returns a dictionary containing the various attributes of that file. Otherwise `nil` is returned.
If an error occurs, error describes the problem. Pass NULL if you do not want error information.

The dictionary keys for attributes are -

`NSFileAppendOnly`
  NSNumber... boolean
`NSFileCreationDate`
  NSDate when the file was created (if supported)
`NSFileDeviceIdentifier`
  NSNumber (identifies the device on which the file is stored)
`NSFileExtensionHidden`
  NSNumber... boolean
`NSFileGroupOwnerAccountName`
  NSString name of the file group
`NSFileGroupOwnerAccountID`
  NSNumber ID of the file group
`NSFileHFSCreatorCode`
  NSNumber not used
`NSFileHFSTypeCode`
  NSNumber not used
`NSFileImmutable`
  NSNumber... boolean
`NSFileModificationDate`
  NSDate when the file was last modified
`NSFileOwnerAccountName`
  NSString name of the file owner
`NSFileOwnerAccountID`
  NSNumber ID of the file owner
`NSFilePosixPermissions`
  NSNumber posix access permissions mask
`NSFileReferenceCount`
  NSNumber number of links to this file
`NSFileSize`
  NSNumber size of the file in bytes
`NSFileSystemFileNumber`
  NSNumber the identifier for the file on the filesystem
`NSFileSystemNumber`
  NSNumber the filesystem on which the file is stored
`NSFileType`
  NSString the type of file

The NSDictionary class also has a set of convenience accessor methods which enable you to get at file attribute information more efficiently than using the keys above to extract it. You should generally use the accessor methods where they are available.

- [NSDictionary(NSFileAttributes) -fileCreationDate]
- [NSDictionary(NSFileAttributes) -fileExtensionHidden]
- [NSDictionary(NSFileAttributes) -fileHFSCreatorCode]
- [NSDictionary(NSFileAttributes) -fileHFSTypeCode]
- [NSDictionary(NSFileAttributes) -fileIsAppendOnly]
- [NSDictionary(NSFileAttributes) -fileIsImmutable]
- [NSDictionary(NSFileAttributes) -fileSize]
- [NSDictionary(NSFileAttributes) -fileType]
- [NSDictionary(NSFileAttributes) -fileOwnerAccountName]
- [NSDictionary(NSFileAttributes) -fileOwnerAccountID]
- [NSDictionary(NSFileAttributes) -fileGroupOwnerAccountName]
- [NSDictionary(NSFileAttributes) -fileGroupOwnerAccountID]
- [NSDictionary(NSFileAttributes) -fileModificationDate]
- [NSDictionary(NSFileAttributes) -filePosixPermissions]
- [NSDictionary(NSFileAttributes) -fileSystemNumber]
- [NSDictionary(NSFileAttributes) -fileSystemFileNumber]

### changeCurrentDirectoryPath:

- (BOOL) changeCurrentDirectoryPath: (NSString*)path;
Availability: MacOS-X 10.0.0
Changes the current directory used for all subsequent operations.
All non-absolute paths are interpreted relative to this directory.
The current directory is set on a per-task basis, so the current directory for other file manager instances will also be changed by this method.

### changeFileAttributes: atPath:

- (BOOL) changeFileAttributes: (NSDictionary*)attributes atPath: (NSString*)path;
Availability: MacOS-X 10.0.0
Change the attributes of the file at path to those specified.
Returns `YES` if all requested changes were made (or if the dictionary was `nil` or empty, so no changes were requested), `NO` otherwise.
On failure, some of the requested changes may have taken place.

### componentsToDisplayForPath:

- (NSArray*) componentsToDisplayForPath: (NSString*)path;
Availability: MacOS-X 10.0.0
Returns an array of path components suitably modified for display to the end user. This modification may render the returned strings unusable for path manipulation, so you should work with two arrays... one returned by this method (for display to the user), and a parallel one returned by [NSString -pathComponents] (for path manipulation).

### contentsAtPath:

- (NSData*) contentsAtPath: (NSString*)path;
Availability: MacOS-X 10.0.0
Reads the file at path an returns its contents as an NSData object.
If an error occurs or if path specifies a directory etc then `nil` is returned.

### contentsEqualAtPath: andPath:

- (BOOL) contentsEqualAtPath: (NSString*)path1 andPath: (NSString*)path2;
Availability: MacOS-X 10.0.0
Returns `YES` if the contents of the file or directory at path1 are the same as those at path2.
If path1 and path2 are files, this is a simple comparison. If they are directories, the contents of the files in those subdirectories are compared recursively.
Symbolic links are not followed.
A comparison checks first file identity, then size, then content.

### contentsOfDirectoryAtPath: error:

- (NSArray*) contentsOfDirectoryAtPath: (NSString*)path error: (NSError**)error;
Availability: MacOS-X 10.5.0
Returns an array of NSStrings of the contents of the specified directory.
The listing does not recursively list subdirectories.
The special files '.' and '..' are not listed.
Indicates an error by returning `nil` (eg. if path is not a directory or it can't be read for some reason).

### contentsOfDirectoryAtURL: includingPropertiesForKeys: options: error:

- (NSArray*) contentsOfDirectoryAtURL: (NSURL*)url includingPropertiesForKeys: (NSArray*)keys options: (NSDirectoryEnumerationOptions)mask error: (NSError**)error;
Availability: MacOS-X 10.6.0
Returns an array of NSURL of the contents of the specified directory.
The listing is shallow and does not recurse into subdirectories. The special files '.' and '..' are excluded but it can return hidden files.
The only mask option supported is NSDirectoryEnumerationSkipsHiddenFiles.
The current implementation handles only files and property keys are ignored.

### copyItemAtPath: toPath: error:

- (BOOL) copyItemAtPath: (NSString*)src toPath: (NSString*)dst error: (NSError**)error;
Availability: MacOS-X 10.5.0
Copies the item specified by the src path to the location specified by the dst path. If the src is a directory, it is copied recursively with all of its contents.
Errors are returned in the error variable. Returns `YES` on success, `NO` otherwise.

### copyItemAtURL: toURL: error:

- (BOOL) copyItemAtURL: (NSURL*)src toURL: (NSURL*)dst error: (NSError**)error;
Availability: MacOS-X 10.5.0
Copies the a file or directory specified by the src URL to the location specified by the dst URL. If the src is a directory, it is copied recursively with all of its contents.
Errors are returned in the error variable. Returns `YES` on success, `NO` otherwise.

### copyPath: toPath: handler:

- (BOOL) copyPath: (NSString*)source toPath: (NSString*)destination handler: (id)handler;
Availability: MacOS-X 10.0.0
Copies the file or directory at source to destination, using a handler object which may respond to [NSObject(NSFileManagerHandler) -fileManager:willProcessPath:] and [NSObject(NSFileManagerHandler) -fileManager:shouldProceedAfterError:] messages.
If the handler responds to the first message, it is used to inform the handler when an item is about to be copied. If the handler responds to the second message, it is used to ask the handler whether to continue with the copy after an error (when there is no handler the processing stops at the point when an error occurs).
Symbolic links are copied themselved rather than causing the items they link to be copied.
Will not copy to a destination which already exists.

### createDirectoryAtPath: attributes:

- (BOOL) createDirectoryAtPath: (NSString*)path attributes: (NSDictionary*)attributes;
Availability: MacOS-X 10.0.0
Creates a new directory, and sets its attributes as specified.
Fails if directories in the path are missing.
Returns `YES` if the directory was actually created, `NO` otherwise.

### createDirectoryAtPath: withIntermediateDirectories: attributes: error:

- (BOOL) createDirectoryAtPath: (NSString*)path withIntermediateDirectories: (BOOL)flag attributes: (NSDictionary*)attributes error: (NSError**)error;
Availability: MacOS-X 10.0.0
Creates a new directory (and all intermediate directories if flag is `YES`). Creates only the last directory in the path if flag is `NO`.
The directory is created with the attributes specified, and any problem is returned in error.
Returns `YES` if the directory is created (or flag is `YES` and the directory already exists), `NO` on failure.

### createDirectoryAtURL: withIntermediateDirectories: attributes: error:

- (BOOL) createDirectoryAtURL: (NSURL*)url withIntermediateDirectories: (BOOL)flag attributes: (NSDictionary*)attributes error: (NSError**)error;
Availability: MacOS-X 10.0.0
Creates a new directory and all intermediate directories in the file URL if flag is `YES`.
Creates only the last directory in the URL if flag is `NO`.
The directory is created with the attributes specified and any problem is returned in error.
Returns `YES` if the directory is created (or flag is `YES` and the directory already exists), `NO` on failure.

### createFileAtPath: contents: attributes:

- (BOOL) createFileAtPath: (NSString*)path contents: (NSData*)contents attributes: (NSDictionary*)attributes;
Availability: MacOS-X 10.0.0
Creates a new file, and sets its attributes as specified.
Initialises the file content with the specified data.
Returns `YES` on success, `NO` on failure.

### createSymbolicLinkAtPath: pathContent:

- (BOOL) createSymbolicLinkAtPath: (NSString*)path pathContent: (NSString*)otherPath;
Availability: MacOS-X 10.0.0
Creates a symbolic link at path which links to the location specified by otherPath.

### createSymbolicLinkAtPath: withDestinationPath: error:

- (BOOL) createSymbolicLinkAtPath: (NSString*)path withDestinationPath: (NSString*)destPath error: (NSError**)error;
Availability: MacOS-X 10.5.0
Creates a symbolic link at the path that point to the destination path.
Returns `YES` on success, otherwise `NO`.

### currentDirectoryPath

- (NSString*) currentDirectoryPath;
Availability: MacOS-X 10.0.0
Returns the current working directory used by all instance of the file manager in the current task.

### delegate

- (id<NSFileManagerDelegate>) delegate;
Availability: MacOS-X 10.5.0
Description forthcoming.

### directoryContentsAtPath:

- (NSArray*) directoryContentsAtPath: (NSString*)path;
Availability: MacOS-X 10.0.0
Returns an array of the contents of the specified directory.
The listing does not recursively list subdirectories.
The special files '.' and '..' are not listed.
Indicates an error by returning `nil` (eg. if path is not a directory or it can't be read for some reason).

### displayNameAtPath:

- (NSString*) displayNameAtPath: (NSString*)path;
Availability: MacOS-X 10.0.0
Returns the name of the file or directory at path. Converts it into a format for display to an end user. This may render it unusable as part of a file/path name.
For instance, if a user has elected not to see file extensions, this method may return filenames with the extension removed.
The default operation is to return the result of calling [NSString -lastPathComponent] on the path.

### enumeratorAtPath:

- (NSDirectoryEnumerator*) enumeratorAtPath: (NSString*)path;
Availability: MacOS-X 10.0.0

Returns an enumerator which can be used to return each item with the directory at path in turn.

The enumeration is recursive... following all nested subdirectories.

The order in which directory contents are enumerated is undefined, and in the current implementation the natural order of the underlying filesystem is used.

### enumeratorAtURL: includingPropertiesForKeys: options: errorHandler:

- (NSDirectoryEnumerator*) enumeratorAtURL: (NSURL*)url includingPropertiesForKeys: (NSArray*)keys options: (NSDirectoryEnumerationOptions)mask errorHandler: (GSDirEnumErrorHandler)handler;
Availability: MacOS-X 10.6.0
Enumerate over the contents of a directory.

### fileAttributesAtPath: traverseLink:

- (NSDictionary*) fileAttributesAtPath: (NSString*)path traverseLink: (BOOL)flag;
Availability: MacOS-X 10.0.0
Returns the attributes dictionary for the file at the specified path. If that file is a symbolic link, the flag determines whether the attributes returned are those of the link or those of the destination file.
If a file (or directory etc) exists at the specified path, and can be queried for its attributes, this method returns a dictionary containing the various attributes of that file. Otherwise `nil` is returned.
If the flag is `NO` and the file is a symbolic link, the attributes of the link itself (rather than the file it points to) are returned.

The dictionary keys for attributes are -

`NSFileAppendOnly`
  NSNumber... boolean
`NSFileCreationDate`
  NSDate when the file was created (if supported)
`NSFileDeviceIdentifier`
  NSNumber (identifies the device on which the file is stored)
`NSFileExtensionHidden`
  NSNumber... boolean
`NSFileGroupOwnerAccountName`
  NSString name of the file group
`NSFileGroupOwnerAccountID`
  NSNumber ID of the file group
`NSFileHFSCreatorCode`
  NSNumber not used
`NSFileHFSTypeCode`
  NSNumber not used
`NSFileImmutable`
  NSNumber... boolean
`NSFileModificationDate`
  NSDate when the file was last modified
`NSFileOwnerAccountName`
  NSString name of the file owner
`NSFileOwnerAccountID`
  NSNumber ID of the file owner
`NSFilePosixPermissions`
  NSNumber posix access permissions mask
`NSFileReferenceCount`
  NSNumber number of links to this file
`NSFileSize`
  NSNumber size of the file in bytes
`NSFileSystemFileNumber`
  NSNumber the identifier for the file on the filesystem
`NSFileSystemNumber`
  NSNumber the filesystem on which the file is stored
`NSFileType`
  NSString the type of file

The NSDictionary class also has a set of convenience accessor methods which enable you to get at file attribute information more efficiently than using the keys above to extract it. You should generally use the accessor methods where they are available.

- [NSDictionary(NSFileAttributes) -fileCreationDate]
- [NSDictionary(NSFileAttributes) -fileExtensionHidden]
- [NSDictionary(NSFileAttributes) -fileHFSCreatorCode]
- [NSDictionary(NSFileAttributes) -fileHFSTypeCode]
- [NSDictionary(NSFileAttributes) -fileIsAppendOnly]
- [NSDictionary(NSFileAttributes) -fileIsImmutable]
- [NSDictionary(NSFileAttributes) -fileSize]
- [NSDictionary(NSFileAttributes) -fileType]
- [NSDictionary(NSFileAttributes) -fileOwnerAccountName]
- [NSDictionary(NSFileAttributes) -fileOwnerAccountID]
- [NSDictionary(NSFileAttributes) -fileGroupOwnerAccountName]
- [NSDictionary(NSFileAttributes) -fileGroupOwnerAccountID]
- [NSDictionary(NSFileAttributes) -fileModificationDate]
- [NSDictionary(NSFileAttributes) -filePosixPermissions]
- [NSDictionary(NSFileAttributes) -fileSystemNumber]
- [NSDictionary(NSFileAttributes) -fileSystemFileNumber]

### fileExistsAtPath:

- (BOOL) fileExistsAtPath: (NSString*)path;
Availability: MacOS-X 10.0.0
Returns `YES` if a file (or directory etc) exists at the specified path.

### fileExistsAtPath: isDirectory:

- (BOOL) fileExistsAtPath: (NSString*)path isDirectory: (BOOL*)isDirectory;
Availability: MacOS-X 10.0.0
Returns `YES` if a file (or directory etc) exists at the specified path.
If the isDirectory argument is not a nul pointer, stores a flag in the location it points to, indicating whether the file is a directory or not.

### fileSystemAttributesAtPath:

- (NSDictionary*) fileSystemAttributesAtPath: (NSString*)path;
Availability: MacOS-X 10.0.0
Returns a dictionary containing the filesystem attributes for the specified path (or `nil` if the path is not valid).

`NSFileSystemSize`
  NSNumber the size of the filesystem in bytes
`NSFileSystemFreeSize`
  NSNumber the amount of unused space on the filesystem in bytes
`NSFileSystemNodes`
  NSNumber the number of nodes in use to store files
`NSFileSystemFreeNodes`
  NSNumber the number of nodes available to create files
`NSFileSystemNumber`
  NSNumber the identifying number for the filesystem

### fileSystemRepresentationWithPath:

- (const GSNativeChar*) fileSystemRepresentationWithPath: (NSString*)path;
Availability: MacOS-X 10.0.0
Convert from OpenStep internal string format to a string in the local filesystem format, suitable for passing to system functions.
This representation may vary between filesystems.
Converts the standard path separator ('/') and path extension ('.') characters to the local representation if necessary.
On mingw32 systems, the filesystem representation is 16-bit unicode and is expected to be used in conjunction with the variants of system calls which work with unicode strings.
Raises an exception if the character conversion is not possible.

### isDeletableFileAtPath:

- (BOOL) isDeletableFileAtPath: (NSString*)path;
Availability: MacOS-X 10.0.0
Returns `YES` if a file (or directory etc) exists at the specified path and is deletable.

### isExecutableFileAtPath:

- (BOOL) isExecutableFileAtPath: (NSString*)path;
Availability: MacOS-X 10.0.0
Returns `YES` if a file (or directory etc) exists at the specified path and is executable (if a directory is executable, you can access its contents).

### isReadableFileAtPath:

- (BOOL) isReadableFileAtPath: (NSString*)path;
Availability: MacOS-X 10.0.0
Returns `YES` if a file (or directory etc) exists at the specified path and is readable.

### isWritableFileAtPath:

- (BOOL) isWritableFileAtPath: (NSString*)path;
Availability: MacOS-X 10.0.0
Returns `YES` if a file (or directory etc) exists at the specified path and is writable.

### linkPath: toPath: handler:

- (BOOL) linkPath: (NSString*)source toPath: (NSString*)destination handler: (id)handler;
Availability: MacOS-X 10.0.0

Links the file or directory at source to destination, using a handler object which should respond to [NSObject(NSFileManagerHandler) -fileManager:willProcessPath:] and [NSObject(NSFileManagerHandler) -fileManager:shouldProceedAfterError:] messages.

If the destination is a directory, the source path is linked into that directory, otherwise the destination must not exist, but its parent directory must exist and the source will be linked into the parent as the name specified by the destination.

If the source is a symbolic link, it is copied to the destination.
If the source is a directory, it is copied to the destination and its contents are linked into the new directory.
Otherwise, a hard link is made from the destination to the source.

### moveItemAtPath: toPath: error:

- (BOOL) moveItemAtPath: (NSString*)src toPath: (NSString*)dst error: (NSError**)error;
Availability: MacOS-X 10.5.0
Moves a file or directory specified by src to its destination specified by dst, errors are returned in error.
Returns `YES` on success, `NO` otherwise.

### moveItemAtURL: toURL: error:

- (BOOL) moveItemAtURL: (NSURL*)src toURL: (NSURL*)dst error: (NSError**)error;
Availability: MacOS-X 10.5.0
Moves a file or directory specified by src to its destination specified by dst, errors are returned in error.
Returns `YES` on success, `NO` otherwise.

### movePath: toPath: handler:

- (BOOL) movePath: (NSString*)source toPath: (NSString*)destination handler: (id)handler;
Availability: MacOS-X 10.0.0
Moves the file or directory at source to destination, using a handler object which should respond to [NSObject(NSFileManagerHandler) -fileManager:willProcessPath:] and [NSObject(NSFileManagerHandler) -fileManager:shouldProceedAfterError:] messages.
If the handler responds to the first message, it is used to inform the handler when an item is about to be moved. If the handler responds to the second message, it is used to ask the handler whether to continue with the move after an error (when there is no handler the processing stops at the point when an error occurs).
Will not move to a destination which already exists.

### pathContentOfSymbolicLinkAtPath:

- (NSString*) pathContentOfSymbolicLinkAtPath: (NSString*)path;
Availability: MacOS-X 10.0.0
Returns the name of the file or directory that the symbolic link at path points to.

### removeFileAtPath: handler:

- (BOOL) removeFileAtPath: (NSString*)path handler: (id)handler;
Availability: MacOS-X 10.0.0
Removes the file or directory at path, using a handler object which should respond to [NSObject(NSFileManagerHandler) -fileManager:willProcessPath:] and [NSObject(NSFileManagerHandler) -fileManager:shouldProceedAfterError:] messages.

### removeItemAtPath: error:

- (BOOL) removeItemAtPath: (NSString*)path error: (NSError**)error;
Availability: MacOS-X 10.5.0
Removes the file or directory specified by the path to be removed. If the path points to a directory, the directory is deleted recursively.
Returns `YES` on success, otherwise `NO`.

### removeItemAtURL: error:

- (BOOL) removeItemAtURL: (NSURL*)url error: (NSError**)error;
Availability: MacOS-X 10.5.0
Removes the file or directory specified by the url to be removed. If the url points to a directory, the directory is deleted recursively.
Returns `YES` on success, otherwise `NO`.

### setAttributes: ofItemAtPath: error:

- (BOOL) setAttributes: (NSDictionary*)attributes ofItemAtPath: (NSString*)path error: (NSError**)error;
Availability: MacOS-X 10.5.0
Description forthcoming.

### setDelegate:

- (void) setDelegate: (id<NSFileManagerDelegate>)delegate;
Availability: MacOS-X 10.5.0
Description forthcoming.

### stringWithFileSystemRepresentation: length:

- (NSString*) stringWithFileSystemRepresentation: (const GSNativeChar*)string length: (NSUInteger)len;
Availability: MacOS-X 10.0.0
Convert to OpenStep internal string format from a string in the local filesystem format, as returned by system functions.
This representation may vary between filesystems.
The GNUstep version of this method currently does not bother to change any path separator and extension characters to the standard values ('/' and '.' respectively) as the path handling methods of NSString should be able to handle native format strings.
On mingw32 systems, the filesystem representation is 16-bit unicode and is expected to have come from the variant of a system call which works with unicode strings.

### subpathsAtPath:

- (NSArray*) subpathsAtPath: (NSString*)path;
Availability: MacOS-X 10.0.0
Returns an array containing the (relative) paths of all the items in the directory at path.
The listing follows all subdirectories, so it can produce a very large array... use with care.

# Software documentation for the NSDictionary(NSFileAttributes) category

## NSDictionary(NSFileAttributes)

> Declared in:
>   Foundation/NSFileManager.h

Availability: MacOS-X 10.0.0
Convenience methods for accessing named file attributes in a dictionary.

### Method summary

- -fileCreationDate
- -fileExtensionHidden
- -fileGroupOwnerAccountID
- -fileGroupOwnerAccountName
- -fileHFSCreatorCode
- -fileHFSTypeCode
- -fileIsAppendOnly
- -fileIsImmutable
- -fileModificationDate
- -fileOwnerAccountID
- -fileOwnerAccountName
- -filePosixPermissions
- -fileSize
- -fileSystemFileNumber
- -fileSystemNumber
- -fileType

### fileCreationDate

- (NSDate*) fileCreationDate;
Availability: MacOS-X 10.0.0
Return the file creation date attribute (or `nil` if not found).

### fileExtensionHidden

- (BOOL) fileExtensionHidden;
Availability: MacOS-X 10.0.0
Return the file extension hidden attribute (or `NO` if not found).

### fileGroupOwnerAccountID

- (NSNumber*) fileGroupOwnerAccountID;
Availability: MacOS-X 10.0.0
Return an NSNumber with the numeric value of the NSFileGroupOwnerAccountID attribute in the dictionary, or `nil` if the attribute is not present.

### fileGroupOwnerAccountName

- (NSString*) fileGroupOwnerAccountName;
Availability: MacOS-X 10.0.0
Return the file group owner account name attribute or `nil` if not present.

### fileHFSCreatorCode

- (OSType) fileHFSCreatorCode;
Availability: MacOS-X 10.0.0
Returns HFS creator attribute (OS X).

### fileHFSTypeCode

- (OSType) fileHFSTypeCode;
Availability: MacOS-X 10.0.0
Returns HFS type code attribute (OS X).

### fileIsAppendOnly

- (BOOL) fileIsAppendOnly;
Availability: MacOS-X 10.0.0
Return the file append only attribute (or `NO` if not found).

### fileIsImmutable

- (BOOL) fileIsImmutable;
Availability: MacOS-X 10.0.0
Return the file immutable attribute (or `NO` if not found).

### fileModificationDate

- (NSDate*) fileModificationDate;
Availability: MacOS-X 10.0.0
Return the file modification date attribute (or `nil` if not found)

### fileOwnerAccountID

- (NSNumber*) fileOwnerAccountID;
Availability: MacOS-X 10.0.0
Return an NSNumber with the numeric value of the NSFileOwnerAccountID attribute in the dictionary, or `nil` if the attribute is not present.

### fileOwnerAccountName

- (NSString*) fileOwnerAccountName;
Availability: MacOS-X 10.0.0
Return the file owner account name attribute or `nil` if not present.

### filePosixPermissions

- (NSUInteger) filePosixPermissions;
Availability: MacOS-X 10.0.0
Return the file posix permissions attribute (or NSNotFound if the attribute is not present in the dictionary).

### fileSize

- (unsigned long long) fileSize;
Availability: MacOS-X 10.0.0
Return the size of the file, or NSNotFound if the file size attribute is not found in the dictionary.

### fileSystemFileNumber

- (NSUInteger) fileSystemFileNumber;
Availability: MacOS-X 10.0.0
Return the file system file identification number attribute or NSNotFound if the attribute is not present in the dictionary).

### fileSystemNumber

- (NSUInteger) fileSystemNumber;
Availability: MacOS-X 10.0.0
Return the file system number attribute (or NSNotFound if the attribute is not present in the dictionary).

### fileType

- (NSString*) fileType;
Availability: MacOS-X 10.0.0
Return the file type attribute or `nil` if not present.

# Software documentation for the NSObject(NSFileManagerDelegate) informal protocol

## NSObject(NSFileManagerDelegate)

> Declared in:
>   Foundation/NSFileManager.h

Availability: MacOS-X 10.5.0
Description forthcoming.

### Method summary

- -fileManager:shouldCopyItemAtPath:toPath:
- -fileManager:shouldCopyItemAtURL:toURL:
- -fileManager:shouldLinkItemAtPath:toPath:
- -fileManager:shouldLinkItemAtURL:toURL:
- -fileManager:shouldMoveItemAtPath:toPath:
- -fileManager:shouldMoveItemAtURL:toURL:
- -fileManager:shouldProceedAfterError:copyingItemAtPath:toPath:
- -fileManager:shouldProceedAfterError:copyingItemAtURL:toURL:
- -fileManager:shouldProceedAfterError:linkingItemAtPath:toPath:
- -fileManager:shouldProceedAfterError:linkingItemAtURL:toURL:
- -fileManager:shouldProceedAfterError:movingItemAtPath:toPath:
- -fileManager:shouldProceedAfterError:movingItemAtURL:toURL:
- -fileManager:shouldProceedAfterError:removingItemAtPath:
- -fileManager:shouldProceedAfterError:removingItemAtURL:
- -fileManager:shouldRemoveItemAtPath:
- -fileManager:shouldRemoveItemAtURL:

### fileManager: shouldCopyItemAtPath: toPath:

- (BOOL) fileManager: (NSFileManager*)fileManager shouldCopyItemAtPath: (NSString*)srcPath toPath: (NSString*)dstPath;
Availability: MacOS-X 10.5.0
Description forthcoming.

### fileManager: shouldCopyItemAtURL: toURL:

- (BOOL) fileManager: (NSFileManager*)fileManager shouldCopyItemAtURL: (NSURL*)srcURL toURL: (NSURL*)dstURL;
Availability: MacOS-X 10.5.0
Description forthcoming.

### fileManager: shouldLinkItemAtPath: toPath:

- (BOOL) fileManager: (NSFileManager*)fileManager shouldLinkItemAtPath: (NSString*)srcPath toPath: (NSString*)dstPath;
Availability: MacOS-X 10.5.0
Description forthcoming.

### fileManager: shouldLinkItemAtURL: toURL:

- (BOOL) fileManager: (NSFileManager*)fileManager shouldLinkItemAtURL: (NSURL*)srcURL toURL: (NSURL*)dstURL;
Availability: MacOS-X 10.5.0
Description forthcoming.

### fileManager: shouldMoveItemAtPath: toPath:

- (BOOL) fileManager: (NSFileManager*)fileManager shouldMoveItemAtPath: (NSString*)srcPath toPath: (NSString*)dstPath;
Availability: MacOS-X 10.5.0
Description forthcoming.

### fileManager: shouldMoveItemAtURL: toURL:

- (BOOL) fileManager: (NSFileManager*)fileManager shouldMoveItemAtURL: (NSURL*)srcURL toURL: (NSURL*)dstURL;
Availability: MacOS-X 10.5.0
Description forthcoming.

### fileManager: shouldProceedAfterError: copyingItemAtPath: toPath:

- (BOOL) fileManager: (NSFileManager*)fileManager shouldProceedAfterError: (NSError*)error copyingItemAtPath: (NSString*)srcPath toPath: (NSString*)dstPath;
Availability: MacOS-X 10.5.0
Description forthcoming.

### fileManager: shouldProceedAfterError: copyingItemAtURL: toURL:

- (BOOL) fileManager: (NSFileManager*)fileManager shouldProceedAfterError: (NSError*)error copyingItemAtURL: (NSURL*)srcURL toURL: (NSURL*)dstURL;
Availability: MacOS-X 10.5.0
Description forthcoming.

### fileManager: shouldProceedAfterError: linkingItemAtPath: toPath:

- (BOOL) fileManager: (NSFileManager*)fileManager shouldProceedAfterError: (NSError*)error linkingItemAtPath: (NSString*)srcPath toPath: (NSString*)dstPath;
Availability: MacOS-X 10.5.0
Description forthcoming.

### fileManager: shouldProceedAfterError: linkingItemAtURL: toURL:

- (BOOL) fileManager: (NSFileManager*)fileManager shouldProceedAfterError: (NSError*)error linkingItemAtURL: (NSURL*)srcURL toURL: (NSURL*)dstURL;
Availability: MacOS-X 10.5.0
Description forthcoming.

### fileManager: shouldProceedAfterError: movingItemAtPath: toPath:

- (BOOL) fileManager: (NSFileManager*)fileManager shouldProceedAfterError: (NSError*)error movingItemAtPath: (NSString*)srcPath toPath: (NSString*)dstPath;
Availability: MacOS-X 10.5.0
Description forthcoming.

### fileManager: shouldProceedAfterError: movingItemAtURL: toURL:

- (BOOL) fileManager: (NSFileManager*)fileManager shouldProceedAfterError: (NSError*)error movingItemAtURL: (NSURL*)srcURL toURL: (NSURL*)dstURL;
Availability: MacOS-X 10.5.0
Description forthcoming.

### fileManager: shouldProceedAfterError: removingItemAtPath:

- (BOOL) fileManager: (NSFileManager*)fileManager shouldProceedAfterError: (NSError*)error removingItemAtPath: (NSString*)path;
Availability: MacOS-X 10.5.0
Description forthcoming.

### fileManager: shouldProceedAfterError: removingItemAtURL:

- (BOOL) fileManager: (NSFileManager*)fileManager shouldProceedAfterError: (NSError*)error removingItemAtURL: (NSURL*)URL;
Availability: MacOS-X 10.5.0
Description forthcoming.

### fileManager: shouldRemoveItemAtPath:

- (BOOL) fileManager: (NSFileManager*)fileManager shouldRemoveItemAtPath: (NSString*)path;
Availability: MacOS-X 10.5.0
Description forthcoming.

### fileManager: shouldRemoveItemAtURL:

- (BOOL) fileManager: (NSFileManager*)fileManager shouldRemoveItemAtURL: (NSURL*)URL;
Availability: MacOS-X 10.5.0
Description forthcoming.

# Software documentation for the NSObject(NSFileManagerHandler) informal protocol

## NSObject(NSFileManagerHandler)

> Declared in:
>   Foundation/NSFileManager.h

Availability: MacOS-X 10.0.0
An informal protocol to which handler objects should conform if they wish to deal with copy and move operations performed by NSFileManager.

### Method summary

- -fileManager:shouldProceedAfterError:
- -fileManager:willProcessPath:

### fileManager: shouldProceedAfterError:

- (BOOL) fileManager: (NSFileManager*)fileManager shouldProceedAfterError: (NSDictionary*)errorDictionary;
Availability: MacOS-X 10.0.0

When an error occurs during a copy or move operation, the file manager will send this message to the handler, and will use the return value to determine whether the operation should proceed. If the method returns `YES` then the operation will proceed after the error, if it returns `NO` then it will be aborted.

If the handler does not implement this method it will be treated as if it returns `NO`.

The error dictionary contains the following

- "Error" contains a description of the error.
- "Path" contains the path that is being processed when an error occurred. If an error occurs during an operation involving two files, like copying, and it is not clear which file triggers the error it will default to the source file.
- "FromPath" (Optional) contains the path involved in reading.
- "ToPath" (Optional) contains the path involved in writing.

Note that the `FromPath` is a GNUstep extension.

Also the `FromPath` and `ToPath` are filled in when appropriate. So when copying a file they will typically both have a value and when reading only `FromPath`.

### fileManager: willProcessPath:

- (void) fileManager: (NSFileManager*)fileManager willProcessPath: (NSString*)path;
Availability: MacOS-X 10.0.0
The file manager sends this method to the handler immediately before performing part of a directory move or copy operation. This provides the handler object with information it can use in the event of an error, to decide whether processing should proceed after the error.

# Software documentation for the NSFileManagerDelegate protocol

## NSFileManagerDelegate

> Declared in:
>   Foundation/NSFileManager.h

> Conforms to:
>   NSObject

Availability: MacOS-X 10.5.0
Description forthcoming.
Up