NSMutableString+Safety.h 1.8 KB
//
//  NSMutableString+Safety.h
//  BaiduBoxApp
//
//  Created by canyingwushang on 13-8-7.
//  Copyright (c) 2013年 Baidu. All rights reserved.
//
//  注意:使用以下方法,默认已经确任这是个可选参数,不会导致后续操作的异常

#import <Foundation/Foundation.h>
#import "BDPFoundationDefines.h"

/*
 * 可变字符串的安全相关的扩展
 * 详细介绍请看README-SafeAPI
 */

NS_ASSUME_NONNULL_BEGIN

@interface NSMutableString (Safety)

/**
 * @brief 字符串数组数组安全的附加string,如string不合法或为nil,什么都不会发生
 *
 * @param aString string
 */
- (void)safe_appendString:(NSString *)aString BDP_FOUNDATION_DEPRECATED("bdp_safeAppendString:");
- (void)bdp_safeAppendString:(NSString *)aString;

/**
 * @brief 向index位置插入string,如若string为nil,或者index越界,则什么都不会发生
 *
 * @param aString string
 * @param loc loc
 */
- (void)safe_insertString:(NSString *)aString atIndex:(NSUInteger)loc BDP_FOUNDATION_DEPRECATED("bdp_safeInsertString:atIndex:");
- (void)bdp_safeInsertString:(NSString *)aString atIndex:(NSUInteger)loc;

/**
 * @brief 安全的替换range范围内的代码,如果range越界不合法或者string为@“”,nil,则什么都不会发生
 *
 * @param range range
 * @param aString string
 */
- (void)safe_replaceCharactersInRange:(NSRange)range withString:(NSString *)aString  BDP_FOUNDATION_DEPRECATED("bdp_safeReplaceCharactersInRange:withString:");
- (void)bdp_safeReplaceCharactersInRange:(NSRange)range withString:(NSString *)aString;

/**
 * @brief 删除区间的字符
 *
 * @param range range范围
 */
- (void)safe_deleteCharactersInRange:(NSRange)range BDP_FOUNDATION_DEPRECATED("bdp_safeDeleteCharactersInRange:");
- (void)bdp_safeDeleteCharactersInRange:(NSRange)range;

@end

NS_ASSUME_NONNULL_END