Class that handles league table related functions. More...

#include <script_league.hpp>

Inheritance diagram for GSLeagueTable:

Public Types
enum	LinkType : int { LINK_NONE , LINK_TILE , LINK_INDUSTRY , LINK_TOWN , LINK_COMPANY , LINK_STORY_PAGE }
	The type of a link. More...

Static Public Member Functions
static bool	IsValidLeagueTable (LeagueTableID table_id)
	Check whether this is a valid league table ID.

static bool	IsValidLeagueTableElement (LeagueTableElementID element_id)
	Check whether this is a valid league table element ID.

static LeagueTableID	New (Text title, Text header, Text *footer)
	Create a new league table.

static LeagueTableElementID	NewElement (LeagueTableID table, int rating, GSCompany::CompanyID company, Text text, Text score, LinkType link_type, int link_target)
	Create a new league table element.

static bool	UpdateElementData (LeagueTableElementID element, GSCompany::CompanyID company, Text *text, LinkType link_type, int link_target)
	Update the attributes of a league table element.

static bool	UpdateElementScore (LeagueTableElementID element, int rating, Text *score)
	Create a new league table element.

static bool	RemoveElement (LeagueTableElementID element)
	Remove a league table element.

Static Public Attributes
static constexpr LeagueTableID	LEAGUE_TABLE_INVALID = ::LeagueTableID::Invalid()
	An invalid league table id.

static constexpr LeagueTableElementID	LEAGUE_TABLE_ELEMENT_INVALID = ::LeagueTableElementID::Invalid()
	An invalid league table element id.

Detailed Description

Class that handles league table related functions.

To create a league table:

Create the league table
Create league table elements that will be shown in the table in the order of their rating (higher=better).

Member Enumeration Documentation

◆ LinkType

enum GSLeagueTable::LinkType : int

The type of a link.

Enumerator
LINK_NONE	No link.
LINK_TILE	Link a tile.
LINK_INDUSTRY	Link an industry.
LINK_TOWN	Link a town.
LINK_COMPANY	Link a company.
LINK_STORY_PAGE	Link a story page.

Member Function Documentation

◆ IsValidLeagueTable()

static bool GSLeagueTable::IsValidLeagueTable ( LeagueTableID table_id )

static

Check whether this is a valid league table ID.

Parameters

table_id The LeagueTableID to check.

Returns: true iff this league table is valid.

◆ IsValidLeagueTableElement()

static bool GSLeagueTable::IsValidLeagueTableElement ( LeagueTableElementID element_id )

static

Check whether this is a valid league table element ID.

Parameters

element_id The LeagueTableElementID to check.

Returns: true iff this league table element is valid.

◆ New()

static LeagueTableID GSLeagueTable::New	(	Text *	title,
		Text *	header,
		Text *	footer
	)

static

Create a new league table.

Parameters

title	League table title (can be either a raw string, or GSText object).
header	The optional header text for the table (null is allowed).
footer	The optional footer text for the table (null is allowed).

Returns: The new LeagueTableID, or LEAGUE_TABLE_INVALID if it failed.

Precondition: GSCompanyMode::IsDeity.; title != null && len(title) != 0.

◆ NewElement()

static LeagueTableElementID GSLeagueTable::NewElement	(	LeagueTableID	table,
		int	rating,
		GSCompany::CompanyID	company,
		Text *	text,
		Text *	score,
		LinkType	link_type,
		int	link_target
	)

static

Create a new league table element.

Parameters

table	Id of the league table this element belongs to.
rating	Value that elements are ordered by.
company	Company to show the color blob for or COMPANY_INVALID.
text	Text of the element (can be either a raw string, or GSText object).
score	String representation of the score associated with the element (can be either a raw string, or GSText object).
link_type	Type of the referenced object.
link_target	Id of the referenced object.

Returns: The new LeagueTableElementID, or LEAGUE_TABLE_ELEMENT_INVALID if it failed.

Precondition: GSCompanyMode::IsDeity.; IsValidLeagueTable(table).; text != null && len(text) != 0.; score != null && len(score) != 0.; IsValidLink(Link(link_type, link_target)).

◆ RemoveElement()

static bool GSLeagueTable::RemoveElement ( LeagueTableElementID element )

static

Remove a league table element.

Parameters

element Id of the element to update

Returns: True if the action succeeded.

Precondition: GSCompanyMode::IsDeity.; IsValidLeagueTableElement(element).

◆ UpdateElementData()

static bool GSLeagueTable::UpdateElementData	(	LeagueTableElementID	element,
		GSCompany::CompanyID	company,
		Text *	text,
		LinkType	link_type,
		int	link_target
	)

static

Update the attributes of a league table element.

Parameters

element	Id of the element to update
company	Company to show the color blob for or COMPANY_INVALID.
text	Text of the element (can be either a raw string, or GSText object).
link_type	Type of the referenced object.
link_target	Id of the referenced object.

Returns: True if the action succeeded.

Precondition: GSCompanyMode::IsDeity.; IsValidLeagueTableElement(element).; text != null && len(text) != 0.; IsValidLink(Link(link_type, link_target)).

◆ UpdateElementScore()

static bool GSLeagueTable::UpdateElementScore	(	LeagueTableElementID	element,
		int	rating,
		Text *	score
	)

static

Create a new league table element.

Parameters

element	Id of the element to update
rating	Value that elements are ordered by.
score	String representation of the score associated with the element (can be either a raw string, or GSText object).

Returns: True if the action succeeded.

Precondition: GSCompanyMode::IsDeity.; IsValidLeagueTableElement(element).; score != null && len(score) != 0.

Public Types

Static Public Member Functions

Static Public Attributes

Detailed Description

Member Enumeration Documentation

◆ LinkType

Member Function Documentation

◆ IsValidLeagueTable()

◆ IsValidLeagueTableElement()

◆ New()

◆ NewElement()

◆ RemoveElement()

◆ UpdateElementData()

◆ UpdateElementScore()