This source element type is used to copy a directory from the source location to the destination location. All included subdirectories will also copied. The optional attribute srcdir ist used for directories that are located in a different place in the source hierarchy and/or have a different name.

This source element type is used for files that are used without modification. The source file is copied from the source location to the destination location. The optional attributes srcdir and srcfile are used for files that are located in a different place in the source hierarchy and/or have a different source file name.

The value of attribute type should be def or impl when the file contains definitions (e.g. a C/C++ Header) or implementations. For most other files the type misc is appropriate.

This source element type is used to append text or another file to a file. The content is taken either from a file if srcdir and srcfile are given, or from a string if content is given. If taken from a string, attribute encoding can be used to specify the character encoding of the string content. The attribute mode is used to specify the point at which this content is appended to the file, i.e. before or after the child parts of the current node's parent part are visited. The default value is before .

This source element type is used to copy an XML document and optionally to save the copy to a file. Special conditional attributes on the nodes of the XML document are dynamically evaluated to decide whether this node (and its subnodes) are copied into the result document. The name of the evaluated condition attribute is specified using the attribute conditionname and defaults to condition . If the attribute copycondition is not set to false , the condition attribute is copied into the target document as well.

The condition itself has to be a valid XPath expression and may use the XSLT extension functions defined in the following namespaces. Calls to these functions have to be prefixed by the given namespace prefix followed by a colon (":"), e.g. F .

For a description of the pure::variants XSLT extension functions see Table 9.10, “Extension functions providing model information” . For a description of the EXSLT extension functions see http://www.exslt.org .

In the example document given below after processing with an ps:condxml transformation, the resulting XML document only contains an introductory chapter if the corresponding feature WithIntroduction is selected.

<?xml version='1.0'?>
<text>
  <chapter condition="WithIntroduction">
    This is some introductory text.
  </chapter>
  <chapter>
    This text is always in the resulting xml output.
  </chapter>
</text>

Source document:

<?xml version='1.0'?>
<version xmlns:pv="http://www.pure-systems.com/purevariants">
  <pv:value-of select="pv:getAttributeValue('Version','ps:feature','version')"/>
</version>

Result document:

<?xml version='1.0'?>
<version xmlns:pv="http://www.pure-systems.com/purevariants">
  1.0
</version>

This source element type is used to copy a text document and optionally to save the copy to a file. Special statements in the text document are evaluated to decide which parts of the text document are copied into the result document, or to insert additional text. If no text document encoding is given, then UTF-8 encoding is assumed.

The statements (macro-like calls) that can be used in the text document are listed in the following table.

These macros can occur everywhere in the text document and are directly matched, i.e. independently of the surrounding text. The conditions of PV:IFCOND and PV:ELSEIFCOND and the expression of PV:EVAL are the same as the conditions described for source element type ps:condxml (see Section 9.5.4, “ ps:condxml ” for details).

Conditional text blocks can be nested. That means, that a PV:IFCOND block can contain another PV:IFCOND block defining a nested conditional text block that is evaluated only if the surrounding text block is included in the resulting text output.

For each macro a version with suffix LN exists, i.e. PV:IFCONDLN , PV:ELSEIFCONDLN , PV:ELSECONDLN , PV:ENDCONDLN , and PV:EVALLN . These macros affect the whole line and are only allowed if there is no other macro call in the same line. All characters before and behind such a macro call are removed from the line. It is allowed to mix macros with and without suffix LN , e.g. PV:IFCONDLN can be followed by PV:ENDCOND and PV:IFCOND by PV:ENDCONDLN .

In the example document given below after processing with an ps:condtext transformation, the resulting text document only contains an introductory chapter if the corresponding feature WithIntroduction is selected.

PVSCL:IFCOND(WithIntroduction)
    This text is in the resulting text output 
    if feature WithIntroduction is selected.
PV:ELSECOND
    This text is in the resulting text output 
    if feature WithIntroduction is not selected.  
PV:ENDCOND
    This text is always in the resulting text output.

This source element type is used to copy an XML document and optionally to save the copy to a file. Special conditional attributes on the nodes of the XML document are dynamically evaluated to decide whether this node (and its subnodes) are copied into the result document. The name of the evaluated condition attribute is specified using the attribute conditionname and defaults to pv:condition . If the attribute copycondition is not set to false , the condition attribute is copied into the target document as well. If the attribute valuesubstitution is set to true , the content of all attribute values of the XML document will be handled as Section 9.5.7, “ ps:pvscltext ” .

The condition itself has to be a valid pvSCL expression. For details on writing pvSCL expressions, see Section 9.7, “Expression Language pvSCL” .

In the example document given below after processing with an ps:pvsclxml transformation, the resulting XML document only contains an introductory chapter if the corresponding feature WithIntroduction is selected.

<?xml version='1.0'?>
<text xmlns:pv="http://www.pure-systems.com/purevariants">
  <chapter pv:condition="WithIntroduction">
    This is some introductory text.
  </chapter>
  <chapter>
    This text is always in the resulting xml output.
  </chapter>
</text>

Source document:

<?xml version='1.0'?>
<version xmlns:pv="http://www.pure-systems.com/purevariants">
  <pv:eval>Version->version</pv:eval>
</version>

Result document:

<?xml version='1.0'?>
<version xmlns:pv="http://www.pure-systems.com/purevariants">
  1.0
</version>

This source element type is used to copy a text document and optionally to save the copy to a file. Special statements in the text document are evaluated to decide which parts of the text document are copied into the result document, or to insert additional text. If no text document encoding is given, then UTF-8 encoding is assumed.

The statements (macro-like calls) that can be used in the text document are listed in the following table.

These statements can occur everywhere in the text document and are directly matched, i.e. independently of the surrounding text. The conditions of PVSCL:IFCOND and PVSCL:ELSEIFCOND and the expression of PVSCL:EVAL are the same as the conditions described for source element type ps:pvsclxml (see Section 9.5.6, “ ps:pvsclxml ” for details), except for a list of comma-separated flags that can follow the pvSCL code. Following flags are supported.

/* PVSCL:IFCOND(Temperature,LINE) */
initializeSensor("temperature",PVSCL:EVAL(Temperature->max));
/* PVSCL:ELSECOND */
disableSensor("temperature");
/* PVSCL:ENDCOND */

initializeSensor("temperature",60);

//PVSCL:IFCOND(WindSensor,LINE)updateSensor("wind");PVSCL:ENDCOND

updateSensor("wind");

Conditional text blocks can be nested. That means, that a PVSCL:IFCOND block can contain another PVSCL:IFCOND block defining a nested conditional text block that is evaluated only if the surrounding text block is included in the resulting text output.

In the example document given below after processing with an ps:pvscltext transformation, the resulting text document only contains an introductory chapter if the corresponding feature WithIntroduction is selected.

PVSCL:IFCOND(WithIntroduction)
    This text is in the resulting text output 
    if feature WithIntroduction is selected.
PVSCL:ELSECOND
    This text is in the resulting text output 
    if feature WithIntroduction is not selected.  
PVSCL:ENDCOND
    This text is always in the resulting text output.

This source element type is used to generate C/C++-Header files containing #define <flag> <flagValue> statements. The <flagValue> part of these statements is the value of the attribute Value of the parent part element. The name of the flag is specified by the attribute flag . See the section called “Providing Values for Part Elements” for more details. The same file location can be used in more than one ps:flagfile definition to include multiple #define statements in a single file.

#ifndef __guard_DEBUG
#define __guard_DEBUG 
#undef DEBUG 
#define DEBUG 1 
#endif

This source element type is used to generate makefile variables using a <variable> += '<varValue>' statement. The <varValue> part of the statement is the value of the attribute Value of the parent part element. The name of the variable is specified by the attribute variable . See the section called “Providing Values for Part Elements” for more details. The attribute set defines if the variable is set to the value (true) or if the variable is extended by the value (false). The generated code is compatible with the gmake system. To generate code for a different make system the attribute makesystem can be used. The same file location can be used for more than one ps:makefile element to include multiple makefile variables in a single file.

CXX_OPTFLAGS += "-O6"

This source element type is used to support different classes with different names that are concurrently used in the same place in the class hierarchy. This transformation is C/C++ specific and can be used as an efficient replacement for templates in some cases. This definition is only used in conjunction with the part type ps:classalias . A typedef aliasValue alias; statement is generated by the standard transformation for this element type. aliasValue is the value of the attribute Value of the parent part element. Furthermore, in the standard transformation the Variant Result Model is searched for a class with name aliasValue and #include statements are generated for each of its ps:file source elements that have a type attribute with the value 'def'. If the alias name contains a namespace prefix, corresponding namespace blocks are generated around the typedef statement.

#ifndef __PCConn_include__ 
#define __PCConn_include__ 
#include "C:\Weather Station Example\output\usr\wm-src\NoConn.h"
namespace io {
namespace net {
typedef NoConn PCConn; 
}
}
#endif __PCConn_include__

This source element type is used to create a symbolic link to a file or directory named <linktarget> .