Literals

struct CowlLiteral

Represents a Literal in the OWL 2 specification.

Pseudo-extends: CowlAnnotValue

CowlLiteral *cowl_literal(CowlString *value, CowlAny *dt_or_lang)

Returns a literal.

Note

You must release the returned object via cowl_release().

Parameters:

• value – The value.

• dt_or_lang – optional The datatype, language tag, or NULL for a plain literal.

Returns:

Literal, or NULL on error.

CowlLiteral *cowl_literal_plain(UString value)

Returns a plain literal given the string representations of its value.

Note

You must release the returned object via cowl_release().

Parameters:

• value – The value.

Returns:

Literal, or NULL on error.

CowlLiteral *cowl_literal_typed(UString value, CowlDatatype *dt)

Returns a typed literal given the string representation of its value and its datatype.

Note

You must release the returned object via cowl_release().

Parameters:

• value – The value.

• dt – The datatype.

Returns:

Literal, or NULL on error.

CowlLiteral *cowl_literal_lang(UString value, UString lang)

Returns a language-tagged literal given the string representations of its value and language tag.

Note

You must release the returned object via cowl_release().

Parameters:

• value – The value.

• lang – The language tag.

Returns:

Literal, or NULL on error.

CowlLiteral *cowl_literal_plain_from_literal(char const value[])

Returns a plain literal given the string literal representing its value.

Note

You must release the returned object via cowl_release().

Parameters:

• value – The value.

Returns:

Literal, or NULL on error.

CowlLiteral *cowl_literal_plain_from_static(char const value[])

Returns a plain literal given the string literal representing its value.

Deprecated:

Use cowl_literal_plain_from_literal instead.

Note

You must release the returned object via cowl_release().

Parameters:

• value – The value.

Returns:

Literal, or NULL on error.

CowlLiteral *cowl_literal_typed_from_literal(char const value[], CowlDatatype *dt)

Returns a typed literal given the string literal representing its value and its datatype.

Note

You must release the returned object via cowl_release().

Parameters:

• value – The value.

• dt – The datatype.

Returns:

Literal, or NULL on error.

CowlLiteral *cowl_literal_typed_from_static(char const value[], CowlDatatype *dt)

Returns a typed literal given the string literal representing its value and its datatype.

Deprecated:

Use cowl_literal_typed_from_literal instead.

Note

You must release the returned object via cowl_release().

Parameters:

• value – The value.

• dt – The datatype.

Returns:

Literal, or NULL on error.

CowlLiteral *cowl_literal_lang_from_literal(char const value[], char const lang[])

Returns a language-tagged literal given the string literals representing its value and language tag.

Note

You must release the returned object via cowl_release().

Parameters:

• value – The value.

• lang – The language tag.

Returns:

Literal, or NULL on error.

CowlLiteral *cowl_literal_lang_from_static(char const value[], char const lang[])

Returns a language-tagged literal given the string literals representing its value and language tag.

Deprecated:

Use cowl_literal_lang_from_literal instead.

Note

You must release the returned object via cowl_release().

Parameters:

• value – The value.

• lang – The language tag.

Returns:

Literal, or NULL on error.

CowlDatatype *cowl_literal_get_datatype(CowlLiteral *literal)

Gets the datatype.

Parameters:

• literal – The literal.

Returns:

The datatype.

CowlString *cowl_literal_get_value(CowlLiteral *literal)

Gets the value.

Parameters:

• literal – The literal.

Returns:

The value.

CowlString *cowl_literal_get_lang(CowlLiteral *literal)

Gets the language tag.

Parameters:

• literal – The literal.

Returns:

The language tag.