mirror of
https://github.com/gnustep/libs-base.git
synced 2025-04-27 18:50:47 +00:00
106 lines
2.9 KiB
C
106 lines
2.9 KiB
C
|
/** Declaration of extension methods for base additions
|
||
|
|
|
||
|
|
Copyright (C) 2003-2010 Free Software Foundation, Inc.
|
||
|
|
|
||
|
|
Written by: Richard Frith-Macdonald <rfm@gnu.org>
|
||
|
|
and: Adam Fedor <fedor@gnu.org>
|
||
|
|
|
||
|
|
This file is part of the GNUstep Base Library.
|
||
|
|
|
||
|
|
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 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
|
||
|
|
Library 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 02111 USA.
|
||
|
|
|
||
|
|
*/
|
||
|
|
|
||
|
|
#ifndef INCLUDED_NSString_GNUstepBase_h
|
||
|
|
#define INCLUDED_NSString_GNUstepBase_h
|
||
|
|
|
||
|
|
#import <GNUstepBase/GSVersionMacros.h>
|
||
|
|
#import <Foundation/NSString.h>
|
||
|
|
|
||
|
|
#if defined(__cplusplus)
|
||
|
|
extern "C" {
|
||
|
|
#endif
|
||
|
|
|
||
|
|
#if OS_API_VERSION(GS_API_NONE,GS_API_LATEST)
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Provides some additional (non-standard) utility methods.
|
||
|
|
*/
|
||
|
|
@interface NSString (GNUstepBase)
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Alternate way to invoke <code>stringWithFormat</code> if you have or wish
|
||
|
|
* to build an explicit <code>va_list</code> structure.
|
||
|
|
*/
|
||
|
|
+ (id) stringWithFormat: (NSString*)format
|
||
|
|
arguments: (va_list)argList;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Returns a string formed by removing the prefix string from the
|
||
|
|
* receiver. Raises an exception if the prefix is not present.
|
||
|
|
*/
|
||
|
|
- (NSString*) stringByDeletingPrefix: (NSString*)prefix;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Returns a string formed by removing the suffix string from the
|
||
|
|
* receiver. Raises an exception if the suffix is not present.
|
||
|
|
*/
|
||
|
|
- (NSString*) stringByDeletingSuffix: (NSString*)suffix;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Returns a string formed by removing leading white space from the
|
||
|
|
* receiver.
|
||
|
|
*/
|
||
|
|
- (NSString*) stringByTrimmingLeadSpaces;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Returns a string formed by removing trailing white space from the
|
||
|
|
* receiver.
|
||
|
|
*/
|
||
|
|
- (NSString*) stringByTrimmingTailSpaces;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Returns a string formed by removing both leading and trailing
|
||
|
|
* white space from the receiver.
|
||
|
|
*/
|
||
|
|
- (NSString*) stringByTrimmingSpaces;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Returns a string in which any (and all) occurrences of
|
||
|
|
* replace in the receiver have been replaced with by.
|
||
|
|
* Returns the receiver if replace
|
||
|
|
* does not occur within the receiver. NB. an empty string is
|
||
|
|
* not considered to exist within the receiver.
|
||
|
|
*/
|
||
|
|
- (NSString*) stringByReplacingString: (NSString*)replace
|
||
|
|
withString: (NSString*)by;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* An obsolete name for -substringWithRange: ... deprecated.
|
||
|
|
*/
|
||
|
|
- (NSString*) substringFromRange: (NSRange)aRange;
|
||
|
|
|
||
|
|
@end
|
||
|
|
|
||
|
|
#endif /* OS_API_VERSION */
|
||
|
|
|
||
|
|
#if defined(__cplusplus)
|
||
|
|
}
|
||
|
|
#endif
|
||
|
|
|
||
|
|
#endif /* INCLUDED_NSString_GNUstepBase_h */
|
||
|
|
|