mirror of
https://github.com/MacPaw/XADMaster.git
synced 2025-08-29 19:43:47 +02:00
186 lines
6.9 KiB
Objective-C
186 lines
6.9 KiB
Objective-C
/*
|
|
* XADPath.h
|
|
*
|
|
* Copyright (c) 2017-present, MacPaw Inc. All rights reserved.
|
|
*
|
|
* This library is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Lesser General Public
|
|
* License as published by the Free Software Foundation; either
|
|
* version 2.1 of the License, or (at your option) any later version.
|
|
*
|
|
* This library is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
* Lesser General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Lesser General Public
|
|
* License along with this library; if not, write to the Free Software
|
|
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
|
|
* MA 02110-1301 USA
|
|
*/
|
|
#import "XADString.h"
|
|
|
|
#define XADUnixPathSeparator "/"
|
|
#define XADWindowsPathSeparator "\\"
|
|
#define XADEitherPathSeparator "/\\"
|
|
#define XADNoPathSeparator ""
|
|
|
|
@interface XADPath:NSObject <XADString,NSCopying>
|
|
{
|
|
XADPath *parent;
|
|
|
|
NSArray *cachedcanonicalcomponents;
|
|
NSString *cachedencoding;
|
|
}
|
|
|
|
+(XADPath *)emptyPath;
|
|
+(XADPath *)pathWithString:(NSString *)string;
|
|
+(XADPath *)pathWithStringComponents:(NSArray *)components;
|
|
+(XADPath *)separatedPathWithString:(NSString *)string;
|
|
+(XADPath *)decodedPathWithData:(NSData *)bytedata encodingName:(NSString *)encoding separators:(const char *)separators;
|
|
+(XADPath *)analyzedPathWithData:(NSData *)bytedata source:(XADStringSource *)stringsource
|
|
separators:(const char *)pathseparators;
|
|
|
|
-(id)init;
|
|
-(id)initWithParent:(XADPath *)parentpath;
|
|
-(id)initWithPath:(XADPath *)path parent:(XADPath *)parentpath;
|
|
|
|
-(void)dealloc;
|
|
|
|
-(BOOL)isAbsolute;
|
|
-(BOOL)isEmpty;
|
|
-(BOOL)isEqual:(id)other;
|
|
-(BOOL)isCanonicallyEqual:(id)other;
|
|
-(BOOL)isCanonicallyEqual:(id)other encodingName:(NSString *)encoding;
|
|
-(BOOL)hasPrefix:(XADPath *)other;
|
|
-(BOOL)hasCanonicalPrefix:(XADPath *)other;
|
|
-(BOOL)hasCanonicalPrefix:(XADPath *)other encodingName:(NSString *)encoding;
|
|
|
|
-(int)depth; // Note: Does not take . or .. paths into account.
|
|
-(int)depthWithEncodingName:(NSString *)encoding;
|
|
-(NSArray *)pathComponents;
|
|
-(NSArray *)pathComponentsWithEncodingName:(NSString *)encoding;
|
|
-(NSArray *)canonicalPathComponents;
|
|
-(NSArray *)canonicalPathComponentsWithEncodingName:(NSString *)encoding;
|
|
-(void)_addPathComponentsToArray:(NSMutableArray *)components encodingName:(NSString *)encoding;
|
|
|
|
-(NSString *)lastPathComponent;
|
|
-(NSString *)lastPathComponentWithEncodingName:(NSString *)encoding;
|
|
-(NSString *)firstPathComponent;
|
|
-(NSString *)firstPathComponentWithEncodingName:(NSString *)encoding;
|
|
-(NSString *)firstCanonicalPathComponent;
|
|
-(NSString *)firstCanonicalPathComponentWithEncodingName:(NSString *)encoding;
|
|
|
|
-(XADPath *)pathByDeletingLastPathComponent;
|
|
-(XADPath *)pathByDeletingLastPathComponentWithEncodingName:(NSString *)encoding;
|
|
-(XADPath *)pathByDeletingFirstPathComponent;
|
|
-(XADPath *)pathByDeletingFirstPathComponentWithEncodingName:(NSString *)encoding;
|
|
|
|
-(XADPath *)pathByAppendingXADStringComponent:(XADString *)component;
|
|
-(XADPath *)pathByAppendingPath:(XADPath *)path;
|
|
-(XADPath *)_copyWithParent:(XADPath *)newparent;
|
|
|
|
// These are safe for filesystem use, and adapted to the current platform.
|
|
-(NSString *)sanitizedPathString;
|
|
-(NSString *)sanitizedPathStringWithEncodingName:(NSString *)encoding;
|
|
|
|
// XADString interface.
|
|
// NOTE: These are not guaranteed to be safe for usage as filesystem paths,
|
|
// only for display!
|
|
-(BOOL)canDecodeWithEncodingName:(NSString *)encoding;
|
|
-(NSString *)string;
|
|
-(NSString *)stringWithEncodingName:(NSString *)encoding;
|
|
-(NSData *)data;
|
|
-(void)_appendPathToData:(NSMutableData *)data;
|
|
|
|
-(BOOL)encodingIsKnown;
|
|
-(NSString *)encodingName;
|
|
-(float)confidence;
|
|
|
|
-(XADStringSource *)source;
|
|
|
|
#ifdef __APPLE__
|
|
-(BOOL)canDecodeWithEncoding:(NSStringEncoding)encoding;
|
|
-(NSString *)stringWithEncoding:(NSStringEncoding)encoding;
|
|
-(NSString *)sanitizedPathStringWithEncoding:(NSStringEncoding)encoding;
|
|
-(NSStringEncoding)encoding;
|
|
#endif
|
|
|
|
// Other interfaces.
|
|
-(NSUInteger)hash;
|
|
-(id)copyWithZone:(NSZone *)zone;
|
|
|
|
// Deprecated.
|
|
-(XADPath *)safePath; // Deprecated. Use sanitizedPathString: instead.
|
|
|
|
// Subclass methods.
|
|
-(BOOL)_isPartAbsolute;
|
|
-(BOOL)_isPartEmpty;
|
|
-(int)_depthOfPartWithEncodingName:(NSString *)encoding;
|
|
-(void)_addPathComponentsOfPartToArray:(NSMutableArray *)array encodingName:(NSString *)encoding;
|
|
-(NSString *)_lastPathComponentOfPartWithEncodingName:(NSString *)encoding;
|
|
-(NSString *)_firstPathComponentOfPartWithEncodingName:(NSString *)encoding;
|
|
-(XADPath *)_pathByDeletingLastPathComponentOfPartWithEncodingName:(NSString *)encoding;
|
|
-(XADPath *)_pathByDeletingFirstPathComponentOfPartWithEncodingName:(NSString *)encoding;
|
|
-(BOOL)_canDecodePartWithEncodingName:(NSString *)encoding;
|
|
-(void)_appendPathForPartToData:(NSMutableData *)data;
|
|
-(XADStringSource *)_sourceForPart;
|
|
|
|
@end
|
|
|
|
|
|
@interface XADStringPath:XADPath
|
|
{
|
|
NSString *string;
|
|
}
|
|
|
|
-(id)initWithComponentString:(NSString *)pathstring;
|
|
-(id)initWithComponentString:(NSString *)pathstring parent:(XADPath *)parentpath;
|
|
-(id)initWithPath:(XADStringPath *)path parent:(XADPath *)parentpath;
|
|
-(void)dealloc;
|
|
|
|
-(BOOL)_isPartAbsolute;
|
|
-(BOOL)_isPartEmpty;
|
|
-(int)_depthOfPartWithEncodingName:(NSString *)encoding;
|
|
-(void)_addPathComponentsOfPartToArray:(NSMutableArray *)array encodingName:(NSString *)encoding;
|
|
-(NSString *)_lastPathComponentOfPartWithEncodingName:(NSString *)encoding;
|
|
-(NSString *)_firstPathComponentOfPartWithEncodingName:(NSString *)encoding;
|
|
-(XADPath *)_pathByDeletingLastPathComponentOfPartWithEncodingName:(NSString *)encoding;
|
|
-(XADPath *)_pathByDeletingFirstPathComponentOfPartWithEncodingName:(NSString *)encoding;
|
|
-(BOOL)_canDecodePartWithEncodingName:(NSString *)encoding;
|
|
-(void)_appendPathForPartToData:(NSMutableData *)data;
|
|
-(XADStringSource *)_sourceForPart;
|
|
|
|
-(BOOL)isEqual:(id)other;
|
|
-(NSUInteger)hash;
|
|
|
|
@end
|
|
|
|
@interface XADRawPath:XADPath
|
|
{
|
|
NSData *data;
|
|
XADStringSource *source;
|
|
const char *separators;
|
|
}
|
|
|
|
-(id)initWithData:(NSData *)bytedata source:(XADStringSource *)stringsource
|
|
separators:(const char *)pathseparators;
|
|
-(id)initWithData:(NSData *)bytedata source:(XADStringSource *)stringsource
|
|
separators:(const char *)pathseparators parent:(XADPath *)parentpath;
|
|
-(id)initWithPath:(XADRawPath *)path parent:(XADPath *)parentpath;
|
|
-(void)dealloc;
|
|
|
|
-(BOOL)_isPartAbsolute;
|
|
-(BOOL)_isPartEmpty;
|
|
-(int)_depthOfPartWithEncodingName:(NSString *)encoding;
|
|
-(void)_addPathComponentsOfPartToArray:(NSMutableArray *)array encodingName:(NSString *)encoding;
|
|
-(NSString *)_lastPathComponentOfPartWithEncodingName:(NSString *)encoding;
|
|
-(NSString *)_firstPathComponentOfPartWithEncodingName:(NSString *)encoding;
|
|
-(XADPath *)_pathByDeletingLastPathComponentOfPartWithEncodingName:(NSString *)encoding;
|
|
-(XADPath *)_pathByDeletingFirstPathComponentOfPartWithEncodingName:(NSString *)encoding;
|
|
-(BOOL)_canDecodePartWithEncodingName:(NSString *)encoding;
|
|
-(void)_appendPathForPartToData:(NSMutableData *)data;
|
|
-(XADStringSource *)_sourceForPart;
|
|
|
|
@end
|
|
|