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

我对这个iPhone SDK及其文档感到不快...

我正在呼叫AudioConverterNew

在“返回”下的文档中：它说“返回状态码” ...真的...

到目前为止，通过玩弄参数，我只能得到两个不同的错误，在Audio Converter参考的底部都没有列出。

它们是'mrep'和'？tmf'（将OSStatus广播到char数组），但是具体的代码并不是真正的重点。

据我所知，随机错误代码是在随机文件中定义的，因此您不能仅搜索一个文件，也找不到帮助文档，该文档仅允许您搜索错误代码以获取更多信息，并从我可以说，在OS X中，您可以使用GetMacOSStatusErrorString（）将错误转换为有用的东西，但是没有iPhone等效的东西吗？

任何帮助将不胜感激。

编辑：

好的，所以将它们强制转换为反向（我检查了“ mrep”但没有回过头来），fmt吗？在音频转换器api的列表中，如果有点含糊，但还算公道，仍然不存在“烫发”（尽管可能与不支持aac解码的模拟器有关），这很容易解释。一般问题仍然存在。

不，不完全是。

有些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;
}

（请参阅iOS / C：将“整数”转换为四个字符串，以获取更多将fourcc转换为字符串的方法，包括Swift）

NSError的NSOSStatusErrorDomain能够解码一些操作系统错误。参见@tomk的答案。

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

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

OSStatus是一个带符号的整数值。您不能将其转换或“转换”为字符串。您可以将其转换为NSError，如下所示：

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

我最近遇到了另一种方法：macerror命令。将OSStatus值打印为有符号整数。然后在终端窗口中（在您的Mac上，而不是在iDevice！上）输入例如macerror -50。它将以简短说明进行响应。显然，这仅在开发过程中对您有帮助。

在macOS和11.3及更高版本的iOS上可用。

我知道这是一篇旧文章，但是我正在阅读与钥匙串相关的部分中的Apple文档。他们提到了一种用于将OSStatus错误转换为可读性的方法。

SecCopyErrorMessageString

返回说明安全性结果代码含义的字符串。

SecCopyErrorMessageString（OSStatus status，void * reserved）;

用途：

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

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

这是我写的代码，希望它可以节省您的键入时间...嗯，不知道如何正确显示它。

- (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";
    }
}

我结合了一些答案。实际上，我正在寻找类似“ throw errorForStatusCode（status）”的东西。但最终实现了：

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

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

我最近发现了一个非常不错的网站，该网站适用于我向其抛出的每个状态值。它比grep浏览框架头文件更加用户友好：http : //www.osstatus.com/

对于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的早期答案非常接近（因此请给他投票）-但我将其保留在此处，因为扩展名可能对某人有用。

使用OSX calc程序。在演示菜单中选择“程序员”模式。然后以十进制表示形式输入您的代码。然后选择“ ascii”按钮，计算将显示4个字符的翻译，例如“！init”，“！cat”等。

我创建了一个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行

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

我刚刚制作了一个python脚本来查找代码（当您调试/打印osstatus代码时）

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

如果您想创建一个命令行实用程序，以便在开发和支持期间使用，那么即使在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)

如果没有描述字符串，可以很方便地将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;
}

这不是对OP问题的直接答案，但是我认为这对于关心以下OSStatus返回码的人将是有用的：

在Xcode文档（Organizer）中搜索关键字“结果代码”，然后在“系统指南”结果中获得或多或少归类的返回代码文档部分。

如果您只需要在自定义函数中直接使用一些代码，它们将非常有帮助。

OSStatus错误可以是代表4个字符的代码的字节，也可以是在 MacErrors.h。

如果OSStatus错误是0或noErr那意味着您没有错误。

或者，尝试在中查找您的错误号MacErrors.h：

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

这可能会有所帮助。

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"];
}

鉴于SecCopyErrorMessageString在DYI平台上缺失，因此支持IOS上的安全框架

在底部添加错误代码

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"
        }

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

OSStatus err; ... printf（“％s”，（char *）＆err）;