OOPListParsing.h File Reference

import <Foundation/Foundation.h>

Include dependency graph for OOPListParsing.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Functions
id	OOPropertyListFromData (NSData *data, NSString *whereFrom)
id	OOPropertyListFromFile (NSString *path)
NSDictionary *	OODictionaryFromData (NSData *data, NSString *whereFrom)
NSDictionary *	OODictionaryFromFile (NSString *path)
NSArray *	OOArrayFromData (NSData *data, NSString *whereFrom)
NSArray *	OOArrayFromFile (NSString *path)

Function Documentation

OOArrayFromData()

NSArray * OOArrayFromData	(	NSData *	data,
		NSString *	whereFrom )

Definition at line 215 of file OOPListParsing.m.

{
    id result = OOPropertyListFromData(data, whereFrom);
    return ValueIfClass(result, [NSArray class]);
}

References OOPropertyListFromData(), and ValueIfClass().

Here is the call graph for this function:

OOArrayFromFile()

NSArray * OOArrayFromFile

(

NSString *

path

)

Definition at line 222 of file OOPListParsing.m.

{
    id result = OOPropertyListFromFile(path);
    return ValueIfClass(result, [NSArray class]);
}

References OOPropertyListFromFile(), and ValueIfClass().

Referenced by ResourceManager::arrayFromFilesNamed:inFolder:andMerge:cache:, ResourceManager::checkOXPMessagesInPath:, and OOScript::worldScriptsAtPath:.

Here is the call graph for this function:

Here is the caller graph for this function:

OODictionaryFromData()

NSDictionary * OODictionaryFromData	(	NSData *	data,
		NSString *	whereFrom )

Definition at line 201 of file OOPListParsing.m.

{
    id result = OOPropertyListFromData(data, whereFrom);
    return ValueIfClass(result, [NSDictionary class]);
}

References OOPropertyListFromData(), and ValueIfClass().

Here is the call graph for this function:

OODictionaryFromFile()

NSDictionary * OODictionaryFromFile

(

NSString *

path

)

Definition at line 208 of file OOPListParsing.m.

{
    id result = OOPropertyListFromFile(path);
    return ValueIfClass(result, [NSDictionary class]);
}

References OOPropertyListFromFile(), and ValueIfClass().

Referenced by ResourceManager::checkPotentialPath:path:, NSFileManager(OOExtensions)::commanderContentsOfPath:, OOJSScript(OOPrivate)::defaultPropertiesFromPath:, ResourceManager::dictionaryFromFilesNamed:inFolder:mergeMode:cache:, LoadExplicitSettings(), PlayerEntity(LoadSave)::loadPlayerFromFile:asNew:, AI(OOPrivate)::loadStateMachine:jsName:, ResourceManager::logControlDictionary, PlayerEntity(OOLoadSavePrivate)::lsCommanders:directory:pageNumber:highlightName:, OOOXZManager::managedOXZs, OOOXZManager(NSURLConnectionDataDelegate)::processDownloadedOXZ, ResourceManager::roleCategoriesDictionary, OOPListScript::scriptsInPListFile:, OOOXZManager::showInstallOptions, ResourceManager::systemDescriptionManager, and OOAIStateMachineVerifierStage(Private)::validateAI:.

Here is the call graph for this function:

Here is the caller graph for this function:

OOPropertyListFromData()

id OOPropertyListFromData	(	NSData *	data,
		NSString *	whereFrom )

Definition at line 51 of file OOPListParsing.m.

{
    id          result = nil;
    NSString    *error = nil;
    
    if (data != nil)
    {
#ifndef NO_DYNAMIC_PLIST_DTD_CHANGE
        data = ChangeDTDIfApplicable(data);
#endif
        
        result = [NSPropertyListSerialization propertyListFromData:data mutabilityOption:NSPropertyListImmutable format:NULL errorDescription:&error];
        if (result == nil)   // Foundation parser failed
        {   
#if OOLITE_RELEASE_PLIST_ERROR_STRINGS
            [error autorelease];
#endif
            // Ensure we can say something sensible...
            if (error == nil) error = @"<no error message>";
            if (whereFrom == nil) whereFrom = @"<data in memory>";
            
            OOLog(kOOLogPListFoundationParseError, @"Failed to parse %@ as a property list.\n%@", whereFrom, error);
        }
    }
    
    return result;
}

References kOOLogPListFoundationParseError, nil, and OOLog.

Referenced by OOArrayFromData(), OODictionaryFromData(), and OOPropertyListFromFile().

Here is the caller graph for this function:

OOPropertyListFromFile()

id OOPropertyListFromFile

(

NSString *

path

)

Definition at line 80 of file OOPListParsing.m.

{
    id          result = nil;
    NSData      *data = nil;
    
    if (path != nil)
    {
        // Load file, if it exists...
        data = CopyDataFromFile(path);
        if (data != nil)
        {
            // ...and parse it
            result = OOPropertyListFromData(data, path);
            [data release];
        }
        // Non-existent file is not an error.
    }
    
    return result;
}

References CopyDataFromFile(), nil, and OOPropertyListFromData().

Referenced by OOArrayFromFile(), and OODictionaryFromFile().

Here is the call graph for this function:

Here is the caller graph for this function: