use locale;
use strings;

// A line in the file, which can be a comment (or a blank line), an entry, or
// a localized entry.
export type line = (blank | comment | group_header | entry);

// A blank line.
// Specification: §3.1
export type blank = void;

// A comment.
// Specification: §3.1
export type comment = str;

// A group header.
// Specification: §3.2
export type group_header = str;

// An entry in a desktop file.
// Specification: §3.3, §5
export type entry = struct {
	group:  str,
	key:    str,
	value:  str,
	locale: locale::locale,
};

// Duplicates an [[entry]]. Use [[entry_finish]] to get rid of it.
export fn entry_dup(entr: entry) entry = entry {
	group  = strings::dup(entr.group),
	key    = strings::dup(entr.key),
	value  = strings::dup(entr.value),
	locale = locale::dup(entr.locale),
};

// Frees memory associated with an [[entry]].
export fn entry_finish(entr: entry) void = {
	free(entr.group);
	free(entr.key);
	free(entr.value);
	locale::finish(entr.locale);
};