NSMutableNumber - full thread safe mutable NSNumber implementation

Podfile

pod 'NSMutableNumber'

Features

• This class inherits all NSNumber protocols and overrides required methods for duplicate NSNumber read functionality.

    NSNumber * number = (NSNumber *)[[NSMutableNumber alloc] initWithInt:0];
    // use actual number NSMutableNumber class as NSNumber, of couce read only

• All getters are thread safe. Can be used for cross-thread synchronization. Used recursive mutex for get/set values.
• Same hash method as on NSNumber object - required for using as key with key/value coding classes.
• Detected as kind of NSNumber or NSValue class.

    NSMutableNumber * mutableNumber = [[NSMutableNumber alloc] init];
    [mutableNumber isKindOfClass:[NSNumber class]]; // YES, is kind of class
    [mutableNumber isKindOfClass:[NSMutableNumber class]]; // YES, is kind of class

• Can be compared with self(eg. NSMutableNumber) or NSNumber class. Comparation checks both numbers for real, signed and unsigned value and selects required method for comparing between values.

    [[NSMutableNumber numberWithBool:NO] isEqual:[NSNumber numberWithBool:NO]]; // YES, equal
    [[NSMutableNumber numberWithBool:YES] isEqual:[NSNumber numberWithFloat:1]]; // YES, equal
    [[NSMutableNumber numberWithDouble:DBL_MAX] isEqual:[NSNumber numberWithDouble:DBL_MAX]]; // YES, equal
    [[NSMutableNumber numberWithChar:CHAR_MIN] isEqual:[NSNumber numberWithInteger:CHAR_MIN]]; // YES, equal
    [[NSMutableNumber numberWithUnsignedShort:USHRT_MAX] isEqual:[NSNumber numberWithInt:USHRT_MAX]]; // YES, equal

• Works with maximum and minimum type value ranges.

    [[NSMutableNumber numberWithInt:INT_MIN] isEqual:[NSNumber numberWithInt:INT_MIN]]; // YES, equal
    [[NSMutableNumber numberWithInteger:NSIntegerMin] isEqual:[NSNumber numberWithInteger:NSIntegerMin]]; // YES, equal
    [[NSMutableNumber numberWithUnsignedInteger:NSUIntegerMax] isEqual:[NSNumber numberWithUnsignedInteger:NSUIntegerMax]]; // YES, equal
    [[NSMutableNumber numberWithUnsignedLongLong:ULONG_LONG_MAX] isEqual:[NSNumber numberWithUnsignedLongLong:ULONG_LONG_MAX]]; // YES, equal

• Internal logic implemented with C++. Same performance as standart NSNumber (see time tests) and minimum ammount of memory for storing values(used union's).
• NSNumber can be compared with this class via additional number comparator method isEqualToNumber:
• Category of the NSNumber with method mutableCopy which return NSMutableNumber class.

License

The MIT License (MIT)

Copyright (c) 2015 - 2016 Kulykov Oleh [email protected]

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.