]> git.saurik.com Git - apple/security.git/blobdiff - OSX/utilities/src/SecIOFormat.h
Security-59306.11.20.tar.gz
[apple/security.git] / OSX / utilities / src / SecIOFormat.h
diff --git a/OSX/utilities/src/SecIOFormat.h b/OSX/utilities/src/SecIOFormat.h
deleted file mode 100644 (file)
index 8630e22..0000000
+++ /dev/null
@@ -1,103 +0,0 @@
-/*
- * 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