如何将iPhone OSStatus代码转换为有用的东西?

时间:2010-02-04 01:55:15

标签: ios macos cocoa-touch cocoa error-handling

我对这款iPhone SDK及其文档感到有点不舒服......

我正在呼叫AudioConverterNew

返回下的文档中的

:它表示“返回状态代码” ... 真的...

到目前为止,通过玩这些参数我只能得到两个不同的错误,这两个错误都没有列在音频转换器参考的底部。

它们是'mrep'和'?tmf'(将OSStatus转换为char数组)但具体代码并非如此。

据我所知,随机错误代码是在随机文件中定义的,因此您不能只搜索一个文件,我找不到只是让您搜索错误代码以获取更多信息的帮助文档从我可以看出,在OS X中,您可以使用GetMacOSStatusErrorString()将错误转换为有用的东西,但是没有iPhone等价物吗?

任何帮助将不胜感激。

编辑:

好吧,所以投射它们会反过来(我检查过'mrep',但不是一直都是这样),fmt?在音频转换器api的列表中,并且如果有点模糊,但是很公平,仍然'perm'不存在(虽然它可能与模拟器不支持aac解码有关)和我的一般性问题仍然存在。

19 个答案:

答案 0 :(得分:88)

OSStatus是有符号整数值。您无法将其转换或“转换”为字符串。您可以将其转换为NSError,如下所示:

NSError *error = [NSError errorWithDomain:NSOSStatusErrorDomain code:osStatus userInfo:nil];

答案 1 :(得分:30)

没有。不完全。

某些OSStatus是四字符代码,因此您可以使用(从iPhone SDK的示例代码中提取“CAXException.h”)

static char *FormatError(char *str, OSStatus error)
{
    // see if it appears to be a 4-char-code
    *(UInt32 *)(str + 1) = CFSwapInt32HostToBig(error);
    if (isprint(str[1]) && isprint(str[2]) && isprint(str[3]) && isprint(str[4])) {
        str[0] = str[5] = '\'';
        str[6] = '\0';
    } else {
        // no, format it as an integer
        sprintf(str, "%d", (int)error);
    }
    return str;
}

(有关将fourcc转换为字符串的更多方法,请参阅iOS/C: Convert "integer" into four character string,包括Swift)

NSError的NSOSStatusErrorDomain能够解码一些操作系统错误。请参阅@tomk's answer

如果您不需要为用户解码程序中的数字,您可以使用macerror脚本手动找出其含义,如@lros's answer中所述。支持的OSStatus列表可以从/System/Library/Perl/Extras/5.18/Mac/Errors.pm的源代码中找到。

还有一个在线服务http://osstatus.com/收集来自所有公共框架的错误。它们仍然不是很完整,例如缺少评论中提到的-12792映射。可能它是来自私有框架的代码。

答案 2 :(得分:13)

我最近遇到了另一种方法:macerror命令。将OSStatus值打印为带符号整数。然后在终端窗口(在Mac上,而不是你的iDevice!)类型,例如 macerror -50 。它将以简短的描述作出回应。显然,这只对你在开发过程中有所帮助。

答案 3 :(得分:11)

这是我写的代码,希望它能为你节省一些打字...呃,不知道如何让它正确显示。

- (NSString *)OSStatusToStr:(OSStatus)st
{
    switch (st) {
        case kAudioFileUnspecifiedError:
            return @"kAudioFileUnspecifiedError";

        case kAudioFileUnsupportedFileTypeError:
            return @"kAudioFileUnsupportedFileTypeError";

        case kAudioFileUnsupportedDataFormatError:
            return @"kAudioFileUnsupportedDataFormatError";

        case kAudioFileUnsupportedPropertyError:
            return @"kAudioFileUnsupportedPropertyError";

        case kAudioFileBadPropertySizeError:
            return @"kAudioFileBadPropertySizeError";

        case kAudioFilePermissionsError:
            return @"kAudioFilePermissionsError";

        case kAudioFileNotOptimizedError:
            return @"kAudioFileNotOptimizedError";

        case kAudioFileInvalidChunkError:
            return @"kAudioFileInvalidChunkError";

        case kAudioFileDoesNotAllow64BitDataSizeError:
            return @"kAudioFileDoesNotAllow64BitDataSizeError";

        case kAudioFileInvalidPacketOffsetError:
            return @"kAudioFileInvalidPacketOffsetError";

        case kAudioFileInvalidFileError:
            return @"kAudioFileInvalidFileError";

        case kAudioFileOperationNotSupportedError:
            return @"kAudioFileOperationNotSupportedError";

        case kAudioFileNotOpenError:
            return @"kAudioFileNotOpenError";

        case kAudioFileEndOfFileError:
            return @"kAudioFileEndOfFileError";

        case kAudioFilePositionError:
            return @"kAudioFilePositionError";

        case kAudioFileFileNotFoundError:
            return @"kAudioFileFileNotFoundError";

        default:
            return @"unknown error";
    }
}

答案 4 :(得分:10)

这适用于macOS和iOS 11.3及以上版本。

我知道这是一篇旧帖子,但我在与钥匙串相关的部分阅读the apple docs。他们提到了一种用于将OSStatus错误转换为可读内容的方法。

  

SecCopyErrorMessageString

     

返回一个解释安全结果代码含义的字符串。

     

SecCopyErrorMessageString(OSStatus status,void * reserved);

用法:

NSString* ErrMsg = (__bridge_transfer NSString *) SecCopyErrorMessageString(theOSStatusError, NULL);

我的钥匙串OSStatus错误对我有用。对你起作用吗?您需要将 Security.Framework 添加到项目中才能使用此方法。

答案 5 :(得分:4)

使用OSX计算程序。在演示菜单中选择“程序员”模式。 然后在十进制représentation中键入您的代码。然后选择“ascii”按钮,calc将显示4个字符的翻译,例如“!init”,“!cat”等...

答案 6 :(得分:4)

我最近发现这个非常好的网站能够为我所投入的每一个身份价值而努力。它比浏览框架头文件更加用户友好:http://www.osstatus.com/

答案 7 :(得分:4)

我结合了一些答案。实际上,我正在寻找类似“ throw errorForStatusCode(status)”的东西。 但最终实现了:

    guard status == errSecSuccess else {
        throw  NSError(domain: NSOSStatusErrorDomain, code: Int(status), userInfo: [NSLocalizedDescriptionKey: SecCopyErrorMessageString(status, nil) ?? "Undefined error"])
    }

SecCopyErrorMessageString可从iOS 11.3获得 https://developer.apple.com/documentation/security/1542001-security_framework_result_codes

答案 8 :(得分:2)

大多数时候你可能只需要在.h文件中找到错误代码

我刚刚创建了一个python脚本来查找代码(当您调试/打印osstatus代码时)

https://github.com/sprhawk/MyGist/blob/master/tools/find_osstatus_error.py

答案 9 :(得分:2)

如果要创建命令行实用程序,以便在开发和支持期间使用,那么即使在10.9(Mavericks)中,您仍然可以使用已弃用的Carbon方法。您显然无法在提交给Apple的应用中将其用于App Store中。

#import <Foundation/Foundation.h>
#import <CoreServices/CoreServices.h>

int main(int argc, const char **argv)
{
    @autoreleasepool {
        for (int i = 1; i < argc; i++) {
            char *endp;
            long value = strtol(argv[i], &endp, 10);
            if (*endp == '\0') {
                printf("%10ld: %s (%s)\n",
                    value,
                    GetMacOSStatusCommentString((OSStatus)value),
                    GetMacOSStatusErrorString((OSStatus)value));
            } else {
                fprintf(stderr, "Invalid OSStatus code '%s' ignored\n", argv[i]);
            }
        }
    }
}

编译:

$ clang -fobjc-arc -o osstatus osstatus.m -framework Foundation -framework CoreServices

将其复制到$PATH

中的某个位置
$ cp osstatus ~/bin

并从日志文件或错误报告中提供错误代码:

$ osstatus -47
   -47: File is busy (delete) (fBsyErr)

答案 10 :(得分:2)

对于描述字符串失败,将OSStatus值转换为看起来像四字符定义的字符串很方便。至少那时你可以grep标题,希望找到关于状态意味着什么的评论。

// declaration:  extern CFStringRef CreateTypeStringWithOSType(OSType inType);

OSStatus result = ...;

if (result != noErr) {
    NSString *statusString = (NSString *)CreateTypeStringWithOSType(result);
    NSLog(@"Error while $VERBing: %@", statusString);
    [statusString release]; // because "Create..."
    statusString = nil;
}

答案 11 :(得分:1)

这不是OP问题的直接答案,但我认为对于那些关注这些OSStatus返回码的人来说是有用的:

在Xcode文档(管理器)中搜索关键字“结果代码”,我们在“系统指南”结果中获得了或多或少的分类返回代码文档部分。

如果您只需要在自定义函数中直接使用某些代码,它们就会非常有用。

答案 12 :(得分:1)

OSStatus错误可以是表示4-char代码的字节,也可以是MacErrors.h中定义的任意数量的错误。

如果OSStatus错误为0noErr,则表示您没有错误。

或者,尝试在MacErrors.h中查找错误编号:

http://www.opensource.apple.com/source/CarbonHeaders/CarbonHeaders-18.1/MacErrors.h

答案 13 :(得分:1)

这可能会有所帮助。

static NSString *stringForOSStatus(OSStatus status)
{
    NSBundle *bundle = [NSBundle bundleWithIdentifier:@"com.apple.security"];
    NSString *key = [NSString stringWithFormat:@"%d", status];
    return [bundle localizedStringForKey:key value:key table:@"SecErrorMessages"];
}

答案 14 :(得分:1)

对于IOS上的安全框架,假设平台上缺少SecCopyErrorMessageString它的DYI

的底部添加错误代码

https://developer.apple.com/library/ios/documentation/Security/Reference/keychainservices

到你自己的开关。

例如

        let status : OSStatus = SecItemAdd(query as CFDictionaryRef, nil)
        switch status {
        case errSecSuccess:
            return nil
        case errSecAuthFailed:
            // that's the result of dumping kSecAttrAccessibleWhenPasscodeSetThisDeviceOnly into the query
            return "changing app lock type on a device without fingerprint and/or passcode setup is not allowed".localized
        default:
            return "unhandled case: implement this"
        }

答案 15 :(得分:0)

我创建了一个OSStatus扩展,您可能会觉得有用。它记录有关音频相关错误的完整错误消息,如果可能,则记录四个字符的代码,否则记录您可以在https://www.osstatus.com

中查找的OSStatus号。

它进一步添加了有用的信息,例如文件,函数和发生错误的行。

代码如下:

let isDebug = true

//**************************
// OSStatus extensions for logging
//**************************
extension OSStatus {
    //**************************
    func asString() -> String? {
        let n = UInt32(bitPattern: self.littleEndian)
        guard let n1 = UnicodeScalar((n >> 24) & 255), n1.isASCII else { return nil }
        guard let n2 = UnicodeScalar((n >> 16) & 255), n2.isASCII else { return nil }
        guard let n3 = UnicodeScalar((n >>  8) & 255), n3.isASCII else { return nil }
        guard let n4 = UnicodeScalar( n        & 255), n4.isASCII else { return nil }
        return String(n1) + String(n2) + String(n3) + String(n4)
    } // asString

    //**************************
    func detailedErrorMessage() -> String? {
        switch(self) {
        //***** AUGraph errors
        case kAUGraphErr_NodeNotFound:             return "AUGraph Node Not Found"
        case kAUGraphErr_InvalidConnection:        return "AUGraph Invalid Connection"
        case kAUGraphErr_OutputNodeErr:            return "AUGraph Output Node Error"
        case kAUGraphErr_CannotDoInCurrentContext: return "AUGraph Cannot Do In Current Context"
        case kAUGraphErr_InvalidAudioUnit:         return "AUGraph Invalid Audio Unit"

        //***** MIDI errors
        case kMIDIInvalidClient:     return "MIDI Invalid Client"
        case kMIDIInvalidPort:       return "MIDI Invalid Port"
        case kMIDIWrongEndpointType: return "MIDI Wrong Endpoint Type"
        case kMIDINoConnection:      return "MIDI No Connection"
        case kMIDIUnknownEndpoint:   return "MIDI Unknown Endpoint"
        case kMIDIUnknownProperty:   return "MIDI Unknown Property"
        case kMIDIWrongPropertyType: return "MIDI Wrong Property Type"
        case kMIDINoCurrentSetup:    return "MIDI No Current Setup"
        case kMIDIMessageSendErr:    return "MIDI Message Send Error"
        case kMIDIServerStartErr:    return "MIDI Server Start Error"
        case kMIDISetupFormatErr:    return "MIDI Setup Format Error"
        case kMIDIWrongThread:       return "MIDI Wrong Thread"
        case kMIDIObjectNotFound:    return "MIDI Object Not Found"
        case kMIDIIDNotUnique:       return "MIDI ID Not Unique"
        case kMIDINotPermitted:      return "MIDI Not Permitted"

        //***** AudioToolbox errors
        case kAudioToolboxErr_CannotDoInCurrentContext: return "AudioToolbox Cannot Do In Current Context"
        case kAudioToolboxErr_EndOfTrack:               return "AudioToolbox End Of Track"
        case kAudioToolboxErr_IllegalTrackDestination:  return "AudioToolbox Illegal Track Destination"
        case kAudioToolboxErr_InvalidEventType:         return "AudioToolbox Invalid Event Type"
        case kAudioToolboxErr_InvalidPlayerState:       return "AudioToolbox Invalid Player State"
        case kAudioToolboxErr_InvalidSequenceType:      return "AudioToolbox Invalid Sequence Type"
        case kAudioToolboxErr_NoSequence:               return "AudioToolbox No Sequence"
        case kAudioToolboxErr_StartOfTrack:             return "AudioToolbox Start Of Track"
        case kAudioToolboxErr_TrackIndexError:          return "AudioToolbox Track Index Error"
        case kAudioToolboxErr_TrackNotFound:            return "AudioToolbox Track Not Found"
        case kAudioToolboxError_NoTrackDestination:     return "AudioToolbox No Track Destination"

        //***** AudioUnit errors
        case kAudioUnitErr_CannotDoInCurrentContext: return "AudioUnit Cannot Do In Current Context"
        case kAudioUnitErr_FailedInitialization:     return "AudioUnit Failed Initialization"
        case kAudioUnitErr_FileNotSpecified:         return "AudioUnit File Not Specified"
        case kAudioUnitErr_FormatNotSupported:       return "AudioUnit Format Not Supported"
        case kAudioUnitErr_IllegalInstrument:        return "AudioUnit Illegal Instrument"
        case kAudioUnitErr_Initialized:              return "AudioUnit Initialized"
        case kAudioUnitErr_InvalidElement:           return "AudioUnit Invalid Element"
        case kAudioUnitErr_InvalidFile:              return "AudioUnit Invalid File"
        case kAudioUnitErr_InvalidOfflineRender:     return "AudioUnit Invalid Offline Render"
        case kAudioUnitErr_InvalidParameter:         return "AudioUnit Invalid Parameter"
        case kAudioUnitErr_InvalidProperty:          return "AudioUnit Invalid Property"
        case kAudioUnitErr_InvalidPropertyValue:     return "AudioUnit Invalid Property Value"
        case kAudioUnitErr_InvalidScope:             return "AudioUnit InvalidScope"
        case kAudioUnitErr_InstrumentTypeNotFound:   return "AudioUnit Instrument Type Not Found"
        case kAudioUnitErr_NoConnection:             return "AudioUnit No Connection"
        case kAudioUnitErr_PropertyNotInUse:         return "AudioUnit Property Not In Use"
        case kAudioUnitErr_PropertyNotWritable:      return "AudioUnit Property Not Writable"
        case kAudioUnitErr_TooManyFramesToProcess:   return "AudioUnit Too Many Frames To Process"
        case kAudioUnitErr_Unauthorized:             return "AudioUnit Unauthorized"
        case kAudioUnitErr_Uninitialized:            return "AudioUnit Uninitialized"
        case kAudioUnitErr_UnknownFileType:          return "AudioUnit Unknown File Type"
        case kAudioUnitErr_RenderTimeout:             return "AudioUnit Rendre Timeout"

        //***** AudioComponent errors
        case kAudioComponentErr_DuplicateDescription:   return "AudioComponent Duplicate Description"
        case kAudioComponentErr_InitializationTimedOut: return "AudioComponent Initialization Timed Out"
        case kAudioComponentErr_InstanceInvalidated:    return "AudioComponent Instance Invalidated"
        case kAudioComponentErr_InvalidFormat:          return "AudioComponent Invalid Format"
        case kAudioComponentErr_NotPermitted:           return "AudioComponent Not Permitted "
        case kAudioComponentErr_TooManyInstances:       return "AudioComponent Too Many Instances"
        case kAudioComponentErr_UnsupportedType:        return "AudioComponent Unsupported Type"

        //***** Audio errors
        case kAudio_BadFilePathError:      return "Audio Bad File Path Error"
        case kAudio_FileNotFoundError:     return "Audio File Not Found Error"
        case kAudio_FilePermissionError:   return "Audio File Permission Error"
        case kAudio_MemFullError:          return "Audio Mem Full Error"
        case kAudio_ParamError:            return "Audio Param Error"
        case kAudio_TooManyFilesOpenError: return "Audio Too Many Files Open Error"
        case kAudio_UnimplementedError:    return "Audio Unimplemented Error"

        default: return nil
        } // switch(self)
    } // detailedErrorMessage

    //**************************
    func debugLog(filePath: String = #file, line: Int = #line, funcName: String = #function) {
        guard isDebug, self != noErr else { return }
        let fileComponents = filePath.components(separatedBy: "/")
        let fileName = fileComponents.last ?? "???"

        var logString = "OSStatus = \(self) in \(fileName) - \(funcName), line \(line)"

        if let errorMessage = self.detailedErrorMessage() { logString = errorMessage + ", " + logString }
        else if let errorCode = self.asString()           { logString = errorCode    + ", " + logString }

        NSLog(logString)
    } // debugLog
} // extension OSStatus

用法为:

//***** Create audioGraph
NewAUGraph(&audioGraph).debugLog()

//***** Testing .debugLog() OSStatus extension
kAUGraphErr_InvalidAudioUnit.debugLog()
OSStatus(560226676).debugLog()
OSStatus(-125).debugLog()

三个测试的结果日志:

2018-11-12 19:41:48.427606 + 0100 HexaSynth [5875:102611] AUGraph无效的音频单元,SoftSynthesizer.swift中的OSStatus = -10864-init(soundFontFileName :),第40行

2018-11-12 19:41:48.428403 + 0100 HexaSynth [5875:102611]!dat,OSStatus = 560226676在SoftSynthesizer.swift中-init(soundFontFileName :),第41行

2018-11-12 19:41:48.428638 + 0100 HexaSynth [5875:102611] OSStatus = -125在SoftSynthesizer.swift中-init(soundFontFileName :),第42行

答案 16 :(得分:0)

对于iOS 11.3及更高版本,我在OSStatus上使用扩展程序…

extension OSStatus {

    var error: NSError? {
        guard self != errSecSuccess else { return nil }

        let message = SecCopyErrorMessageString(self, nil) as String? ?? "Unknown error"

        return NSError(domain: NSOSStatusErrorDomain, code: Int(self), userInfo: [
            NSLocalizedDescriptionKey: message])
    }
}

您可以这样称呼…

let status = SecItemAdd(attributes as CFDictionary, nil)

if let error = status.error {
    throw error
}    
// etc

已经写了这篇文章,我注意到这与@RomanMykitchak的早期答案非常接近(因此请给他投票)-但我将其留在此处,因为扩展名可能对某人有用。

答案 17 :(得分:0)

这就是您所需要的https://www.osstatus.com/。 只需搜索给定的OSStatus。

答案 18 :(得分:-4)

OSStatus错误; ... printf(“%s”,(char *)&amp; err);