8+ Delphi Property Tips & Tricks – solidfire.com

8+ Delphi Property Tips & Tricks


8+ Delphi Property Tips & Tricks

In Delphi programming, a member of a category, file, or different knowledge construction that represents a particular attribute or attribute is usually carried out utilizing a devoted language assemble. This assemble permits managed entry (studying and writing) to the underlying knowledge discipline by devoted accessor strategies (getters and setters), providing encapsulation and knowledge integrity. As an illustration, a `TPerson` file might need a `Identify` member represented by a non-public `FName` discipline and public `GetName` and `SetName` strategies. The `GetName` technique retrieves the worth of `FName`, whereas `SetName` assigns a brand new worth, probably together with validation logic.

This strategy gives a number of benefits. Encapsulation protects the interior state of an object, stopping direct manipulation and potential inconsistencies. Getters and setters present a managed interface, permitting for validation, unwanted side effects (like updating a show), and calculated values. Traditionally, this mechanism has been integral to Delphi’s object-oriented programming paradigm, contributing considerably to code maintainability and reusability. This structured strategy facilitates higher administration of advanced knowledge constructions and promotes clearer, extra sturdy code.

This foundational idea is central to understanding varied features of Delphi growth, together with element design, knowledge binding, and person interface creation. Additional exploration will delve into how these devoted members work together with different Delphi options and their function in constructing sturdy and maintainable functions.

1. Member entry management

Member entry management kinds the muse of Delphi properties. It governs how inner knowledge fields, representing the property’s worth, are accessed and modified. By way of key phrases like `non-public`, `protected`, `public`, and `printed`, builders dictate the visibility and accessibility of those fields. This management ensures that knowledge is accessed and modified solely by designated channels, stopping unintended exterior manipulation. Direct entry to the underlying discipline is restricted; as a substitute, interplay happens by way of accessor strategies getters and setters that are sometimes declared `public` or `printed`. This managed entry mechanism constitutes the core precept of encapsulation.

A sensible instance illustrates this idea. Contemplate a category `TBankAccount` with a `Steadiness` property. The precise stability worth is saved in a non-public discipline, `FBalance`. Direct modification of `FBalance` from outdoors the category is prevented by its `non-public` entry stage. As an alternative, builders work together with the stability by the `GetBalance` (getter) and `SetBalance` (setter) strategies, that are declared `public`. The `SetBalance` technique, in addition to assigning the brand new worth, may also incorporate logic for transaction logging or validation, guaranteeing knowledge integrity. With out member entry management, exterior code might immediately manipulate `FBalance`, bypassing essential validation or logging steps, probably resulting in knowledge corruption or inconsistencies.

Member entry management, subsequently, underpins the integrity and reliability of Delphi properties. It ensures that knowledge manipulation adheres to predefined guidelines and logic, enforced by the accessor strategies. This structured strategy not solely prevents unintended knowledge corruption but in addition contributes to maintainability and code readability by centralizing knowledge entry logic. By limiting direct entry to inner fields and implementing interplay by designated strategies, Delphi properties, ruled by member entry management, contribute considerably to constructing sturdy and reliable functions. This rigorous strategy to knowledge administration is essential in advanced software program tasks, minimizing the danger of errors and facilitating long-term maintainability.

2. Getter and setter strategies

Getter and setter strategies are elementary to Delphi properties, serving because the managed entry factors for manipulating the underlying knowledge. They encapsulate the interior illustration of a property and supply a well-defined interface for interplay. This mechanism contributes considerably to knowledge integrity and code maintainability.

  • Managed Entry:

    Getters and setters act as gatekeepers, mediating all entry to the property’s worth. The getter retrieves the present worth, whereas the setter assigns a brand new one. This prevents direct manipulation of the underlying knowledge discipline, guaranteeing that any related logic, corresponding to validation or knowledge transformation, is executed constantly. As an illustration, a property representing temperature might need a setter that converts Celsius enter to Fahrenheit earlier than storage.

  • Encapsulation and Knowledge Integrity:

    By limiting direct entry to the interior knowledge discipline, getters and setters implement encapsulation, a cornerstone of object-oriented programming. This protects the interior state of an object, stopping unintended modifications and selling knowledge integrity. A `Password` property, for instance, would possibly use a setter to hash the supplied worth earlier than storing it, enhancing safety.

  • Knowledge Validation and Transformation:

    Setters present a possibility to validate incoming values earlier than task. This ensures knowledge consistency and prevents invalid states. For instance, a property representing age might need a setter that rejects detrimental values. Setters may carry out knowledge transformations, corresponding to changing items or formatting strings.

  • Calculated Properties:

    Getters can present entry to calculated values derived from different knowledge members. This eliminates the necessity to retailer redundant knowledge and ensures consistency. As an illustration, a `FullName` property would possibly concatenate values from `FirstName` and `LastName` properties. The getter calculates the complete identify dynamically, guaranteeing it displays any adjustments to the person identify elements.

These sides of getters and setters contribute considerably to the facility and suppleness of Delphi properties. They permit managed entry, knowledge integrity, validation, and the creation of calculated properties, thereby enhancing code construction, maintainability, and robustness. Understanding their function is important for efficient Delphi growth, significantly when constructing reusable elements and sophisticated knowledge constructions.

3. Encapsulation

Encapsulation, a cornerstone of object-oriented programming, is intrinsically linked to Delphi properties. It serves because the protecting barrier round an object’s inner state, stopping direct exterior entry to knowledge fields. Properties, by their getter and setter strategies, present the managed interface for interacting with these encapsulated knowledge members. This managed entry mechanism is the essence of how encapsulation is carried out in Delphi. Trigger and impact are immediately linked: encapsulation necessitates managed entry, which properties present. With out properties, the precept of encapsulation could be considerably weakened, leaving knowledge susceptible to uncontrolled modification and potential inconsistencies.

Contemplate a real-life instance: a automotive’s engine. Direct manipulation of the engine’s inner elements is restricted. Interplay happens by outlined interfaces: the ignition, accelerator, and steering wheel. Equally, Delphi properties act because the outlined interfaces to an object’s inner knowledge. A property representing engine temperature offers a getter to learn the temperature and a setter, maybe accessible solely to inner programs, to change it. This managed entry ensures knowledge integrity and prevents unintended penalties, simply as stopping direct tampering with an engine’s inner workings ensures protected and dependable operation. The `printed` key phrase extends this idea additional, making properties accessible to the Delphi IDE’s visible design instruments, facilitating element integration and visible growth.

Encapsulation, facilitated by properties, is essential for constructing sturdy and maintainable Delphi functions. It promotes modularity by decoupling inner implementation particulars from exterior utilization. This separation permits for modifications to the interior workings of a category with out affecting exterior code that interacts with it by its properties. Adjustments to how a `Buyer` object shops its deal with internally, for instance, don’t impression code that accesses the deal with by the `Buyer.Deal with` property. This decoupling simplifies upkeep, reduces the danger of unintended unwanted side effects from code adjustments, and fosters a extra manageable and scalable codebase. Challenges come up when encapsulation ideas are uncared for, probably resulting in tight coupling between elements, hindering code reuse and rising the complexity of upkeep duties.

4. Knowledge Integrity

Knowledge integrity, essential for any sturdy software, is intrinsically linked to the efficient use of Delphi properties. Properties, by their managed entry mechanisms, play an important function in guaranteeing knowledge stays constant, correct, and dependable. They supply the means to implement validation guidelines, forestall invalid knowledge assignments, and preserve knowledge integrity all through an software’s lifecycle. Neglecting knowledge integrity can result in unpredictable conduct, faulty calculations, and in the end, software failure. Properties present the instruments to mitigate these dangers.

  • Validation Guidelines Enforcement

    Properties, particularly by their setter strategies, allow the enforcement of validation guidelines. Earlier than assigning a brand new worth to the underlying knowledge discipline, the setter can validate the enter towards predefined standards. This prevents invalid knowledge from corrupting the article’s state. As an illustration, a property representing an individual’s age can reject detrimental values or values exceeding an inexpensive most. This instant validation on the level of information entry ensures knowledge integrity from the outset.

  • Managed State Modification

    By limiting direct entry to the interior knowledge fields, properties be certain that all modifications happen by the designated setter strategies. This managed entry mechanism prevents unintended or unintended adjustments to knowledge. Think about a banking software the place account balances are immediately modifiable; faulty transactions might simply happen. Properties forestall this by channeling all stability modifications by a setter, probably incorporating transaction logging and safety checks, thereby sustaining knowledge integrity.

  • Complicated Knowledge Relationships

    In eventualities involving advanced knowledge relationships, properties assist preserve consistency by implementing referential integrity. For instance, a property representing an order in an e-commerce system might need a setter that validates the existence of the related buyer and product earlier than establishing the connection. This prevents orphaned orders and ensures knowledge consistency throughout associated objects.

  • Knowledge Transformation and Consistency

    Properties can guarantee knowledge consistency by performing transformations throughout task. A property representing a date, for instance, would possibly settle for enter in varied codecs however internally retailer it in a standardized format. This ensures constant illustration whatever the enter format, facilitating knowledge comparisons and operations. Equally, properties can deal with unit conversions, knowledge normalization, and different transformations mandatory for sustaining knowledge integrity and consistency throughout the software.

These features spotlight the important function Delphi properties play in safeguarding knowledge integrity. By offering managed entry, enabling validation guidelines, and facilitating knowledge transformations, properties contribute considerably to constructing sturdy and dependable functions. With out these safeguards, knowledge integrity is compromised, probably resulting in unpredictable conduct and software instability. Understanding and successfully utilizing properties is thus elementary to making sure the reliability and integrity of Delphi functions. The managed and validated entry they supply kinds an important line of protection towards knowledge corruption, guaranteeing consistency and reliability throughout the applying.

5. Code Reusability

Code reusability, a cornerstone of environment friendly software program growth, is considerably enhanced by Delphi properties. Properties facilitate the creation of modular and self-contained elements, selling reuse throughout totally different tasks and inside advanced functions. This connection stems from the encapsulation supplied by properties, hiding inner implementation particulars and exposing a well-defined interface. This abstraction permits builders to make the most of elements while not having to grasp their inner complexities, focusing solely on the supplied properties. Trigger and impact are clearly linked: well-defined properties, by encapsulation, lead on to elevated code reusability.

Contemplate a visible element like a customized button. Its look, conduct, and knowledge interactions are managed by properties like `Caption`, `Shade`, `Enabled`, and `OnClick`. Builders can reuse this button throughout varied kinds and functions just by setting these properties, while not having to change the button’s inner code. This parallels utilizing pre-fabricated elements in development; a door, outlined by its dimensions, materials, and opening mechanism, could be reused in several buildings with out requiring data of its inner development. One other instance is a knowledge entry element. Properties like `ConnectionString`, `CommandText`, and `DataSource` outline its performance. Builders can reuse this element to connect with totally different databases or retrieve varied datasets just by adjusting these properties, with out modifying the core knowledge entry logic. This promotes effectivity and reduces growth time.

Understanding this relationship between properties and code reusability is key to successfully leveraging Delphi’s element mannequin. It permits builders to construct libraries of reusable elements, streamlining growth and enhancing code maintainability. Challenges come up when properties are poorly designed or inconsistently carried out, hindering reusability and rising growth complexity. Nicely-defined, constantly carried out properties, nonetheless, are essential for maximizing code reuse, decreasing growth prices, and constructing sturdy and maintainable Delphi functions. This, in flip, permits for a extra structured and manageable codebase, fostering long-term undertaking stability and scalability.

6. Part structure

Part structure, a defining attribute of Delphi growth, depends closely on properties to reveal performance and allow customization. Properties act because the bridge between the interior workings of a element and the exterior world, permitting builders to configure and work together with elements while not having to grasp their inner complexities. This abstraction is key to the reusability and visible design features of Delphi’s element mannequin. The connection is symbiotic: elements leverage properties to supply configurable conduct, and properties, in flip, derive their sensible significance from their function throughout the element structure.

  • Visible Design and Customization

    Properties allow visible customization of elements throughout the Delphi IDE. Properties like `Width`, `Peak`, `Shade`, `Font`, and `Caption` permit builders to visually manipulate elements on a kind, setting their look and format with out writing code. This WYSIWYG (What You See Is What You Get) strategy simplifies UI design and permits for fast prototyping. Consider arranging furnishings in a room; every bit has properties like measurement, colour, and place that decide the general format. Equally, element properties outline the visible association and look of a Delphi software’s person interface.

  • Knowledge Binding and Interplay

    Properties facilitate knowledge binding, connecting elements to knowledge sources. Properties like `DataSource`, `DataField`, and `DataLink` permit elements to show and manipulate knowledge from databases or different sources. Adjustments to the underlying knowledge are mirrored within the element’s show, and person interactions with the element can replace the underlying knowledge. This resembles connecting pipes in a plumbing system; the properties outline the connections and movement of information between the elements and knowledge sources. This simplifies knowledge administration and reduces the quantity of code required to create data-driven functions.

  • Occasion Dealing with and Habits

    Properties like `OnClick`, `OnMouseMove`, and `OnKeyPress` outline how elements reply to person interactions. These properties hyperlink to occasion handlers, procedures executed when a particular occasion happens. This enables builders to customise element conduct and create interactive functions. Just like configuring switches in {an electrical} circuit, these properties outline the triggers for particular actions throughout the software.

  • Inter-Part Communication

    Properties play an important function in communication between elements. A element would possibly expose properties that affect the conduct of different elements. As an illustration, a `TabControl` element might need a `TabIndex` property that determines which tab is at the moment lively, influencing the visibility or conduct of elements inside every tab. This resembles gears in a clockwork mechanism, the place the state of 1 element influences the conduct of others. This facilitates advanced interactions inside an software.

These sides show the integral function properties play in Delphi’s element structure. They permit visible design, knowledge binding, occasion dealing with, and inter-component communication, fostering a strong and versatile growth surroundings. Understanding this interaction is essential for successfully leveraging Delphi’s element mannequin and constructing subtle functions. With out properties, the visible design paradigm, knowledge binding mechanisms, and the dynamic nature of element interactions could be considerably diminished, hindering the event of advanced, data-driven, and interactive functions.

7. Knowledge binding assist

Knowledge binding assist in Delphi depends closely on properties to determine and handle the connection between knowledge sources and visible elements. Properties act because the conduits by which knowledge flows, enabling functions to show, manipulate, and persist knowledge seamlessly. This connection is key to constructing data-driven functions, permitting builders to deal with knowledge logic somewhat than intricate knowledge synchronization mechanisms. Understanding the function properties play in knowledge binding is important for leveraging Delphi’s data-aware capabilities successfully.

  • Knowledge Supply Connection

    Properties like `DataSource` and `DataField` set up the hyperlink between a visible element and the underlying knowledge supply. `DataSource` specifies the dataset or knowledge supplier, whereas `DataField` identifies the particular discipline throughout the dataset to bind to the element. This resembles connecting a pipe to a water important and deciding on a particular faucet; the properties outline the supply and the particular knowledge stream.

  • Knowledge Show and Updates

    Properties facilitate the automated show of information inside visible elements. When the underlying knowledge adjustments, the sure elements robotically mirror these adjustments by their related properties. As an illustration, a `TEdit` element sure to a buyer’s identify discipline robotically updates its displayed textual content when the identify within the dataset adjustments. That is analogous to a speedometer needle robotically reflecting adjustments in automobile velocity; the property acts because the middleman, reflecting the underlying knowledge change within the visible show.

  • Two-Manner Knowledge Binding

    Properties allow two-way knowledge binding, the place adjustments made by the visible element robotically replace the underlying knowledge supply. For instance, modifying textual content in a data-bound `TEdit` element immediately updates the corresponding discipline within the dataset. This resembles adjusting a thermostat; the change made by the management interface (the thermostat) immediately modifies the underlying system (the temperature). This bidirectional connection simplifies knowledge administration and ensures consistency between the UI and the info supply.

  • Knowledge Validation and Conversion

    Properties can incorporate knowledge validation and conversion logic throughout the knowledge binding course of. Earlier than displaying or updating knowledge, properties can validate the info towards predefined standards or carry out mandatory conversions. For instance, a property would possibly format a date worth earlier than displaying it in a `TDBGrid` or validate numeric enter earlier than updating the database. This acts as a filter, guaranteeing knowledge integrity and consistency between the info supply and the visible illustration.

These sides illustrate the integral function properties play in Delphi’s knowledge binding assist. They set up the info supply connection, handle knowledge show and updates, allow two-way binding, and incorporate validation and conversion logic. This performance is essential for constructing data-driven functions, enabling environment friendly knowledge administration and seamless synchronization between person interface components and underlying knowledge sources. With out properties, knowledge binding could be considerably extra advanced, requiring handbook knowledge synchronization and rising the danger of information inconsistencies. Properties present the important infrastructure that simplifies knowledge administration and empowers builders to create sturdy and data-centric functions.

8. UI framework integration

UI framework integration in Delphi depends closely on properties to bridge the visible illustration of elements with their underlying performance. Properties function the interface by which the framework interacts with elements, managing their look, conduct, and knowledge interactions. This connection is key to the visible growth paradigm, enabling builders to construct person interfaces effectively and leverage the framework’s capabilities. Understanding this relationship is essential for successfully using Delphi’s UI framework and creating sturdy and visually interesting functions.

  • Visible Property Mapping

    Properties map on to visible attributes of elements throughout the UI framework. Properties like `Width`, `Peak`, `Shade`, `Font`, and `Alignment` management the visible illustration of elements on a kind. The framework makes use of these properties to render and place elements, permitting builders to control the UI visually. That is analogous to adjusting the properties of graphical components in a design software program; the properties dictate the visible output.

  • Part Interplay Administration

    Properties mediate interactions between elements throughout the UI framework. Properties like `Enabled`, `Seen`, and `TabIndex` management element conduct and their interplay with person enter. The framework makes use of these properties to handle focus, allow or disable elements, and management the movement of person interplay. That is just like configuring controls in a cockpit; the properties decide which controls are lively and the way they reply to pilot enter.

  • Knowledge Binding and Show

    Properties facilitate knowledge binding throughout the UI framework, connecting visible elements to knowledge sources. Properties like `DataSource`, `DataField`, and `DisplayFormat` allow elements to show and manipulate knowledge from databases or different sources. The framework leverages these properties to synchronize knowledge between the UI and the underlying knowledge mannequin. This resembles configuring knowledge fields in a report template; the properties decide which knowledge is displayed and the way it’s formatted.

  • Occasion Dealing with and UI Updates

    Properties join UI occasions to software logic. Properties like `OnClick`, `OnMouseMove`, and `OnChange` hyperlink person interactions with particular code procedures. The framework makes use of these properties to set off occasion handlers, permitting functions to answer person actions and replace the UI accordingly. That is just like establishing triggers in a house automation system; particular occasions set off corresponding actions throughout the system.

These sides show the tight integration between Delphi properties and the UI framework. Properties present the required interface for visible manipulation, element interplay administration, knowledge binding, and occasion dealing with. This tight integration empowers builders to construct subtle and visually interesting person interfaces effectively, leveraging the framework’s capabilities and streamlining the event course of. With out this property-driven integration, UI growth could be considerably extra advanced, requiring handbook manipulation of visible components and complicated occasion dealing with mechanisms. Properties present the essential hyperlink between the visible illustration and the underlying performance, making UI growth in Delphi environment friendly and manageable.

Steadily Requested Questions

This part addresses widespread inquiries concerning Delphi properties, aiming to make clear their utilization and significance throughout the Delphi growth surroundings.

Query 1: What’s the major objective of utilizing properties in Delphi?

Properties present managed entry to an object’s inner knowledge fields, guaranteeing knowledge integrity and encapsulation. They act as intermediaries, permitting builders to work together with knowledge by devoted getter and setter strategies, enabling validation, knowledge transformation, and calculated values.

Query 2: How do properties differ from immediately accessing knowledge fields?

Direct discipline entry bypasses the safeguards supplied by properties. Properties implement encapsulation, stopping unintended exterior modification of inner knowledge. Getters and setters inside properties permit for validation, transformation, and different logic that direct entry would circumvent.

Query 3: How do read-only and write-only properties operate in Delphi?

Learn-only properties expose solely a getter technique, permitting exterior code to retrieve the worth however not modify it. Write-only properties expose solely a setter, allowing modification however not direct retrieval. These entry restrictions improve knowledge safety and management.

Query 4: What’s the function of the `printed` key phrase with properties?

The `printed` key phrase makes properties accessible to the Delphi IDE’s streaming system, enabling visible design and element integration. Revealed properties seem within the Object Inspector, permitting builders to configure elements visually at design time.

Query 5: How are properties utilized in knowledge binding eventualities?

Properties are elementary to knowledge binding in Delphi. They set up the connection between data-aware elements and knowledge sources. Properties like `DataSource` and `DataField` hyperlink elements to particular datasets and fields, enabling automated knowledge show and synchronization.

Query 6: How do properties contribute to code maintainability and reusability?

Properties promote code maintainability by encapsulating knowledge entry logic. Adjustments to the interior implementation of a category can happen with out affecting exterior code that interacts with it by its properties. This abstraction fosters code reusability, permitting elements with well-defined properties for use in varied contexts with out modification.

Understanding these core features of Delphi properties is essential for efficient Delphi growth. Leveraging properties enhances code construction, knowledge integrity, and general software robustness.

Additional exploration can delve into superior property options, corresponding to array properties, default property values, and customized property editors, to achieve a deeper understanding of their capabilities and functions.

Efficient Use of Properties in Delphi

The following tips present steering on leveraging properties successfully inside Delphi tasks, enhancing code construction, maintainability, and general software robustness.

Tip 1: Prioritize Encapsulation: At all times use properties to regulate entry to knowledge fields, even throughout the similar class. Direct discipline entry undermines encapsulation and may result in upkeep challenges. Using properties ensures constant knowledge entry patterns and facilitates future modifications.

Tip 2: Validate Enter Knowledge: Implement sturdy validation logic inside property setters. This prevents invalid knowledge from corrupting software state and ensures knowledge integrity. Validation checks would possibly embrace vary checks, format validation, or cross-field consistency checks. Instance: a property representing age ought to reject detrimental values.

Tip 3: Leverage Calculated Properties: Make the most of getters to supply entry to calculated or derived values. This avoids redundant knowledge storage and maintains consistency. Instance: a `FullName` property can concatenate `FirstName` and `LastName` fields dynamically.

Tip 4: Make use of Learn-Solely Properties Strategically: Make the most of read-only properties to reveal knowledge that shouldn’t be modified externally. This protects knowledge integrity and clarifies the meant utilization of the property. Instance: an `OrderNumber` property, as soon as assigned, ought to be read-only.

Tip 5: Contemplate Property Visibility: Rigorously select entry specifiers (`non-public`, `protected`, `public`, `printed`) to regulate property visibility. This enforces encapsulation and restricts entry based mostly on the meant utilization context. Restrict `printed` properties to these required for design-time interplay.

Tip 6: Doc Property Utilization: Present clear and concise documentation for every property, outlining its objective, anticipated enter, and any unwanted side effects. This improves code understandability and facilitates collaboration amongst builders. Embody details about validation guidelines and knowledge transformations carried out inside getters and setters.

Tip 7: Make the most of Default Property Values: Set default values for properties the place acceptable. This simplifies element initialization and ensures predictable conduct. Instance: a boolean property representing visibility would possibly default to `True`.

Tip 8: Discover Customized Property Editors: For advanced knowledge sorts, contemplate creating customized property editors to facilitate knowledge entry and manipulation throughout the Delphi IDE. This enhances the design-time expertise and simplifies element configuration.

Adhering to those tips contributes to constructing sturdy, maintainable, and well-structured Delphi functions. Properties, used successfully, promote code readability, knowledge integrity, and environment friendly element interplay.

Following these finest practices units the stage for a well-structured and maintainable codebase, prepared for future enlargement and adaptation.

Delphi Property

This exploration has highlighted the importance of the Delphi property mechanism throughout the broader context of Delphi software growth. From its function in guaranteeing knowledge integrity by managed entry and validation to its contribution to code reusability and UI framework integration, the property stands as a elementary constructing block. Key features examined embrace the interaction between properties and encapsulation, the significance of getter and setter strategies in mediating knowledge entry, the essential function properties play in knowledge binding and element interplay, and the impression on general code maintainability and software robustness. The dialogue encompassed sensible examples and finest practices, aiming to supply a complete understanding of how properties contribute to well-structured and dependable Delphi functions.

The efficient use of properties is important for builders searching for to construct sturdy, maintainable, and scalable Delphi functions. A deep understanding of the ideas discussedencapsulation, knowledge integrity, code reusability, and UI framework integrationempowers builders to leverage the complete potential of Delphi properties. This data interprets immediately into creating extra environment friendly, dependable, and maintainable codebases, essential for navigating the complexities of contemporary software program growth. Additional exploration and sensible software of those ideas will undoubtedly contribute to mastering Delphi’s object-oriented paradigm and constructing high-quality functions.