+++ /dev/null
-/*
- * Copyright (c) 2012-2014 Apple Inc. All Rights Reserved.
- *
- * @APPLE_LICENSE_HEADER_START@
- *
- * This file contains Original Code and/or Modifications of Original Code
- * as defined in and that are subject to the Apple Public Source License
- * Version 2.0 (the 'License'). You may not use this file except in
- * compliance with the License. Please obtain a copy of the License at
- * http://www.opensource.apple.com/apsl/ and read it before using this
- * file.
- *
- * The Original Code and all software distributed under the License are
- * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
- * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
- * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
- * Please see the License for the specific language governing rights and
- * limitations under the License.
- *
- * @APPLE_LICENSE_HEADER_END@
- */
-
-
-#ifndef _SECIOFORMAT_H_
-#define _SECIOFORMAT_H_
-// TODO: Name this file SecType.h? To match inttype.h?
-
-#include <inttypes.h>
-
-// MARK: Guidlines and Examples
-
-/* Tips for using printf and CFStringCreateWithFormat style functions.
-
- Avoid using casts in arguments to these functions like the plague. If you
- have to use them, think again. You are probably wrong and you are writing
- non portable code. Instead try following this pattern:
-
- Type Format String Variants
- size_t "%zu"
- ssize_t "%zd"
- ptrdiff_t "%td" printf("array_len: %td", pos - begin)
- OSStatus "%"PRIdOSStatus printf("%"PRIxCFIndex" returned", status)
- CFIndex "%"PRIdCFIndex printf("ar[%"PRIdCFIndex"]=%p", ix, CFArrayGetValueAtIndex(ar, ix))
- sint64_t "%"PRId64
- uint64_t "%"PRIu64 printf("sqlite3_rowid: %"PRIu64, rowid)
- sint32_t "%"PRId32
- uint32_t "%"PRIu32
- uint8_t "%"PRIx8
-
- All of the above examples also work inside a CFSTR(). For example:
- CFStringAppendFormat(ms, NULL, CFSTR("ar[%"PRIdCFIndex"]=%p"), ix, CFArrayGetValueAtIndex(ar, ix))
- Also you can use any of d i o u x X where appropriate for some of these types
- although u x X are for unsigned types only.
-
- Try to avoid using these types unless you know what you are doing because
- they can lead to portability issues on different flavors of 32 and 64 bit
- platforms:
-
- int "%d"
- long "%ld"
- long long "%lld"
- */
-
-// MARK: CFIndex printing support
-
-// Note that CFIndex is signed so the u variants won't work.
-#ifdef __LLP64__
-# define PRIdCFIndex "lld"
-# define PRIiCFIndex "lli"
-# define PRIoCFIndex "llo"
-# define PRIuCFIndex "llu"
-# define PRIxCFIndex "llx"
-# define PRIXCFIndex "llX"
-#else
-# define PRIdCFIndex "ld"
-# define PRIiCFIndex "li"
-# define PRIoCFIndex "lo"
-# define PRIuCFIndex "lu"
-# define PRIxCFIndex "lx"
-# define PRIXCFIndex "lX"
-#endif
-
-// MARK: OSStatus printing support
-
-// Note that OSStatus is signed so the u variants won't work.
-#ifdef __LP64__
-# define PRIdOSStatus "d"
-# define PRIiOSStatus "i"
-# define PRIoOSStatus "o"
-# define PRIuOSStatus "u"
-# define PRIxOSStatus "x"
-# define PRIXOSStatus "X"
-#else
-# define PRIdOSStatus "ld"
-# define PRIiOSStatus "li"
-# define PRIoOSStatus "lo"
-# define PRIuOSStatus "lu"
-# define PRIxOSStatus "lx"
-# define PRIXOSStatus "lX"
-#endif
-
-#endif