Sets the current translation result to the given value. Overrules the standard output a translation generates.
Valid only within the 'replacement' field in translation items.

Syntax

Smartsite SXML	Copy Code
translation.setresult(any value)

Parameters

Name	Data Type	Description
value	Any	The value to set as result of the translation.

Return Value

None.

Examples

Translation Vipers Example

In this example, a word is added to a sentence and a word count is performed.

Smartsite SXML	Copy Code
<se:pagetranslations id="helpers" rem="helper functions implemented as page translations"> <se:collection> <se:member name="addword(str,word)" rem="add a word to an existing sentence"> {translation.setresult( string.trim(translation.arg(str)) + ' ' + string.trim(translation.arg(word)) )} </se:member> <se:member name="countwords(str)" rem="count the number of words in a string"> {buffer.set(res, string.replace(translation.arg(1),'\w+','x',UseRegExp) )} {translation.setresult( string.length( string.removewhitespace($res) ) )} </se:member> </se:collection> </se:pagetranslations> {buffer.set(sentence,'The lazy dog jumps over de crazy')} Source text: {buffer.get(sentence)} After append: {translation.helpers.addword($sentence, 'dog')} Word count: {translation.helpers.countwords($sentence)}

Smartsite SXML

Copy Code

<se:pagetranslations id="helpers" rem="helper functions implemented as page translations">
    <se:collection>
        <se:member name="addword(str,word)" rem="add a word to an existing sentence">
            {translation.setresult(
                string.trim(translation.arg(str)) + ' ' + string.trim(translation.arg(word))
            )}
        </se:member>
        <se:member name="countwords(str)" rem="count the number of words in a string">
            {buffer.set(res,
                string.replace(translation.arg(1),'\w+','x',UseRegExp)
            )}
            {translation.setresult(
                string.length( string.removewhitespace($res) )
            )}
        </se:member>
    </se:collection>
</se:pagetranslations>

{buffer.set(sentence,'The lazy dog jumps over de crazy')}

Source text: {buffer.get(sentence)}

After append: {translation.helpers.addword($sentence, 'dog')}

Word count: {translation.helpers.countwords($sentence)}

Translation.Return() Example

When translations reach a certain complexity, you can use translation.return() to immediately stop execution. This avoids having to use if or switch statements to prevent execution of other code below the current statement.

Translation.Return() immediately returns to the caller, with the given returnValue, or with the result previously set with translation.setresult().

Note that standard replacement output of the translation will not be used when using translation.return(). You must use translation.setresult(), translation.setnullresult(), or the returnValue argument of translation.return().

Smartsite SXML	Copy Code
<se:pagetranslations id="helpers"> <se:collection> <se:member name="test()"> Hello! {translation.return(1)} {sys.throwexception(ApplicationError, "Unreachable code!")} </se:member> </se:collection> </se:pagetranslations> {translation.helpers.test()}

Smartsite SXML

Copy Code

<se:pagetranslations id="helpers">
    <se:collection>
        <se:member name="test()">
            Hello!
            {translation.return(1)}
            {sys.throwexception(ApplicationError, "Unreachable code!")}
        </se:member>
    </se:collection>
</se:pagetranslations>

{translation.helpers.test()}

SXML