API reference - Class RdbItemValueNotation used in Ruby API documentation Description: A value object inside the report database
Value objects are attached to items to provide markers. An arbitrary number of such value objects can be attached to an item. Currently, a value can represent a box, a polygon or an edge. Geometrical objects are represented in micron units and are therefore "D" type objects (DPolygon, DEdge and DBox). Public constructors
Public methods
Public static methods and constants
Deprecated methods (protected, public, static, non-static and constructors)
Detailed descriptionvoid _createDescription: Ensures the C++ object is created Use this method to ensure the C++ object is created, for example to ensure that resources are allocated. Usually C++ objects are created on demand and not necessarily when the script object is created. void _destroyDescription: Explicitly destroys the object Explicitly destroys the object on C++ side if it was owned by the script interpreter. Subsequent access to this object will throw an exception. If the object is not owned by the script, this method will do nothing. [const] bool _destroyed?Description: Returns a value indicating whether the object was already destroyed This method returns true, if the object was destroyed, either explicitly or by the C++ side. The latter may happen, if the object is owned by a C++ object which got destroyed itself. [const] bool _is_const_object?Description: Returns a value indicating whether the reference is a const reference This method returns true, if self is a const reference. In that case, only const methods may be called on self. void _manageDescription: Marks the object as managed by the script side. After calling this method on an object, the script side will be responsible for the management of the object. This method may be called if an object is returned from a C++ function and the object is known not to be owned by any C++ instance. If necessary, the script side may delete the object if the script's reference is no longer required. Usually it's not required to call this method. It has been introduced in version 0.24. void _unmanageDescription: Marks the object as no longer owned by the script side. Calling this method will make this object no longer owned by the script's memory management. Instead, the object must be managed in some other way. Usually this method may be called if it is known that some C++ object holds and manages this object. Technically speaking, this method will turn the script's reference into a weak reference. After the script engine decides to delete the reference, the object itself will still exist. If the object is not managed otherwise, memory leaks will occur. Usually it's not required to call this method. It has been introduced in version 0.24. void assign(const RdbItemValue other)Description: Assigns another object to self [const] DBox boxDescription: Gets the box if the value represents one.
void createDescription: Ensures the C++ object is created Use of this method is deprecated. Use _create instead void destroyDescription: Explicitly destroys the object Use of this method is deprecated. Use _destroy instead [const] bool destroyed?Description: Returns a value indicating whether the object was already destroyed Use of this method is deprecated. Use _destroyed? instead [const] new RdbItemValue ptr dupDescription: Creates a copy of self [const] DEdge edgeDescription: Gets the edge if the value represents one.
[const] DEdgePair edge_pairDescription: Gets the edge pair if the value represents one.
[const] double floatDescription: Gets the numeric value.
This method has been introduced in version 0.24. [static] RdbItemValue ptr from_s(string s)Description: Creates a value object from a string The string format is the same than obtained by the to_s method. [const] bool is_box?Description: Returns true if the value object represents a box [const] bool is_const_object?Description: Returns a value indicating whether the reference is a const reference Use of this method is deprecated. Use _is_const_object? instead [const] bool is_edge?Description: Returns true if the value object represents an edge [const] bool is_edge_pair?Description: Returns true if the value object represents an edge pair [const] bool is_float?Description: Returns true if the value object represents a numeric value This method has been introduced in version 0.24. [const] bool is_path?Description: Returns true if the value object represents a path This method has been introduced in version 0.22. [const] bool is_polygon?Description: Returns true if the value object represents a polygon [const] bool is_string?Description: Returns true if the object represents a string value [const] bool is_text?Description: Returns true if the value object represents a text This method has been introduced in version 0.22. [static] new RdbItemValue ptr new(double f)Description: Creates a value representing a numeric value This variant has been introduced in version 0.24 Python specific notes:This method is the default initializer of the object [static] new RdbItemValue ptr new(string s)Description: Creates a value representing a string Python specific notes:This method is the default initializer of the object [static] new RdbItemValue ptr new(const DPolygon p)Description: Creates a value representing a DPolygon object Python specific notes:This method is the default initializer of the object [static] new RdbItemValue ptr new(const DPath p)Description: Creates a value representing a DPath object This method has been introduced in version 0.22. Python specific notes:This method is the default initializer of the object [static] new RdbItemValue ptr new(const DText t)Description: Creates a value representing a DText object This method has been introduced in version 0.22. Python specific notes:This method is the default initializer of the object [static] new RdbItemValue ptr new(const DEdge e)Description: Creates a value representing a DEdge object Python specific notes:This method is the default initializer of the object [static] new RdbItemValue ptr new(const DEdgePair ee)Description: Creates a value representing a DEdgePair object Python specific notes:This method is the default initializer of the object [static] new RdbItemValue ptr new(const DBox b)Description: Creates a value representing a DBox object Python specific notes:This method is the default initializer of the object [const] DPath pathDescription: Gets the path if the value represents one.
This method has been introduced in version 0.22. [const] DPolygon polygonDescription: Gets the polygon if the value represents one.
[const] string stringDescription: Gets the string representation of the value.
[const] unsigned long tag_idDescription: Gets the tag ID if the value is a tagged value or 0 if not
See tag_id= for details about tagged values. Tagged values have been added in version 0.24. Python specific notes:The object exposes a readable attribute 'tag_id'. This is the getter. void tag_id=(unsigned long id)Description: Sets the tag ID to make the value a tagged value or 0 to reset it
To get a tag ID, use RdbDatabase#user_tag_id (preferred) or RdbDatabase#tag_id (for internal use). Tagged values have been added in version 0.24. Tags can be given to identify a value, for example to attache measurement values to an item. To attach a value for a specific measurement, a tagged value can be used where the tag ID describes the measurement made. In that way, multiple values for different measurements can be attached to an item. This variant has been introduced in version 0.24 Python specific notes:The object exposes a writable attribute 'tag_id'. This is the setter. [const] DText textDescription: Gets the text if the value represents one.
This method has been introduced in version 0.22. [const] string to_sDescription: Converts a value to a string
The string can be used by the string constructor to create another object from it. Python specific notes:This method is also available as 'str(object)' |