nicklockwood/NullSafe

Stars
1,941
Rank 22,994 (Top 0.5 %)
Language
Objective-C
License
Other
Created over 11 years ago
Updated 9 months ago

nicklockwood/NullSafe

nicklockwood

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

NullSafe is a simple category on NSNull that returns nil for unrecognised messages instead of throwing an exception

Purpose

NullSafe is a simple category on NSNull that returns nil for unrecognised messages instead of throwing an exception. This eliminates a common cause of crashes, where (for example) JSON data contains a null value instead of an array or string, and the network code in the app isn't expecting it.

Supported iOS & SDK Versions

Supported build target - iOS 12.0 / Mac OS 10.14 (Xcode 10.1)
Earliest supported deployment target - iOS 9.0 / Mac OS 10.10
Earliest compatible deployment target - iOS 4.3 / Mac OS 10.6

NOTE: 'Supported' means that the library has been tested with this version. 'Compatible' means that the library should work on this iOS version (i.e. it doesn't rely on any unavailable SDK features) but is no longer being tested for compatibility and may require tweaking or bug fixes to run correctly.

ARC Compatibility

NullSafe works in both ARC and non ARC targets without modification.

Installation & Usage

To use NullSafe, just drag the NullSafe.m file into your project. NullSafe will be automatically loaded at runtime, you don't need to include any header files in your code.

Selectively Disabling NullSafe

NullSafe is enabled automatically as soon as the class files are added to a project target, however if you wish to disable NullSafe for a particular scheme (e.g. when running in debug mode) then you can disable it by adding the following pre-compiler macro to your build settings:

NULLSAFE_ENABLED=0

Or if you prefer, you could add something like this to your prefix.pch file:

#ifdef DEBUG
#define NULLSAFE_ENABLED 0
#endif

Release Notes

Version 2.0

Radically simplified NullSafe to only handle JSON and Plist values

Version 1.2.3

Updated for Xcode 9
Fixed thread safety issue
Added tvOS support to podspec

Version 1.2.2

Fixed nullability warning

Version 1.2.1

Fixed crash in iOS 8
Removed NullSafe.h file (redundant)
Now complies with -Weverything warning level

Version 1.2

Will now handle any known method, not just a subset
Added NULLSAFE_ENABLED macro to easily enable/disable per scheme
Added implementation cache for better performance

Version 1.1

Made it work by design rather than coincidence ;-)

Version 1.0

Initial release

iCarousel

A simple, highly customisable, data-driven 3D carousel for iOS and Mac OS

SwiftFormat

A command-line tool and Xcode Extension for formatting Swift code

FXBlurView

iRate

FXForms

SwipeView

SwipeView is a class designed to simplify the implementation of horizontal, paged scrolling views on iOS. It is based on a UIScrollView, but adds convenient functionality such as a UITableView-style dataSource/delegate interface for loading views dynamically, and efficient view loading, unloading and recycling.

layout

A declarative UI framework for iOS

iVersion

RetroRampage

Tutorial series demonstrating how to build a retro first-person shooter from scratch in Swift

XMLDictionary

AutoCoding

AutoCoding is a category on NSObject that provides automatic support for NSCoding and NSCopying to every object.

GZIP

A simple NSData category for gzipping/unzipping data in iOS and Mac OS

FastCoding

A faster and more flexible binary file format replacement for NSCoding, Property Lists and JSON

AsyncImageView

iConsole

FXLabel

Expression

A cross-platform Swift library for evaluating mathematical expressions at runtime

CountryPicker

CountryPicker is a custom UIPickerView subclass that provides an iOS control allowing a user to select a country from a list. It can optionally display a flag next to each country name, and the library includes a set of 249 high-quality, public domain flag images from FAMFAMFAM (http://www.famfamfam.com/lab/icons/flags/) that have been painstakingly re-named by country code to work with the library.

SoundManager

Simple sound and music player class for playing audio on Mac and iPhone

FXImageView

FXImageView is a class designed to simplify the application of common visual effects such as reflections and drop-shadows to images, and also to help the performance of image loading by handling it on a background thread.

Euclid

A Swift library for creating and manipulating 3D geometry

Base64

FXKeychain

MustOverride

Provides a macro that you can use to ensure that a method of an abstract base class *must* be overriden by its subclasses.

LayerSprites

LayerSprites is a library designed to simplify the use of sprite sheets (image maps containing multiple sub-images) in UIKit applications without using OpenGL or 3rd-party game libraries. Can load sprite sheets in the Coco2D format.

GLView

FXNotifications

An alternative API for NSNotificationCenter that doesn't suck

ShapeScript

The ShapeScript 3D modeling app for macOS and iOS

VectorMath

A Swift library for Mac and iOS that implements common 2D and 3D vector and matrix functions, useful for games or vector-based graphics

ReflectionView

Swiftenstein

Simple Wolfenstein 3D clone written in Swift

LRUCache

LRUCache is an open-source replacement for NSCache that behaves in a predictable, debuggable way

JPNG

JPNG is a bespoke image file format that combines the compression benefits of JPEG with the alpha channel support of a PNG file. The JPNG library provides an Objective-C implementation of this format along with transparent JPNG loading support for iOS and Mac OS.

StandardPaths

StandardPaths is a category on NSFileManager for simplifying access to standard application directories on iOS and Mac OS and abstracting the iCloud backup flags on iOS. It also provides support for working with device-specific file suffixes, such as the @2x suffix for Retina displays, or the -568h suffix for iPhone 5 and can optionally swizzle certain UIKit methods to support these suffixes more consistently.

ViewUtils

ViewUtils is a collection of category methods designed that extend UIView with all the handy little properties and functionality that you always wished were built-in to begin with.

FXPageControl

Simple, drop-in replacement for the iPhone UIPageControl that allows customisation of the dot colour, size and spacing.

BaseModel

BaseModel provides a base class for building model objects for your iOS or Mac OS projects. It saves you the hassle of writing boilerplate code, and encourages good practices by reducing the incentive to cut corners in your model implementation.

OrderedDictionary

This library provides OrderedDictionary and MutableOrderedDictionary subclasses.

ColorUtils

Tribute

A command-line tool for tracking Swift project licenses

OSNavigationController

iNotify

Consumer

Mac and iOS library for parsing structured text

FPSControls

An experimental implementation of touch-friendly first-person shooter controls using SceneKit and Swift

OSCache

OSCache is an open-source re-implementation of NSCache that behaves in a predictable, debuggable way.

RequestQueue

FXReachability

Lightweight reachability class for Mac and iOS

Chess

A simple Chess game for iOS, written in Swift

Sprinter

A library for formatting strings on iOS and macOS

CryptoCoding

CryptoCoding is a superset of the NSCoding protocol that allows for simple, seamless AES encryption of any NSCoding-compatible object.

RequestUtils

A collection of category methods designed to simplify the process of HTTP request construction and manipulation in Cocoa.

CubeController

CubeController is a UIViewController subclass that can be used to create a rotating 3D cube navigation.

HTMLLabel

NSOperationStack

SVGPath

Cross-platform Swift library for parsing SVGPath strings

HRCoder

HRCoder is a replacement for the NSKeyedArchiver and NSKeyedUnarchiver classes that uses a human-readable/editable format that can easily be stored in a regular Plist or JSON file.

iPrompt

Presentations

Code samples and projects for presentations that I have given

FXPhotoEditView

StackView

StackView is a class designed to simplify the implementation of vertical stacks of views on iOS. You can think of it as a bit like a simplified version of UITableView.

WebContentView

StringCoding

StringCoding is a simple Mac/iOS library for setting object properties of any type using string values. It can automatically detect the property type and attempt to interpret the string as the right kind of value. It's particularly oriented towards iOS app theming (see README for details).

ArrayUtils

Swune

Swift/UIKit reimplementation of the Dune II RTS game

Parsing

Supporting code for my talk entitled "Parsing Formal Languages with Swift"

MACAddress

RotateView

FXParser

RandomSequence

A class for creating independent, repeatable pseudorandom number sequences on Mac and iOS

FloatyBalloon

This is the source code for a simple game called Floaty Balloon, based on the gameplay of Flappy Bird. It was created as a tutorial for http://iosdevelopertips.com

Concurrency

Full source code for a simple currency calculator app

FXJSON

PNGvsJPEG

This is a simple benchmark app to compare JPEG vs PNG loading performance on iOS. Spoiler: JPEG wins.