Core Foundation 官方文档翻译

时间：2023-03-09 09:45:11
Core Foundation 官方文档翻译
Core Foundation框架中常用的隐含类型：
使用这些隐含类型时需要自己初始化，自己去释放内存。所以需要记住，在初始化的同时在相应位置释放。以防出现内存问题。
1.CFStringRef
其他方法用的时候可以查看文档 
-(void)testCFStringref{

    CFStringRef stringRef = CFSTR("我'是'一'串'字'符'串");

    CFStringRef seperatorStringRef = CFSTR("'");

    CFArrayRef stringArrayRef = CFStringCreateArrayBySeparatingStrings(kCFAllocatorDefault, stringRef, seperatorStringRef);

    CFStringRef combineStringRef = CFStringCreateByCombiningStrings(kCFAllocatorDefault, stringArrayRef, CFSTR("|"));

    CFStringRef copyStringRef = CFStringCreateCopy(kCFAllocatorDefault, stringRef);

    NSLog(@"count = %ld combine: %@ copyStringRef:%@",CFArrayGetCount(stringArrayRef),combineStringRef,copyStringRef);

    CFRelease(stringRef);

    CFRelease(seperatorStringRef);

    CFRelease(stringArrayRef);

    CFRelease(combineStringRef);

    CFRelease(copyStringRef);

}

2、 CFArrayRef,还有很多其他方法可以在官方文档中查看

-(void)testCFArrayRef{

    //准换CFArrayRef < --- > NSArray

    CFArrayRef cfArr = (__bridge CFArrayRef) @[@"",@"",@""];

    NSArray *nsarr = (__bridge NSArray *)(cfArr);

    CFStringRef values[];

    values[] = CFSTR("cf1");

    values[] = CFSTR("cf2");

    values[] = CFSTR("cf3");

    //初始化一个CF数组

    //不可变

    CFArrayRef  cfArray = CFArrayCreate(kCFAllocatorDefault,(void*)values, , NULL);

    CFArrayRef cfArrayCopyNew = CFArrayCreateCopy(kCFAllocatorDefault, cfArray);

    //可变

    CFMutableArrayRef muArrayRef1 = CFArrayCreateMutable(kCFAllocatorDefault, , NULL);

    //添加元素

    CFArrayAppendValue(muArrayRef1, CFSTR("添加的第一个元素"));

    CFArrayAppendValue(muArrayRef1, CFSTR("添加的第二个元素"));

    CFMutableArrayRef muArrayRef2 = CFArrayCreateMutableCopy(kCFAllocatorDefault, , muArrayRef1);

    NSLog(@"%ld %ld %ld %ld %ld %ld",CFArrayGetCount(cfArray),CFArrayGetCount(cfArr),nsarr.count,CFArrayGetCount(cfArrayCopyNew),CFArrayGetCount(muArrayRef1),CFArrayGetCount(muArrayRef2));

    NSLog(@"%@ %@ %@ %@ %@ %@ ",CFArrayGetValueAtIndex(cfArr, ),CFArrayGetValueAtIndex(cfArray, ),nsarr[],CFArrayGetValueAtIndex(cfArrayCopyNew, ),CFArrayGetValueAtIndex(muArrayRef1, ),CFArrayGetValueAtIndex(muArrayRef2, ));

    //使用完需要release掉

    CFRelease(cfArr);

    CFRelease(values);

    CFRelease(cfArray);

    CFRelease(cfArrayCopyNew);

    CFRelease(muArrayRef1);

    CFRelease(muArrayRef2);

}

3.CFDictionaryRef & CFMutableDictionaryRef

-(void)testCFDictionaryRef{

    CFStringRef keys[];

    CFStringRef values[];

    keys[] = CFSTR("key1");

    keys[] = CFSTR("key2");

    keys[] = CFSTR("key3");

    values[] = CFSTR("不可变数组ref value1");

    values[] = CFSTR("不可变数组ref value2");

    values[] = CFSTR("不可变数组ref value3");

    CFDictionaryRef dictionaryRef1 = CFDictionaryCreate(kCFAllocatorDefault, (void *)keys, (void *)values,, NULL, NULL);

    CFDictionaryRef dictionaryRef2 = CFDictionaryCreateCopy(kCFAllocatorDefault, dictionaryRef1);

    CFMutableDictionaryRef muDicRef1 = CFDictionaryCreateMutable(kCFAllocatorDefault, , NULL, NULL);

    CFDictionaryAddValue(muDicRef1, CFSTR("key1"), CFSTR("可变数组ref value1"));

    //0表示不限制个数

    CFMutableDictionaryRef muDicRef2 = CFDictionaryCreateMutableCopy(kCFAllocatorDefault, , muDicRef1);

    NSLog(@"%@,%@,%@,%@",CFDictionaryGetValue(dictionaryRef1, CFSTR("key1")),CFDictionaryGetValue(dictionaryRef2, CFSTR("key1")),CFDictionaryGetValue(muDicRef1, CFSTR("key1")),CFDictionaryGetValue(muDicRef2, CFSTR("key1")));

    //使用完要release

    CFRelease(dictionaryRef1);

    CFRelease(dictionaryRef2);

    CFRelease(muDicRef1);

    CFRelease(muDicRef2);

    CFRelease(keys);

    CFRelease(values);

}
未完，一个个看着呢
1
CFRange //类似于NSRange（第一个参数是起始位置，第二个参数是长度length）
官方定义：CFRange CFRangeMake(CFIndex loc, CFIndex len);
使用： CFRange cfRange = CFRangeMake(1, 3);
2. 
CFComparatorFunction  //回调函数比较两个值,返回值是CFComparisonResult类型。
     CFComparisonResult //是一个枚举类型：
         官方定义为:
     typedef CF_ENUM(CFIndex, CFComparisonResult) {
     kCFCompareLessThan = -1L,//<
     kCFCompareEqualTo = 0,//=
     kCFCompareGreaterThan = 1//>
     };
     typedef CFComparisonResult (*CFComparatorFunction)(const void *val1, const void *val2, void *context);
     val1:第一个需要比较的value
     val2:第二个需要比较的value
     context:一个无类型的指针，指向评估的上下文。该值的含义及其用法由每个比较器函数定义。 该值通常传递给一个排序函数，例如CFArraySortValues，然后将其不变地传递给比较器函数。
     使用：输入"CFCompare" 会有很多选择器，选择自己需要的。
3.
     CFIndex 用于kAXPriorityKey的优先级值
     官方定义：typedef long CFIndex;
     使用：CFIndex index = 5;
    
   
4
    
     CFOptionFlags
     用于将特殊分配和其他请求传递给Core Foundation功能的位域。
     官方定义：typedef unsigned long CFOptionFlags;
5
常量：
     a. kCFNotFound //当Core Foundation功能无法找到请求的值时,返回这个特殊值。
     官方定义：static const CFIndex kCFNotFound = -1;
     b. kCFCoreFoundationVersionNumber //当前Core Foundation库的版本号
     官方定义：Command+光标进去看看就可以了。
     延伸：Mac iOS平台关于Core Foundation库版本号的宏定义
 6
CFByteOrder
     官方定义：typedef CFIndex CFByteOrder;
    
     #if CF_USE_OSBYTEORDER_H
     int32_t byteOrder = OSHostByteOrder();
     switch (byteOrder) {
     case OSLittleEndian: return CFByteOrderLittleEndian;
     case OSBigEndian: return CFByteOrderBigEndian;
     default: break;
     }
     return CFByteOrderUnknown;
     #else
     #if __LITTLE_ENDIAN__
     return CFByteOrderLittleEndian;
     #elif __BIG_ENDIAN__
     return CFByteOrderBigEndian;
     #else
     return CFByteOrderUnknown;
     #endif
     #endif
     使用：NSLog(@"%ld",CFByteOrderGetCurrent());
     获取当前CPU的字节顺序（我也不明白到底是什么）。
7
CFConvertDoubleHostToSwapped
     将从主机中的64位double字节顺序转换为与平台无关的格式。
     CFSwappedFloat64 sf64 = CFConvertDoubleHostToSwapped(10.0);//道行浅，不知道到底有什么用
    
     延伸：CFConvertDoubleSwappedToHost
     double CFConvertDoubleSwappedToHost(CFSwappedFloat64 arg);
     和上面那个是逆向关系。
下面这些属性，和上面这两个类似，用于类型转换：
Core Foundation 官方文档翻译
8
    Core Foundation URL Access Utilities URL访问相关
     a. Boolean CFURLCreateDataAndPropertiesFromResource(CFAllocatorRef alloc, CFURLRef url, CFDataRef *resourceData, CFDictionaryRef *properties, CFArrayRef desiredProperties, SInt32 *errorCode);
     b. CFTypeRef CFURLCreatePropertyFromResource(CFAllocatorRef alloc, CFURLRef url, CFStringRef property, SInt32 *errorCode);
     c. Boolean CFURLDestroyResource(CFURLRef url, SInt32 *errorCode);
     d. Boolean CFURLWriteDataAndPropertiesToResource(CFURLRef url, CFDataRef dataToWrite, CFDictionaryRef propertiesToWrite, SInt32 *errorCode);
     const CFStringRef kCFURLFileLength;
9
CFURLError
     Declaration
    
     typedef enum CFURLError : CFIndex {
     kCFURLUnknownError = -10L,
     kCFURLUnknownSchemeError = -11L,
     kCFURLResourceNotFoundError = -12L,
     kCFURLResourceAccessViolationError = -13L,
     kCFURLRemoteHostUnavailableError = -14L,
     kCFURLImproperArgumentsError = -15L,
     kCFURLUnknownPropertyKeyError = -16L,
     kCFURLPropertyKeyUnavailableError = -17L,
     kCFURLTimeoutError = -18L
     } CFURLError;
10    
File URL Properties
Core Foundation 官方文档翻译

相关文章