NIFoundationMethods.h

//
// Copyright 2011-2014 NimbusKit
//
// 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>
#import <UIKit/UIKit.h>

#import "NIPreprocessorMacros.h"

#if defined __cplusplus
extern "C" {
#endif

#pragma mark - NSInvocation Methods

NSInvocation* NIInvocationWithInstanceTarget(NSObject* target, SEL selector);

NSInvocation* NIInvocationWithClassTarget(Class targetClass, SEL selector);

#pragma mark - CGRect Methods

CGRect NIRectContract(CGRect rect, CGFloat dx, CGFloat dy);

CGRect NIRectExpand(CGRect rect, CGFloat dx, CGFloat dy);

CGRect NIRectShift(CGRect rect, CGFloat dx, CGFloat dy);

CGRect NIEdgeInsetsOutsetRect(CGRect rect, UIEdgeInsets outsets);

CGFloat NICenterX(CGSize containerSize, CGSize size);

CGFloat NICenterY(CGSize containerSize, CGSize size);

CGRect NIFrameOfCenteredViewWithinView(UIView* viewToCenter, UIView* containerView);

CGSize NISizeOfStringWithLabelProperties(NSString *string, CGSize constrainedToSize, UIFont *font, NSLineBreakMode lineBreakMode, NSInteger numberOfLines);

#pragma mark - NSRange Methods

NSRange NIMakeNSRangeFromCFRange(CFRange range);

#pragma mark - NSData Methods

NSString* NIMD5HashFromData(NSData* data);

NSString* NISHA1HashFromData(NSData* data);

#pragma mark - NSString Methods

NSString* NIMD5HashFromString(NSString* string);

NSString* NISHA1HashFromString(NSString* string);

BOOL NIIsStringWithWhitespaceAndNewlines(NSString* string);

NSComparisonResult NICompareVersionStrings(NSString* string1, NSString* string2);

NSDictionary* NIQueryDictionaryFromStringUsingEncoding(NSString* string, NSStringEncoding encoding);

NSString* NIStringByAddingPercentEscapesForURLParameterString(NSString* parameter);

NSString* NIStringByAddingQueryDictionaryToString(NSString* string, NSDictionary* query);

#pragma mark - CGFloat Methods

#if CGFLOAT_IS_DOUBLE
  #define NI_CGFLOAT_EPSILON DBL_EPSILON
#else
  #define NI_CGFLOAT_EPSILON FLT_EPSILON
#endif

CG_INLINE CGFloat NICGFloatAbs(CGFloat x) {
#if CGFLOAT_IS_DOUBLE
  return (CGFloat)fabs(x);
#else
  return (CGFloat)fabsf(x);
#endif
}

CG_INLINE CGFloat NICGFloatFloor(CGFloat x) {
#if CGFLOAT_IS_DOUBLE
  return (CGFloat)floor(x);
#else
  return (CGFloat)floorf(x);
#endif
}

CG_INLINE CGFloat NICGFloatCeil(CGFloat x) {
#if CGFLOAT_IS_DOUBLE
  return (CGFloat)ceil(x);
#else
  return (CGFloat)ceilf(x);
#endif
}

CG_INLINE CGFloat NICGFloatRound(CGFloat x) {
#if CGFLOAT_IS_DOUBLE
  return (CGFloat)round(x);
#else
  return (CGFloat)roundf(x);
#endif
}

CG_INLINE CGFloat NICGFloatSqRt(CGFloat x) {
#if CGFLOAT_IS_DOUBLE
  return (CGFloat)sqrt(x);
#else
  return (CGFloat)sqrtf(x);
#endif
}

CG_INLINE CGFloat NICGFloatCopySign(CGFloat x, CGFloat y) {
#if CGFLOAT_IS_DOUBLE
  return (CGFloat)copysign(x, y);
#else
  return (CGFloat)copysignf(x, y);
#endif
}

CG_INLINE CGFloat NICGFloatPow(CGFloat x, CGFloat y) {
#if CGFLOAT_IS_DOUBLE
  return (CGFloat)pow(x, y);
#else
  return (CGFloat)powf(x, y);
#endif
}

CG_INLINE CGFloat NICGFloatCos(CGFloat x) {
#if CGFLOAT_IS_DOUBLE
  return (CGFloat)cos(x);
#else
  return (CGFloat)cosf(x);
#endif
}

#pragma mark - General Purpose Methods

CGFloat boundf(CGFloat value, CGFloat min, CGFloat max) __NI_DEPRECATED_METHOD; // Use NIBoundf instead. MAINTENANCE: Remove by Feb 28, 2014.

NSInteger boundi(NSInteger value, NSInteger min, NSInteger max) __NI_DEPRECATED_METHOD; // Use NIBoundi instead. MAINTENANCE: Remove by Feb 28, 2014.

CGFloat NIBoundf(CGFloat value, CGFloat min, CGFloat max);

NSInteger NIBoundi(NSInteger value, NSInteger min, NSInteger max);

#if defined __cplusplus
};
#endif
// End of Foundation Methods ///////////////////////////////////////////////////////////////