//
//  GTMNSString+FindFolder.h
//
//  Copyright 2006-2008 Google Inc.
//
//  Licensed under the Apache License, Version 2.0 (the "License"); you may not
//  use this file except in compliance with the License.  You may obtain a copy
//  of the License at
// 
//  http://www.apache.org/licenses/LICENSE-2.0
// 
//  Unless required by applicable law or agreed to in writing, software
//  distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
//  WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  See the
//  License for the specific language governing permissions and limitations under
//  the License.
//

#import <Foundation/Foundation.h>

@interface NSString (GTMStringFindFolderAdditions)

// Create a path to a folder located with FindFolder
//
// Args:
//   theFolderType: one of the folder types in Folders.h 
//                  (kPreferencesFolderType, etc)
//   theDomain: one of the domains in Folders.h (kLocalDomain, kUserDomain, etc)
//   doCreate: create the folder if it does not already exist
//
// Returns:
//   full path to folder, or nil if the folder doesn't exist or can't be created
//
+ (NSString *)gtm_stringWithPathForFolder:(OSType)theFolderType 
                                 inDomain:(short)theDomain 
                                 doCreate:(BOOL)doCreate;

// Create a path to a folder inside a folder located with FindFolder
//
// Args:
//   theFolderType: one of the folder types in Folders.h 
//                  (kPreferencesFolderType, etc)
//   subfolderName: name of directory inside the Apple folder to be located or created
//   theDomain: one of the domains in Folders.h (kLocalDomain, kUserDomain, etc)
//   doCreate: create the folder if it does not already exist
//
// Returns:
//   full path to subdirectory, or nil if the folder doesn't exist or can't be created
//
+ (NSString *)gtm_stringWithPathForFolder:(OSType)theFolderType 
                            subfolderName:(NSString *)subfolderName
                                 inDomain:(short)theDomain
                                 doCreate:(BOOL)doCreate;  

@end