#include <Style.h>

Inheritance diagram for Style:

Public Member Functions
Class *	_Style (void)
	The Style archetype. More...

void	addAttribute (Style self, const char attr, ident value)
	Adds or replaces the given attribute with `value`. More...

void	addAttributes (Style self, const Dictionary attributes)
	Adds or replaces the attribtues in `attributes` to this Style. More...

void	addBoolAttribute (Style self, const char attr, _Bool value)
	Adds or replaces the given attribute with `value`. More...

void	addCharactersAttribute (Style self, const char attr, const char *value)
	Adds or replaces the given attribute with `value`. More...

void	addColorAttribute (Style self, const char attr, const SDL_Color *value)
	Adds or replaces the given attribute with `value`. More...

void	addDoubleAttribute (Style self, const char attr, double value)
	Adds or replaces the given attribute with `value`. More...

void	addEnumAttribute (Style self, const char attr, const EnumName *names, int value)
	Adds or replaces the given attribute with `value`. More...

void	addFloatAttribute (Style self, const char attr, float value)
	Adds or replaces the given attribute with `value`. More...

void	addIntegerAttribute (Style self, const char attr, int value)
	Adds or replaces the given attribute with `value`. More...

void	addPointAttribute (Style self, const char attr, const SDL_Point *value)
	Adds or replaces the given attribute with `value`. More...

void	addRectangleAttribute (Style self, const char attr, const SDL_Rect *value)
	Adds or replaces the given attribute with `value`. More...

void	addSelector (Style self, Selector selector)
	Adds the given Selector to this Style. More...

void	addSizeAttribute (Style self, const char attr, const SDL_Size *value)
	Adds or replaces the given attribute with `value`. More...

ident	attributeValue (const Style self, const char attr)

Style *	initWithAttributes (Style self, const Dictionary attributes)
	Initializes this Style with the given attributes. More...

Style *	initWithRules (Style self, const char rules)
	Initializes this Style with the given CSS selector rules. More...

_Bool	isComputedEqual (const Style self, const Style other)
	Performs a fast, rule-based comparison of this Style to the given Style. More...

Array *	parse (const char *css)
	Parses the null-terminated C string of CSS definitions into an Array of Styles. More...

void	removeAllAttributes (Style *self)
	Removes all attributes from this Style. More...

void	removeAttribute (Style self, const char attr)
	Removes the attribute with the given name. More...

Data Fields
Dictionary *	attributes

Object	object
	The superclass. More...

Array *	selectors
	The Selectors. More...

Protected Attributes
StyleInterface *	interface
	The interface. More...

Detailed Description

The Style type.

Definition at line 43 of file Style.h.

Member Function Documentation

◆ _Style()

Class * _Style ( void )

The Style archetype.

Returns: The Style Class.

Definition at line 537 of file Style.c.

                    {
    static Class *clazz;
    static Once once;
 
    do_once(&once, {
        clazz = _initialize(&(const ClassDef) {
            .name = "Style",
            .superclass = _Object(),
            .instanceSize = sizeof(Style),
            .interfaceOffset = offsetof(Style, interface),
            .interfaceSize = sizeof(StyleInterface),
            .initialize = initialize,
        });
    });
 
    return clazz;
}

◆ addAttribute()

void addAttribute	(	Style *	self,
		const char *	attr,
		ident	value
	)

Adds or replaces the given attribute with value.

Parameters

self	The Style.
attr	The attribute name.
value	The attribute value.

Remarks: The value must be an Object and not a primitive.

Definition at line 102 of file Style.c.

                                                                     {
 
    assert(attr);
    assert(value);
 
    char *key = strtrim(attr);
    assert(key);
 
    $((MutableDictionary *) self->attributes, setObjectForKeyPath, value, key);
 
    free(key);
}

◆ addAttributes()

void addAttributes	(	Style *	self,
		const Dictionary *	attributes
	)

Adds or replaces the attribtues in attributes to this Style.

Parameters

self	The Style.
attributes	The attributes.

Definition at line 119 of file Style.c.

                                                                     {
 
    assert(attributes);
 
    $((MutableDictionary *) self->attributes, addEntriesFromDictionary, attributes);
}

◆ addBoolAttribute()

void addBoolAttribute	(	Style *	self,
		const char *	attr,
		_Bool	value
	)

Adds or replaces the given attribute with value.

Parameters

self	The Style.
attr	The attribute name.
value	The attribute value.

Definition at line 130 of file Style.c.

                                                                         {
    $(self, addAttribute, attr, $$(Boole, valueof, value));
}

◆ addCharactersAttribute()

void addCharactersAttribute	(	Style *	self,
		const char *	attr,
		const char *	value
	)

Adds or replaces the given attribute with value.

Parameters

self	The Style.
attr	The attribute name.
value	The attribute value.

Definition at line 138 of file Style.c.

                                                                                     {
 
    String *string = $$(String, stringWithCharacters, value);
 
    $(self, addAttribute, attr, string);
 
    release(string);
}

◆ addColorAttribute()

void addColorAttribute	(	Style *	self,
		const char *	attr,
		const SDL_Color *	value
	)

Adds or replaces the given attribute with value.

Parameters

self	The Style.
attr	The attribute name.
value	The attribute value.

Definition at line 151 of file Style.c.

                                                                                     {
 
    Number *r = $$(Number, numberWithValue, color->r);
    Number *g = $$(Number, numberWithValue, color->g);
    Number *b = $$(Number, numberWithValue, color->b);
    Number *a = $$(Number, numberWithValue, color->a);
 
    Array *array = $$(Array, arrayWithObjects, r, g, b, a, NULL);
 
    $(self, addAttribute, attr, array);
 
    release(array);
    release(r);
    release(g);
    release(b);
    release(a);
}

◆ addDoubleAttribute()

void addDoubleAttribute	(	Style *	self,
		const char *	attr,
		double	value
	)

Adds or replaces the given attribute with value.

Parameters

self	The Style.
attr	The attribute name.
value	The attribute value.

Definition at line 173 of file Style.c.

                                                                            {
 
    Number *number = $$(Number, numberWithValue, value);
 
    $(self, addAttribute, attr, number);
 
    release(number);
}

◆ addEnumAttribute()

void addEnumAttribute	(	Style *	self,
		const char *	attr,
		const EnumName *	names,
		int	value
	)

Adds or replaces the given attribute with value.

Parameters

self	The Style.
attr	The attribute name.
names	The EnumNames from which to derrive the attribute value.
value	The attribute value.

Definition at line 186 of file Style.c.

                                                                                              {
 
    String *string = nameof(names, value);
 
    $(self, addAttribute, attr, string);
 
    release(string);
}

◆ addFloatAttribute()

void addFloatAttribute	(	Style *	self,
		const char *	attr,
		float	value
	)

Adds or replaces the given attribute with value.

Parameters

self	The Style.
attr	The attribute name.
value	The attribute value.

Definition at line 199 of file Style.c.

                                                                          {
    $(self, addDoubleAttribute, attr, value);
}

◆ addIntegerAttribute()

void addIntegerAttribute	(	Style *	self,
		const char *	attr,
		int	value
	)

Adds or replaces the given attribute with value.

Parameters

self	The Style.
attr	The attribute name.
value	The attribute value.

Definition at line 207 of file Style.c.

                                                                          {
    $(self, addDoubleAttribute, attr, value);
}

◆ addPointAttribute()

void addPointAttribute	(	Style *	self,
		const char *	attr,
		const SDL_Point *	value
	)

Adds or replaces the given attribute with value.

Parameters

self	The Style.
attr	The attribute name.
value	The attribute value.

Definition at line 215 of file Style.c.

                                                                                     {
 
    Number *x = $$(Number, numberWithValue, value->x);
    Number *y = $$(Number, numberWithValue, value->y);
 
    Array *array = $$(Array, arrayWithObjects, x, y, NULL);
 
    $(self, addAttribute, attr, array);
 
    release(array);
    release(x);
    release(y);
}

◆ addRectangleAttribute()

void addRectangleAttribute	(	Style *	self,
		const char *	attr,
		const SDL_Rect *	value
	)

Adds or replaces the given attribute with value.

Parameters

self	The Style.
attr	The attribute name.
value	The attribute value.

Definition at line 233 of file Style.c.

                                                                                        {
 
    Number *x = $$(Number, numberWithValue, value->x);
    Number *y = $$(Number, numberWithValue, value->y);
    Number *w = $$(Number, numberWithValue, value->w);
    Number *h = $$(Number, numberWithValue, value->h);
 
    Array *array = $$(Array, arrayWithObjects, x, y, w, h, NULL);
 
    $(self, addAttribute, attr, array);
 
    release(array);
    release(x);
    release(y);
    release(w);
    release(h);
}

◆ addSelector()

void addSelector	(	Style *	self,
		Selector *	selector
	)

Adds the given Selector to this Style.

Parameters

self	The Style.
selector	The Selector.

Definition at line 255 of file Style.c.

                                                         {
 
    assert(selector);
 
    $((MutableArray *) self->selectors, addObject, selector);
}

◆ addSizeAttribute()

void addSizeAttribute	(	Style *	self,
		const char *	attr,
		const SDL_Size *	value
	)

Adds or replaces the given attribute with value.

Parameters

self	The Style.
attr	The attribute name.
value	The attribute value.

Definition at line 266 of file Style.c.

                                                                                   {
 
    Number *w = $$(Number, numberWithValue, value->w);
    Number *h = $$(Number, numberWithValue, value->h);
 
    Array *array = $$(Array, arrayWithObjects, w, h, NULL);
 
    $(self, addAttribute, attr, array);
 
    release(array);
    release(w);
    release(h);
}

◆ attributeValue()

ident attributeValue	(	const Style *	self,
		const char *	attr
	)

Parameters

self	The Style.
attr	The attribute name.

Returns: The attribute value.

Definition at line 284 of file Style.c.

                                                                 {
    return $((Dictionary *) self->attributes, objectForKeyPath, attr);
}

◆ initWithAttributes()

Style * initWithAttributes	(	Style *	self,
		const Dictionary *	attributes
	)

Initializes this Style with the given attributes.

Parameters

self	The Style.
attributes	The attributes.

Returns: The initialized Style, or NULL on error.

See also: View::awakeWithDictionary(View *, const Dictionary *)

Definition at line 292 of file Style.c.

                                                                            {
 
    self = $(self, initWithRules, NULL);
    if (self) {
        if (attributes) {
            $(self, addAttributes, attributes);
        }
    }
 
    return self;
}

◆ initWithRules()

Style * initWithRules	(	Style *	self,
		const char *	rules
	)

Initializes this Style with the given CSS selector rules.

Parameters

self	The Style.
rules	A null-terminated C string of one or more Selector rules.

Returns: The initialized Style, or NULL on error.

See also: Selector::parse(const char *)

Definition at line 308 of file Style.c.

                                                            {
 
    self = (Style *) super(Object, self, init);
    if (self) {
 
        self->selectors = $$(Selector, parse, rules);
        assert(self->selectors);
 
        for (size_t i = 0; i < self->selectors->count; i++) {
            ((Selector *) self->selectors->elements[i])->style = self;
        }
 
        self->attributes = (Dictionary *) $$(MutableDictionary, dictionaryWithCapacity, 4);
        assert(self->attributes);
    }
 
    return self;
}

◆ isComputedEqual()

_Bool isComputedEqual	(	const Style *	self,
		const Style *	other
	)

Performs a fast, rule-based comparison of this Style to the given Style.

Parameters

self	The Style.
other	The Style to test for computed equality.

Returns: True if the given Style is deemed equal, false otherwise.

Remarks: This method is optimized to quickly determine if two computed Styles should contain the same attributes based on their Selector rules. For true equality, use isEqual.

Definition at line 331 of file Style.c.

                                                                    {
 
    assert(other);
 
    if (self->selectors->count == other->selectors->count) {
 
        for (size_t i = 0; i < self->selectors->count; i++) {
 
            const Selector *this = $(self->selectors, objectAtIndex, i);
            const Selector *that = $(other->selectors, objectAtIndex, i);
 
            if (strcmp(this->rule, that->rule)) {
                return false;
            }
        }
 
        return true;
    }
 
    return false;
}

◆ parse()

Array * parse ( const char * css )

Parses the null-terminated C string of CSS definitions into an Array of Styles.

Parameters

css	The CSS definitions.

Returns: An Array of Styles.

Definition at line 274 of file Selector.c.

                                       {
 
    MutableArray *selectors = $$(MutableArray, arrayWithCapacity, 4);
    assert(selectors);
 
    if (rules) {
 
        const char *c = rules;
        while (*c) {
            const size_t size = strcspn(c, ",");
            if (size) {
                char *rule = calloc(1, size + 1);
                assert(rule);
 
                strncpy(rule, c, size);
 
                Selector *selector = $(alloc(Selector), initWithRule, rule);
                assert(selector);
 
                $(selectors, addObject, selector);
 
                release(selector);
                free(rule);
            }
            c += size;
            c += strspn(c, ", \t\n");
        }
    }
 
    return (Array *) selectors;
}

◆ removeAllAttributes()

void removeAllAttributes ( Style * self )

Removes all attributes from this Style.

Parameters

self	The Style.

Definition at line 495 of file Style.c.

                                             {
    $((MutableDictionary *) self->attributes, removeAllObjects);
}

◆ removeAttribute()

void removeAttribute	(	Style *	self,
		const char *	attr
	)

Removes the attribute with the given name.

Parameters

self	The Style.
attr	The attribute name.

Definition at line 487 of file Style.c.

                                                           {
    $((MutableDictionary *) self->attributes, removeObjectForKeyPath, attr);
}

Field Documentation

◆ attributes

Dictionary* Style::attributes

The attributes.

Definition at line 59 of file Style.h.

◆ interface

StyleInterface* Style::interface

protected

The interface.

Definition at line 54 of file Style.h.

◆ object

Object Style::object

The superclass.

Definition at line 48 of file Style.h.

◆ selectors

Array* Style::selectors

The Selectors.

Definition at line 64 of file Style.h.

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

Sources/ObjectivelyMVC/Style.h
Sources/ObjectivelyMVC/Style.c

Public Member Functions

Data Fields

Protected Attributes

Detailed Description

Member Function Documentation

◆ _Style()

◆ addAttribute()

◆ addAttributes()

◆ addBoolAttribute()

◆ addCharactersAttribute()

◆ addColorAttribute()

◆ addDoubleAttribute()

◆ addEnumAttribute()

◆ addFloatAttribute()

◆ addIntegerAttribute()

◆ addPointAttribute()

◆ addRectangleAttribute()

◆ addSelector()

◆ addSizeAttribute()

◆ attributeValue()

◆ initWithAttributes()

◆ initWithRules()

◆ isComputedEqual()

◆ parse()

◆ removeAllAttributes()

◆ removeAttribute()

Field Documentation

◆ attributes

◆ interface

◆ object

◆ selectors