org.vishia.fbcl.fblock

Class DinExpr_FBcl

java.lang.Object

org.vishia.fbcl.fblock.Pin_FBcl

org.vishia.fbcl.fblock.Dinout_FBcl

org.vishia.fbcl.fblock.Din_FBcl

org.vishia.fbcl.fblock.DinExpr_FBcl

public class DinExpr_FBcl
extends Din_FBcl

This class presents an input of a FBexpr_FBcl.

• See Dinout_FBcl.dType(). The expression pin has a forward propagated DType stored in dTypeIxPart. This can be deviant to the inner DType of the FBexpr_FBcl.dTypeAllDin. Also a cast on input is possible.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	DinExpr_FBcl.DTypeDesignation

Nested classes/interfaces inherited from class org.vishia.fbcl.fblock.Pin_FBcl

Pin_FBcl.XXXXXEKind

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean	bCastToDTypePart Only if this flag is set, the type is given as text, and should be used to cast the part after modification of the input with K pin.
protected DType_FBcl.DtIxmdl	dTypeIxPart A possible specific data type for the part of the expression after the modification operation used for casting after modification if also bCastToDTypePart is set and used for the output data type propagation.
private DinExprK_FBcl	pinK The associated K pin for a second input of a constant to operate.
protected java.lang.String	sElemDst This is either used for setElement expression (to set an array element or a struct element in the correspond variable after expression) or also to store a given component name for sliced accesses.
protected java.lang.String	sElemSrc If not null or "", then it describes the access to an element in the connected doutSrc struct as textual information written in an din.
java.lang.String	sOperator The operator for the pin, consisting of till three parts.
static java.lang.String	sVersion Version, history and license.

Fields inherited from class org.vishia.fbcl.fblock.Din_FBcl

bBreakChain, bNonFBarray, dTypeCastInp, ixArrayAccess, mEvCluster, nullArray

Fields inherited from class org.vishia.fbcl.fblock.Dinout_FBcl

steptime, zVectorDim

Fields inherited from class org.vishia.fbcl.fblock.Pin_FBcl

connectDst, connectSrc, fb, name, version, xy

Constructor Summary

Constructors

Constructor and Description
DinExpr_FBcl(DinType_FBcl pint, java.lang.String name, FBexpr_FBcl fb, Module_FBcl.CreateMdl mdlcr) Constructor

Method Summary

Modifier and Type	Method and Description
char	cUnaryOperator()
DinExpr_FBcl.DTypeDesignation	dTypeDsgn(java.lang.String sSAT, DinExpr_FBcl x1) Builds a String usable for code generation with the DType designation to call a proper operation.
DType_FBcl.DtIxmdl	dTypeIxPart() Returns the casting DType for the expression part or also the DType for forward propagation to the exprOut.
DType_FBcl	dTypePart()
DType_FBcl	dTypePropgFwd()
(package private) DType_FBcl.DtIxmdl	getDTypeIxMdl() Returns the non solved DType for non dedicated types.
java.lang.String	getElemDst() See sElemDst
java.lang.String	getElemSrc() See sElemSrc
(package private) DinExpr_FBcl.DTypeDesignation	getInfoAdaptPartforAddToDTypeAll(java.lang.String sSat)
DinExprK_FBcl	pinK()
java.lang.String	setDType(DType_FBcl.DtIxmdl dtixSrcArg, LogMessage log) Overridden form for Dinout_FBcl#setDType(DType_FBcl, DType_FBcl, org.vishia.msgDispatch.LogMessage): It saves the src in dTypePart() for proper propagation to output if all DinExpr are propagated.
boolean	setDTypeExprPart(DType_FBcl.DtIxmdl dtix, boolean castTo) Sets initial the dTypePart() and also the bCastToDTypePart.
void	setElementDst(java.lang.String val) See getElemDst()
void	setElemSrc(java.lang.String val) See getElemDst()
void	setPinK(DinExprK_FBcl pinK)
boolean	shouldCastPart() Cast part does not mean, cast to the FBexpr_FBcl.dTypeAllDin.
java.lang.String	sOperator()

Methods inherited from class org.vishia.fbcl.fblock.Din_FBcl

bCastDType, breakEventChain, dTypeCastInp, dTypeConst, dTypeDecl, dTypePropg, getConnSrc, getConstant, getConstant, getDintype, getOnlyoneAssocEvin, iterConnSrcConditional, iterEvin, nonFBarray, operationsType, replaceAliasConst, setBreakEventChain, setConstant, setConstantDirect, setDTypeCastInp, setDTypeConst, setDTypePropg, setNonFBarray, toString, XXXconnectSrc

Methods inherited from class org.vishia.fbcl.fblock.Dinout_FBcl

dtArrayCpp, dType, dType, dTypeChar, dTypeCix, dtypeCpp, dTypeFBpinNonArray, dTypeIxMdl, explainDTypeIx, getSteptime, getSteptimeStr, isComplexDType, namePin, propagateSteptime, sDTypeIx, sDTypeIx, sDTypeIxId, XXXdTypeIxMdl

Methods inherited from class org.vishia.fbcl.fblock.Pin_FBcl

addEvchain, addEvchainDepending, changePinType, connDst, connectFrom, connectFrom, connectFrom, connSrc, containsEvchain, containsOtherEvchain, dinType, doutType, evChainHex, evinType, evoutType, getFirstConnDst, getFirstConnSrc, getMaskEvinMdlChainDriven, getMaskEvoutMdlBackChainDriven, getOneConnSrc, getOneConnSrc, graphicPos, isEventBackChainDriven, isEventBackChainDriven, isEventChainDriven, isEventChainDriven, isEventChainDriven, isEventChainDriven, isKind, isNotKind, isUpdatePin, iterConnDst, iterConnSrc, iterEvchainDep, iterEvchainShow, nameFBpin, nameFBpin, nameIdentifier, nrofConnDst, nrofConnSrc, pinNameFB, pint, pinType, removeConnectDst, removeConnectSrc, removeConnSrcAll, removePinSimpleInConnDst, setEventBackChainDriven, setEventChainDriven, sMaskHexEvinMdlChainDriven, spec, spec, throwError, toString, XXXremoveConnectSrc, XXXremoveConnSrc, XXXsetEventBackChainDriven

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

sVersion

public static final java.lang.String sVersion

Version, history and license. Changes:

• 2025-01-06: new Dinout_FBcl.dType() for expression instances
• 20xx Hartmut: created, more simple as the before used org.vishia.mainCmd.MainCmd.

Copyright/Copyleft: For this source the LGPL Lesser General Public License, published by the Free Software Foundation is valid. It means:

1. You can use this source without any restriction for any desired purpose.
2. You can redistribute copies of this source to everybody.
3. Every user of this source, also the user of redistribute copies with or without payment, must accept this license for further using.
4. But the LPGL is not appropriate for a whole software product, if this source is only a part of them. It means, the user must publish this part of source, but don't need to publish the whole source of the own product.
5. You can study and modify (improve) this source for own using or for redistribution, but you have to license the modified sources likewise under this LGPL Lesser General Public License. You mustn't delete this Copyright/Copyleft inscription in this source file.

If you are intent to use this sources without publishing its usage, you can get a second license subscribing a special contract with the author.

See Also:

Constant Field Values

sOperator

public java.lang.String sOperator

The operator for the pin, consisting of till three parts.

• If starts with "C" it is a value cast from the input to the DType of the pin.
• Following by the operator itself: , means "+" "-" or also ">=" etc. The binary operator of the X1 is remove if it is adequate the expression kind, or it is replaced here by "1.0 /" if the first pin divides. Note: Division can be seen also as unary operator: Build the reciprocal. Adequate that is done by the "-" unary for ADD operations.
• Following by a possible unary operator.

Generally in an expression the operators are contained in the first pin named "expr" as String. But in the working data it is stored here. See FBexpr_FBcl#setOperatorToPins(org.vishia.fbcl.readSource.Prj_FBCLrd) and FBexpr_FBcl.setExprPinFromPinsExprFn().

sElemSrc

protected java.lang.String sElemSrc

If not null or "", then it describes the access to an element in the connected doutSrc struct as textual information written in an din. An element access is such as ".re" or ".im" for complex values or also ".element" for a struct access. It should not be confused with the ".re" designation for element assign to the output variable of an expression. This is a really textual access description possibility.

sElemDst

protected java.lang.String sElemDst

This is either used for setElement expression (to set an array element or a struct element in the correspond variable after expression) or also to store a given component name for sliced accesses.

dTypeIxPart

protected DType_FBcl.DtIxmdl dTypeIxPart

A possible specific data type for the part of the expression after the modification operation used for casting after modification if also bCastToDTypePart is set and used for the output data type propagation. The data type valid for the exprOut is stored in FBlock_FBcl.dTypes adequate to the index given in DinoutType_FBcl#ixDtype. But the output DType can be different to the FBexpr_FBcl.dTypeAllDin and hence also to this element.

For forward propagation inside the FBexpr to its output first this dtype is used, see inside org.vishia.fbcl.fblockwr.DTypePropgPrc_FBcl#propgExprForward(org.vishia.fbcl.fblockwr.Write_FBlock_FBwr, boolean, boolean) If this is not set then Din_FBcl.dTypeCastInp() is used.

General for expressions: Inside the expression the scalar type is used for the expression as element execution, this is the non array DType. The DType used for the outer propagation may be an DTypeArray_FBcl which uses FBlock_FBcl.sizeArray() for backward propagation.

bCastToDTypePart

protected boolean bCastToDTypePart

Only if this flag is set, the type is given as text, and should be used to cast the part after modification of the input with K pin.

pinK

private DinExprK_FBcl pinK

The associated K pin for a second input of a constant to operate. null if a K pin is not designated.

Constructor Detail

DinExpr_FBcl

public DinExpr_FBcl(DinType_FBcl pint,
                    java.lang.String name,
                    FBexpr_FBcl fb,
                    Module_FBcl.CreateMdl mdlcr)

Constructor

Parameters:

pint -

name -

fb - The associated expression where the pin is member of

mdlcr - It needs knowledge of the superior module because of #setDType(DType_FBcl, DType_FBcl, LogMessage) may regard a conversion to a struct DType.

Method Detail

pinK

public DinExprK_FBcl pinK()

setPinK

public void setPinK(DinExprK_FBcl pinK)

setElemSrc

public void setElemSrc(java.lang.String val)

See getElemDst()

getElemSrc

public java.lang.String getElemSrc()

See sElemSrc

setElementDst

public void setElementDst(java.lang.String val)

See getElemDst()

getElemDst

public java.lang.String getElemDst()

See sElemDst

getDTypeIxMdl

DType_FBcl.DtIxmdl getDTypeIxMdl()

Returns the non solved DType for non dedicated types. To get the real used DType in the environment call Module_FBcl.dTypeMdl(org.vishia.fbcl.fblock.DType_FBcl.DtIxmdl) with the result.

Overrides:

getDTypeIxMdl in class Din_FBcl

Returns:

dTypePropgFwd

public DType_FBcl dTypePropgFwd()

dTypeIxPart

public DType_FBcl.DtIxmdl dTypeIxPart()

Returns the casting DType for the expression part or also the DType for forward propagation to the exprOut.

dTypePart

public DType_FBcl dTypePart()

shouldCastPart

public final boolean shouldCastPart()

Cast part does not mean, cast to the FBexpr_FBcl.dTypeAllDin. Cast to part is only set in OdgModule.createDinExpr(String, int[], EvinType_FBcl, String, org.vishia.fbcl.readOdg.OdgGBlock, org.vishia.fbcl.readOdg.OdgGPin) because of a textual given DType in the graphic on the expression input pin.

Returns:

true then should cast.

sOperator

public final java.lang.String sOperator()

cUnaryOperator

public final char cUnaryOperator()

dTypeDsgn

public DinExpr_FBcl.DTypeDesignation dTypeDsgn(java.lang.String sSAT,
                                               DinExpr_FBcl x1)

Builds a String usable for code generation with the DType designation to call a proper operation.

Returns:

getInfoAdaptPartforAddToDTypeAll

DinExpr_FBcl.DTypeDesignation getInfoAdaptPartforAddToDTypeAll(java.lang.String sSat)

setDType

public java.lang.String setDType(DType_FBcl.DtIxmdl dtixSrcArg,
                                 LogMessage log)

Overridden form for Dinout_FBcl#setDType(DType_FBcl, DType_FBcl, org.vishia.msgDispatch.LogMessage): It saves the src in dTypePart() for proper propagation to output if all DinExpr are propagated.

• If bCastToDTypePart is set, the dTypeIxPart is determined by graphic, hence not changed here.
• For repeated call the numeric higher type is stored in dTypeIxPart.
• If the input has a sElemDst, hence it is a set of a structure member (such as '.im' for complex Dtypes), then the structure DType is stored in dTypeIxPart

But if Din_FBcl.dTypeCastInp is set, this is determining. It means the given src is ignored. Din_FBcl.dTypeCastInp is set by graphic text, as value casting, in responsible to the user.
But if bCastToDTypePart is set, the type is not changed by this forward propagation. It is tested whether the propagated src dtype is compatible, then return null. This is proper for a numeric downcast by given cast from a higher numeric format.

Overrides:

setDType in class Din_FBcl

Parameters:

dtixSrcArg - any given Data Type.

Returns:

null if ok or an error/warning message String "DType is not able to change: " + Pin_FBcl.nameFBpin().

setDTypeExprPart

public boolean setDTypeExprPart(DType_FBcl.DtIxmdl dtix,
                                boolean castTo)

Sets initial the dTypePart() and also the bCastToDTypePart. It it is set already, it is not changed. This is usual used for value casting of the expression input in generated code.

Parameters:

dt - DType maybe registered in the module.

castTo - true then this DType is given manually or should immediately force cast. It is false if it is set in DTypePropgPrc_FBcl.propgDTypeForward(boolean) to save a detected Din_FBcl.dTypeCastInp-DType especially as structure DType here. Then the cast is faulty, instead the element set should be used. Note: The dTypeIxPart is also interesting for report and overview. It documents the relations.

Returns:

true if determined or equal, false if not set newly.