Tag

Embodies all the information about a single tag. It does not contain any information about its children because that part of the sdl would not have been parsed yet. It is used directly for the StAX/SAX APIs but not for the DOM or Reflection APIs.

struct Tag {

bool allowMixedValuesAndAttributes [@property getter];

bool allowMixedValuesAndAttributes [@property setter];

bool allowBraceAfterNewline [@property getter];

bool allowBraceAfterNewline [@property setter];

bool rejectTypedNumbers [@property getter];

bool rejectTypedNumbers [@property setter];

bool anonymousTagNameIsNull [@property getter];

bool anonymousTagNameIsNull [@property setter];

bool preserveAsonText [@property getter];

bool preserveAsonText [@property setter];

alias useDefaultAson = useStrictAson;

void useStrictAson();

void useLooseAson();

void useProposedAson();

size_t depth;

uint line;

const(char)[] namespace;

const(char)[] name;

auto values;

auto attributes;

bool hasOpenBrace;

void resetForReuse();

void resetForNextTag();

void setNamespace(inout(char)* start, inout(char)* limit);

void setIsAnonymous();

void setName(inout(char)* start, inout(char)* limit);

bool isAnonymous();

bool opEquals(Tag other);

string toString();

void toAson(S sink);

void throwIsUnknown();

void throwIsDuplicate();

void getOneValue(T value);

void getValues(T[] t, size_t minCount);

void enforceNoValues();

void enforceNoAttributes();

void enforceNoChildren();

}

Members

Aliases

useDefaultAson alias useDefaultAson = useStrictAson: For now an alias for useStrictAson. Use this function if you want your code to always use the default mode whatever it may become.

Functions

enforceNoAttributes void enforceNoAttributes()

Undocumented in source. Be warned that the author may not have intended to support it.

enforceNoChildren void enforceNoChildren()

Undocumented in source. Be warned that the author may not have intended to support it.

enforceNoValues void enforceNoValues()

Undocumented in source. Be warned that the author may not have intended to support it.

getOneValue void getOneValue(T value)

Undocumented in source. Be warned that the author may not have intended to support it.

getValues void getValues(T[] t, size_t minCount)

Undocumented in source. Be warned that the author may not have intended to support it.

isAnonymous bool isAnonymous()

Undocumented in source. Be warned that the author may not have intended to support it.

opEquals bool opEquals(Tag other)

resetForNextTag void resetForNextTag()

Resets the tag state to get ready to parse the next tag. Should only be called by the parseAsonTag function. This will clear the namespace/name/values/attributes and increment the depth if the current tag had an open brace.

resetForReuse void resetForReuse()

Gets the tag ready to parse a new sdl tree by resetting the depth and the line number. It is unnecessary to call this before parsing the first sdl tree but would not be harmful. It does not reset the namespace/name/values/attributes because those will be reset by the parser on the next call to parseAsonTag when it calls resetForNextTag().

setIsAnonymous void setIsAnonymous()

Undocumented in source. Be warned that the author may not have intended to support it.

setName void setName(inout(char)* start, inout(char)* limit)

Undocumented in source. Be warned that the author may not have intended to support it.

setNamespace void setNamespace(inout(char)* start, inout(char)* limit)

Undocumented in source. Be warned that the author may not have intended to support it.

throwIsDuplicate void throwIsDuplicate()

Undocumented in source. Be warned that the author may not have intended to support it.

throwIsUnknown void throwIsUnknown()

Undocumented in source. Be warned that the author may not have intended to support it.

toAson void toAson(S sink)

Writes the tag as standard SDL to sink. It will write the open brace '{' but since the tag does not have a knowledge about it's children, its up to the caller to write the close brace '}' after it writes the children to the sink.

toString string toString()

useLooseAson void useLooseAson()

Causes parseAsonTag to throw AsonParseException if a tag's open brace appears after a newline
Causes parseAsonTag to throw AsonParseException if any tag value appears after any tag attribute
Causes parseAsonTag to accept postfix characters after number literals.
Causes parseAsonTag to set anonymous tag names to "content"

useProposedAson void useProposedAson()

Causes parseAsonTag to allow a tag's open brace appears after any number of newlines
Causes parseAsonTag to allow tag values an attributes to mixed in any order
Causes parseAsonTag to throw AsonParseException if a number literal has any postfix characters
Causes parseAsonTag to set anonymous tag names to null

useStrictAson void useStrictAson()

This is the default mode.

Causes parseAsonTag to throw AsonParseException if a tag's open brace appears after a newline
Causes parseAsonTag to throw AsonParseException if any tag value appears after any tag attribute
Causes parseAsonTag to accept postfix characters after number literals.
Causes parseAsonTag to set anonymous tag names to "content"

Properties

allowBraceAfterNewline bool allowBraceAfterNewline [@property getter]: Causes parseAsonTag to allow a tag's open brace to appear after any number of newlines
allowBraceAfterNewline bool allowBraceAfterNewline [@property setter]: Undocumented in source. Be warned that the author may not have intended to support it.
allowMixedValuesAndAttributes bool allowMixedValuesAndAttributes [@property getter]: Normally SDL only allows a tag's attributes to appear after all it's values. This flag causes parseAsonTag to allow values/attributes to appear in any order, i.e. tag attr="my-value" "another-value" # would be valid
allowMixedValuesAndAttributes bool allowMixedValuesAndAttributes [@property setter]: Undocumented in source. Be warned that the author may not have intended to support it.
anonymousTagNameIsNull bool anonymousTagNameIsNull [@property getter]: Causes parseAsonTag to set the tag name to null instead of "content" for anonymous tags. This allows the application to differentiate betweeen "content" tags and anonymous tags.
anonymousTagNameIsNull bool anonymousTagNameIsNull [@property setter]: Undocumented in source. Be warned that the author may not have intended to support it.
preserveAsonText bool preserveAsonText [@property getter]: Prevents parseAsonTag from modifying the given sdl text for things such as processing escaped strings
preserveAsonText bool preserveAsonText [@property setter]: Undocumented in source. Be warned that the author may not have intended to support it.
rejectTypedNumbers bool rejectTypedNumbers [@property getter]: Causes parseAsonTag to throw an exception if it finds any number literals with postfix letters indicating the type
rejectTypedNumbers bool rejectTypedNumbers [@property setter]: Undocumented in source. Be warned that the author may not have intended to support it.

Variables

attributes auto attributes;: The attributes of the tag
depth size_t depth;: The depth of the tag, all root tags start at depth 0.
hasOpenBrace bool hasOpenBrace;: Indicates the tag has an open brace
line uint line;: The line number of the SDL parser after parsing this tag.
name const(char)[] name;: The name of the tag
namespace const(char)[] namespace;: The namespace of the tag
values auto values;: The values of the tag

Tag

Members

Aliases

Functions

Properties

Variables

Meta

Source