#include <OOCommodityMarket.h>

Inheritance diagram for OOCommodityMarket:

Collaboration diagram for OOCommodityMarket:

Instance Methods
(NSUInteger)	- count

(void)	- setGood:withInfo:

(NSArray *)	- goods

(NSDictionary *)	- dictionaryForScripting

(BOOL)	- setPrice:forGood:

(BOOL)	- setQuantity:forGood:

(BOOL)	- addQuantity:forGood:

(BOOL)	- removeQuantity:forGood:

(void)	- removeAllGoods

(BOOL)	- setComment:forGood:

(BOOL)	- setShortComment:forGood:

(NSString *)	- nameForGood:

(NSString *)	- commentForGood:

(NSString *)	- shortCommentForGood:

(OOCreditsQuantity)	- priceForGood:

(OOCargoQuantity)	- quantityForGood:

(OOMassUnit)	- massUnitForGood:

(NSUInteger)	- exportLegalityForGood:

(NSUInteger)	- importLegalityForGood:

(OOCargoQuantity)	- capacityForGood:

(float)	- trumbleOpinionForGood:

(NSDictionary *)	- definitionForGood:

(NSArray *)	- savePlayerAmounts

(void)	- loadPlayerAmounts:

(NSArray *)	- saveStationAmounts

(void)	- loadStationAmounts:

(id)	- init `[implementation]`

(void)	- dealloc `[implementation]`

Private Attributes
NSMutableDictionary *	_commodityList

NSArray *	_sortedKeys

Detailed Description

Definition at line 31 of file OOCommodityMarket.h.

Method Documentation

◆ addQuantity:forGood:

- (BOOL) addQuantity:		(OOCargoQuantity)	quantity
forGood:		(OOCommodityType)	good

Definition at line 408 of file OOCommodityMarket.m.

                    :(OOCargoQuantity)quantity forGood:(OOCommodityType)good
{
    OOCargoQuantity current = [self quantityForGood:good];
    if (current + quantity > [self capacityForGood:good])
    {
        return NO;
    }
    [self setQuantity:(current+quantity) forGood:good];
    return YES;
}

◆ capacityForGood:

- (OOCargoQuantity) capacityForGood: (OOCommodityType) good

Definition at line 408 of file OOCommodityMarket.m.

                                   :(OOCommodityType)good
{
    NSDictionary *definition = [_commodityList oo_dictionaryForKey:good];
    if (definition == nil)
    {
        return 0;
    }
    // should only be undefined for main system markets, not secondary stations
    // meaningless for player ship, though
    return [definition oo_unsignedIntForKey:kOOCommodityCapacity defaultValue:MAIN_SYSTEM_MARKET_LIMIT];
}

◆ commentForGood:

- (NSString *) commentForGood: (OOCommodityType) good

Definition at line 408 of file OOCommodityMarket.m.

                             :(OOCommodityType)good
{
    NSDictionary *definition = [_commodityList oo_dictionaryForKey:good];
    if (definition == nil)
    {
        return OOExpand(@"[oolite-unknown-commodity-name]");
    }
    return OOExpand([definition oo_stringForKey:kOOCommodityComment defaultValue:@"[oolite-commodity-no-comment]"]);
}

◆ count

- (NSUInteger) count

Definition at line 408 of file OOCommodityMarket.m.

{
    return [_commodityList count];
}

◆ dealloc

- (void) dealloc

implementation

Definition at line 408 of file OOCommodityMarket.m.

{
    DESTROY(_commodityList);
    DESTROY(_sortedKeys);
    [super dealloc];
}

◆ definitionForGood:

- (NSDictionary *) definitionForGood: (OOCommodityType) good

Definition at line 408 of file OOCommodityMarket.m.

                                    :(OOCommodityType)good
{
    return [[[_commodityList oo_dictionaryForKey:good] copy] autorelease];
}

◆ dictionaryForScripting

- (NSDictionary *) dictionaryForScripting

Definition at line 408 of file OOCommodityMarket.m.

{
    return [[_commodityList copy] autorelease];
}

◆ exportLegalityForGood:

- (NSUInteger) exportLegalityForGood: (OOCommodityType) good

Definition at line 408 of file OOCommodityMarket.m.

                                    :(OOCommodityType)good
{
    NSDictionary *definition = [_commodityList oo_dictionaryForKey:good];
    if (definition == nil)
    {
        return 0;
    }
    return [definition oo_unsignedIntegerForKey:kOOCommodityLegalityExport];
}

◆ goods

- (NSArray *) goods

Definition at line 408 of file OOCommodityMarket.m.

{
    if (_sortedKeys == nil)
    {
        NSArray *keys = [_commodityList allKeys];
        _sortedKeys = [[keys sortedArrayUsingFunction:goodsSorter context:_commodityList] retain];
    }
    return _sortedKeys;
}

◆ importLegalityForGood:

- (NSUInteger) importLegalityForGood: (OOCommodityType) good

Definition at line 408 of file OOCommodityMarket.m.

                                    :(OOCommodityType)good
{
    NSDictionary *definition = [_commodityList oo_dictionaryForKey:good];
    if (definition == nil)
    {
        return 0;
    }
    return [definition oo_unsignedIntegerForKey:kOOCommodityLegalityImport];
}

◆ init

- (id) init

implementation

Definition at line 408 of file OOCommodityMarket.m.

{
    self = [super init];
    if (self == nil)  return nil;
 
    _commodityList = [[NSMutableDictionary dictionaryWithCapacity:24] retain];
 
    _sortedKeys = nil;
 
    return self;
}

◆ loadPlayerAmounts:

- (void) loadPlayerAmounts: (NSArray *) amounts

Definition at line 408 of file OOCommodityMarket.m.

                          :(NSArray *)amounts
{
    OOCargoQuantity q;
    BOOL            loadedOK;
    NSString        *good = nil;
    foreach (good, [self goods])
    {
        // make sure that any goods not defined in the save game are zeroed
        [self setQuantity:0 forGood:good];
    }
 
 
    NSArray *loaded = nil;
    foreach (loaded, amounts)
    {
        loadedOK = NO;
        good = [loaded oo_stringAtIndex:0];
        q = [loaded oo_unsignedIntAtIndex:1];
        // old save games might have more in the array, but we don't care
        if (![self setQuantity:q forGood:good])
        {
            // then it's an array from a 1.80-or-earlier save game and
            // the good name is the description string (maybe a
            // translated one)
            OOCommodityType key = nil;
            foreach (key, [self goods])
            {
                if ([good isEqualToString:[self nameForGood:key]])
                {
                    [self setQuantity:q forGood:key];
                    loadedOK = YES;
                    break;
                }
            }
        }
        else
        {
            loadedOK = YES;
        }
        if (!loadedOK)
        {
            OOLog(@"setCommanderDataFromDictionary.warning.cargo",@"Cargo %@ (%u units) could not be loaded from the saved game, as it is no longer defined",good,q);
        }
    }
}

◆ loadStationAmounts:

- (void) loadStationAmounts: (NSArray *) amounts

Definition at line 408 of file OOCommodityMarket.m.

                           :(NSArray *)amounts
{
    OOCargoQuantity     q;
    OOCreditsQuantity   p;
    BOOL                loadedOK;
    NSString            *good = nil;
 
    NSArray *loaded = nil;
    foreach (loaded, amounts)
    {
        loadedOK = NO;
        good = [loaded oo_stringAtIndex:0];
        q = [loaded oo_unsignedIntAtIndex:1];
        p = [loaded oo_unsignedIntegerAtIndex:2];
        // old save games might have more in the array, but we don't care
        if (![self setQuantity:q forGood:good])
        {
            // then it's an array from a 1.80-or-earlier save game and
            // the good name is the description string (maybe a
            // translated one)
            OOCommodityType key = nil;
            foreach (key, [self goods])
            {
                if ([good isEqualToString:[self nameForGood:key]])
                {
                    [self setQuantity:q forGood:key];
                    [self setPrice:p forGood:key];
                    loadedOK = YES;
                    break;
                }
            }
        }
        else
        {
            [self setPrice:p forGood:good];
            loadedOK = YES;
        }
        if (!loadedOK)
        {
            OOLog(@"load.warning.cargo",@"Station market good %@ (%u units) could not be loaded from the saved game, as it is no longer defined",good,q);
        }
    }
}

◆ massUnitForGood:

- (OOMassUnit) massUnitForGood: (OOCommodityType) good

Definition at line 408 of file OOCommodityMarket.m.

                              :(OOCommodityType)good
{
    NSDictionary *definition = [_commodityList oo_dictionaryForKey:good];
    if (definition == nil)
    {
        return UNITS_TONS;
    }
    return [definition oo_unsignedIntForKey:kOOCommodityContainer];
}

Referenced by PlayerEntity::activateCloakingDevice.

Here is the caller graph for this function:

◆ nameForGood:

- (NSString *) nameForGood: (OOCommodityType) good

Definition at line 408 of file OOCommodityMarket.m.

                          :(OOCommodityType)good
{
    NSDictionary *definition = [_commodityList oo_dictionaryForKey:good];
    if (definition == nil)
    {
        return OOExpand(@"[oolite-unknown-commodity-name]");
    }
    return OOExpand([definition oo_stringForKey:kOOCommodityName defaultValue:@"[oolite-unknown-commodity-name]"]);
}

Referenced by marketSorterByName().

Here is the caller graph for this function:

◆ priceForGood:

- (OOCreditsQuantity) priceForGood: (OOCommodityType) good

Definition at line 408 of file OOCommodityMarket.m.

                                  :(OOCommodityType)good
{
    NSDictionary *definition = [_commodityList oo_dictionaryForKey:good];
    if (definition == nil)
    {
        return 0;
    }
    return [definition oo_unsignedIntegerForKey:kOOCommodityPriceCurrent];
}

Referenced by marketSorterByPrice().

Here is the caller graph for this function:

◆ quantityForGood:

- (OOCargoQuantity) quantityForGood: (OOCommodityType) good

Definition at line 408 of file OOCommodityMarket.m.

                                   :(OOCommodityType)good
{
    NSDictionary *definition = [_commodityList oo_dictionaryForKey:good];
    if (definition == nil)
    {
        return 0;
    }
    return [definition oo_unsignedIntForKey:kOOCommodityQuantityCurrent];
}

Referenced by marketSorterByQuantity().

Here is the caller graph for this function:

◆ removeAllGoods

- (void) removeAllGoods

Definition at line 408 of file OOCommodityMarket.m.

{
    OOCommodityType good = nil;
    foreach (good, [_commodityList allKeys])
    {
        [self setQuantity:0 forGood:good];
    }
}

◆ removeQuantity:forGood:

- (BOOL) removeQuantity:		(OOCargoQuantity)	quantity
forGood:		(OOCommodityType)	good

Definition at line 408 of file OOCommodityMarket.m.

                       :(OOCargoQuantity)quantity forGood:(OOCommodityType)good
{
    OOCargoQuantity current = [self quantityForGood:good];
    if (current < quantity)
    {
        return NO;
    }
    [self setQuantity:(current-quantity) forGood:good];
    return YES;
}

◆ savePlayerAmounts

- (NSArray *) savePlayerAmounts

Definition at line 408 of file OOCommodityMarket.m.

{
    NSMutableArray *amounts = [NSMutableArray arrayWithCapacity:[self count]];
    OOCommodityType good = nil;
    foreach (good, [self goods])
    {
        [amounts addObject:[NSArray arrayWithObjects:good,[NSNumber numberWithUnsignedInt:[self quantityForGood:good]],nil]];
    }
    return [NSArray arrayWithArray:amounts];
}

◆ saveStationAmounts

- (NSArray *) saveStationAmounts

Definition at line 408 of file OOCommodityMarket.m.

{
    NSMutableArray *amounts = [NSMutableArray arrayWithCapacity:[self count]];
    OOCommodityType good = nil;
    foreach (good, [self goods])
    {
        [amounts addObject:[NSArray arrayWithObjects:good,[NSNumber numberWithUnsignedInt:[self quantityForGood:good]],[NSNumber numberWithUnsignedInteger:[self priceForGood:good]],nil]];
    }
    return [NSArray arrayWithArray:amounts];
}

◆ setComment:forGood:

- (BOOL) setComment:		(NSString *)	comment
forGood:		(OOCommodityType)	good

Definition at line 408 of file OOCommodityMarket.m.

                   :(NSString *)comment forGood:(OOCommodityType)good
{
    NSMutableDictionary *definition = [_commodityList oo_mutableDictionaryForKey:good];
    if (definition == nil)
    {
        return NO;
    }
    [definition setObject:comment forKey:kOOCommodityComment];
    return YES;
}

◆ setGood:withInfo:

- (void) setGood:		(OOCommodityType)	key
withInfo:		(NSDictionary *)	info

Definition at line 408 of file OOCommodityMarket.m.

                :(OOCommodityType)key withInfo:(NSDictionary *)info
{
    NSMutableDictionary *definition = [NSMutableDictionary dictionaryWithDictionary:info];
    [_commodityList setObject:definition forKey:key];
    DESTROY(_sortedKeys); // reset
}

◆ setPrice:forGood:

- (BOOL) setPrice:		(OOCreditsQuantity)	price
forGood:		(OOCommodityType)	good

Definition at line 408 of file OOCommodityMarket.m.

                 :(OOCreditsQuantity)price forGood:(OOCommodityType)good
{
    NSMutableDictionary *definition = [_commodityList oo_mutableDictionaryForKey:good];
    if (definition == nil)
    {
        return NO;
    }
    [definition oo_setUnsignedInteger:price forKey:kOOCommodityPriceCurrent];
    return YES;
}

◆ setQuantity:forGood:

- (BOOL) setQuantity:		(OOCargoQuantity)	quantity
forGood:		(OOCommodityType)	good

Definition at line 408 of file OOCommodityMarket.m.

                    :(OOCargoQuantity)quantity forGood:(OOCommodityType)good
{
    NSMutableDictionary *definition = [_commodityList oo_mutableDictionaryForKey:good];
    if (definition == nil || quantity > [self capacityForGood:good])
    {
        return NO;
    }
    [definition oo_setUnsignedInteger:quantity forKey:kOOCommodityQuantityCurrent];
    return YES;
}

◆ setShortComment:forGood:

- (BOOL) setShortComment:		(NSString *)	comment
forGood:		(OOCommodityType)	good

Definition at line 408 of file OOCommodityMarket.m.

                        :(NSString *)comment forGood:(OOCommodityType)good
{
    NSMutableDictionary *definition = [_commodityList oo_mutableDictionaryForKey:good];
    if (definition == nil)
    {
        return NO;
    }
    [definition setObject:comment forKey:kOOCommodityShortComment];
    return YES;
}

◆ shortCommentForGood:

- (NSString *) shortCommentForGood: (OOCommodityType) good

Definition at line 408 of file OOCommodityMarket.m.

                                  :(OOCommodityType)good
{
    NSDictionary *definition = [_commodityList oo_dictionaryForKey:good];
    if (definition == nil)
    {
        return OOExpand(@"[oolite-unknown-commodity-name]");
    }
    return OOExpand([definition oo_stringForKey:kOOCommodityShortComment defaultValue:@"[oolite-commodity-no-short-comment]"]);
}

◆ trumbleOpinionForGood:

- (float) trumbleOpinionForGood: (OOCommodityType) good

Definition at line 408 of file OOCommodityMarket.m.

                               :(OOCommodityType)good
{
    NSDictionary *definition = [_commodityList oo_dictionaryForKey:good];
    if (definition == nil)
    {
        return 0;
    }
    return [definition oo_floatForKey:kOOCommodityTrumbleOpinion];
}

Member Data Documentation

◆ _commodityList

- (NSMutableDictionary*) _commodityList

private

Definition at line 34 of file OOCommodityMarket.h.

◆ _sortedKeys

- (NSArray*) _sortedKeys

private

Definition at line 35 of file OOCommodityMarket.h.

The documentation for this class was generated from the following files:

src/Core/OOCommodityMarket.h
src/Core/OOCommodityMarket.m

Instance Methods

Private Attributes

Detailed Description

Method Documentation

◆ addQuantity:forGood:

◆ capacityForGood:

◆ commentForGood:

◆ count

◆ dealloc

◆ definitionForGood:

◆ dictionaryForScripting

◆ exportLegalityForGood:

◆ goods

◆ importLegalityForGood:

◆ init

◆ loadPlayerAmounts:

◆ loadStationAmounts:

◆ massUnitForGood:

◆ nameForGood:

◆ priceForGood:

◆ quantityForGood:

◆ removeAllGoods

◆ removeQuantity:forGood:

◆ savePlayerAmounts

◆ saveStationAmounts

◆ setComment:forGood:

◆ setGood:withInfo:

◆ setPrice:forGood:

◆ setQuantity:forGood:

◆ setShortComment:forGood:

◆ shortCommentForGood:

◆ trumbleOpinionForGood:

Member Data Documentation

◆ _commodityList

◆ _sortedKeys