Files
file	gncEntry.h
	Business Entry Interface.

Macros
#define	GNC_ID_ENTRY "gncEntry"

#define	GNC_TYPE_ENTRY (gnc_entry_get_type ())

#define	GNC_ENTRY(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), GNC_TYPE_ENTRY, GncEntry))

#define	GNC_ENTRY_CLASS(k) (G_TYPE_CHECK_CLASS_CAST((k), GNC_TYPE_ENTRY, GncEntryClass))

#define	GNC_IS_ENTRY(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), GNC_TYPE_ENTRY))

#define	GNC_IS_ENTRY_CLASS(k) (G_TYPE_CHECK_CLASS_TYPE ((k), GNC_TYPE_ENTRY))

#define	GNC_ENTRY_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), GNC_TYPE_ENTRY, GncEntryClass))

#define	ENTRY_DATE "date"

#define	ENTRY_DATE_ENTERED "date-entered"

#define	ENTRY_DESC "desc"

#define	ENTRY_ACTION "action"

#define	ENTRY_NOTES "notes"

#define	ENTRY_QTY "qty"

#define	ENTRY_IPRICE "iprice"

#define	ENTRY_IACCT "invoice-account"

#define	ENTRY_BACCT "bill-account"

#define	ENTRY_BPRICE "bprice"

#define	ENTRY_BILLABLE "billable?"

#define	ENTRY_BILLTO "bill-to"

#define	ENTRY_ORDER "order"

#define	ENTRY_INVOICE "invoice"

#define	ENTRY_BILL "bill"

#define	ENTRY_INV_DISC_TYPE "discount-type"

#define	ENTRY_INV_DISC_HOW "discount-method"

#define	ENTRY_INV_TAXABLE "invoice-taxable"

#define	ENTRY_BILL_TAXABLE "bill-taxable"

#define	ENTRY_INV_TAX_INC "invoice-tax-included"

#define	ENTRY_BILL_TAX_INC "bill-tax-included"

#define	ENTRY_INV_DISCOUNT "invoice-discount"

#define	ENTRY_BILL_PAY_TYPE "bill-payment-type"

#define	gncEntryGetGUID(x) qof_instance_get_guid(QOF_INSTANCE(x))

Typedefs
typedef struct _gncEntry	GncEntry

typedef struct _gncEntryClass	GncEntryClass

Enumerations
enum	GncEntryPaymentType { GNC_PAYMENT_CASH = 1, GNC_PAYMENT_CARD }

enum	GncDiscountHow { GNC_DISC_PRETAX = 1, GNC_DISC_SAMETIME, GNC_DISC_POSTTAX }

Functions
GType	gnc_entry_get_type (void)

const char *	gncEntryDiscountHowToString (GncDiscountHow how)

gboolean	gncEntryDiscountStringToHow (const char str, GncDiscountHow how)

const char *	gncEntryPaymentTypeToString (GncEntryPaymentType type)

gboolean	gncEntryPaymentStringToType (const char str, GncEntryPaymentType type)

void	gncEntryCopy (const GncEntry src, GncEntry dest, gboolean add_entry)

GncOrder *	gncEntryGetOrder (const GncEntry *entry)

GncInvoice *	gncEntryGetInvoice (const GncEntry *entry)

GncInvoice *	gncEntryGetBill (const GncEntry *entry)

gboolean	gncEntryIsOpen (const GncEntry *entry)

void	gncEntryBeginEdit (GncEntry *entry)

void	gncEntryCommitEdit (GncEntry *entry)

int	gncEntryCompare (const GncEntry a, const GncEntry b)

Create/Destroy Functions
GncEntry *	gncEntryCreate (QofBook *book)

void	gncEntryDestroy (GncEntry *entry)

Generic (shared) data
void	gncEntrySetDateGDate (GncEntry entry, const GDate date)

void	gncEntrySetDate (GncEntry *entry, Timespec date)

void	gncEntrySetDateEntered (GncEntry *entry, Timespec date)

void	gncEntrySetDescription (GncEntry entry, const char desc)

void	gncEntrySetAction (GncEntry entry, const char action)

void	gncEntrySetNotes (GncEntry entry, const char notes)

void	gncEntrySetQuantity (GncEntry *entry, gnc_numeric quantity)

void	gncEntrySetDocQuantity (GncEntry *entry, gnc_numeric quantity, gboolean is_cn)

GDate	gncEntryGetDateGDate (const GncEntry *entry)

Timespec	gncEntryGetDate (const GncEntry *entry)

Timespec	gncEntryGetDateEntered (const GncEntry *entry)

const char *	gncEntryGetDescription (const GncEntry *entry)

const char *	gncEntryGetAction (const GncEntry *entry)

const char *	gncEntryGetNotes (const GncEntry *notes)

gnc_numeric	gncEntryGetQuantity (const GncEntry *entry)

gnc_numeric	gncEntryGetDocQuantity (const GncEntry *entry, gboolean is_cn)

Customer Invoices
void	gncEntrySetInvAccount (GncEntry entry, Account acc)

void	gncEntrySetInvPrice (GncEntry *entry, gnc_numeric price)

void	gncEntrySetInvTaxable (GncEntry *entry, gboolean taxable)

void	gncEntrySetInvTaxIncluded (GncEntry *entry, gboolean tax_included)

void	gncEntrySetInvTaxTable (GncEntry entry, GncTaxTable table)

void	gncEntrySetInvDiscount (GncEntry *entry, gnc_numeric discount)

void	gncEntrySetInvDiscountType (GncEntry *entry, GncAmountType type)

void	gncEntrySetInvDiscountHow (GncEntry *entry, GncDiscountHow how)

void	qofEntrySetInvDiscType (GncEntry entry, const char type)

void	qofEntrySetInvDiscHow (GncEntry entry, const char type)

Account *	gncEntryGetInvAccount (const GncEntry *entry)

gnc_numeric	gncEntryGetInvPrice (const GncEntry *entry)

gnc_numeric	gncEntryGetInvDiscount (const GncEntry *entry)

GncAmountType	gncEntryGetInvDiscountType (const GncEntry *entry)

GncDiscountHow	gncEntryGetInvDiscountHow (const GncEntry *entry)

char *	qofEntryGetInvDiscType (const GncEntry *entry)

char *	qofEntryGetInvDiscHow (const GncEntry *entry)

gboolean	gncEntryGetInvTaxable (const GncEntry *entry)

gboolean	gncEntryGetInvTaxIncluded (const GncEntry *entry)

GncTaxTable *	gncEntryGetInvTaxTable (const GncEntry *entry)

Vendor Bills (and Employee Expenses)
void	gncEntrySetBillAccount (GncEntry entry, Account acc)

void	gncEntrySetBillPrice (GncEntry *entry, gnc_numeric price)

void	gncEntrySetBillTaxable (GncEntry *entry, gboolean taxable)

void	gncEntrySetBillTaxIncluded (GncEntry *entry, gboolean tax_included)

void	gncEntrySetBillTaxTable (GncEntry entry, GncTaxTable table)

void	gncEntrySetBillable (GncEntry *entry, gboolean billable)

void	gncEntrySetBillTo (GncEntry entry, GncOwner billto)

Account *	gncEntryGetBillAccount (const GncEntry *entry)

gnc_numeric	gncEntryGetBillPrice (const GncEntry *entry)

gboolean	gncEntryGetBillTaxable (const GncEntry *entry)

gboolean	gncEntryGetBillTaxIncluded (const GncEntry *entry)

GncTaxTable *	gncEntryGetBillTaxTable (const GncEntry *entry)

gboolean	gncEntryGetBillable (const GncEntry *entry)

GncOwner *	gncEntryGetBillTo (GncEntry *entry)

GncEntryPaymentType	gncEntryGetBillPayment (const GncEntry *entry)

employee-stuff
void	gncEntrySetBillPayment (GncEntry *entry, GncEntryPaymentType type)

Getting Values
An entry has three important values: entry value: the amount the merchant gets tax value: the amount the government gets discount value: the amount the customer saved These values can be retrieved in several variants. Depending on how they will be used some sign reversals can be applied on the values: Doc value: the value as listed on the document. This is usually a positive value, unless the document was a negative invoice/bill or negative credit note. Since credit note entry values are stored negatively internally, they will be sign-reversed before returning them. Bal value: the value as it will impact the balance. Customer invoices and vendor credit notes have a positive influence on the balance, so these values will be positive. For vendor bills and customer credit notes, the values will be negative. For tax there are TaxValue and TaxValues variants: the first one returns to total tax value for this entry, meaning the sum of all individual taxes. The second one returns a list of all the individual tax values for this entry. This list holds unrounded values only, there's no variant with rounded values. Note that this list is not owned by the entry. When no longer needed, it should be freed with gncAccountValueDestroy. Finally, there are rounded and unrounded variants of most of these functions.
typedef GList	AccountValueList

gnc_numeric	gncEntryGetDocValue (GncEntry *entry, gboolean round, gboolean is_cust_doc, gboolean is_cn)

gnc_numeric	gncEntryGetDocTaxValue (GncEntry *entry, gboolean round, gboolean is_cust_doc, gboolean is_cn)

AccountValueList *	gncEntryGetDocTaxValues (GncEntry *entry, gboolean is_cust_doc, gboolean is_cn)

gnc_numeric	gncEntryGetDocDiscountValue (GncEntry *entry, gboolean round, gboolean is_cust_doc, gboolean is_cn)

gnc_numeric	gncEntryGetBalValue (GncEntry *entry, gboolean round, gboolean is_cust_doc)

gnc_numeric	gncEntryGetBalTaxValue (GncEntry *entry, gboolean round, gboolean is_cust_doc)

AccountValueList *	gncEntryGetBalTaxValues (GncEntry *entry, gboolean is_cust_doc)

gnc_numeric	gncEntryGetBalDiscountValue (GncEntry *entry, gboolean round, gboolean is_cust_doc)

void	gncEntryComputeValue (gnc_numeric qty, gnc_numeric price, const GncTaxTable tax_table, gboolean tax_included, gnc_numeric discount, GncAmountType discount_type, GncDiscountHow discount_how, int SCU, gnc_numeric value, gnc_numeric discount_value, GList *tax_values)

Detailed Description

Function Documentation

void gncEntryComputeValue	(	gnc_numeric	qty,
		gnc_numeric	price,
		const GncTaxTable *	tax_table,
		gboolean	tax_included,
		gnc_numeric	discount,
		GncAmountType	discount_type,
		GncDiscountHow	discount_how,
		int	SCU,
		gnc_numeric *	value,
		gnc_numeric *	discount_value,
		GList **	tax_values
	)

Compute the Entry value, tax_value, and discount_value, based on the quantity, price, discount, tax_-table, and types. The value is the amount the merchant gets, the taxes are what the gov't gets, and the discount is how much the customer saved. The SCU is the target denominator of the value and tax – it should be the account or commodity SCU of the target.

The return values are NOT rounded.

The tax_values list is owned by the entry and will be destroyed automatically, so use it quickly.

Definition at line 1102 of file gncEntry.c.

 {
     gnc_numeric aggregate;
     gnc_numeric pretax;
     gnc_numeric result;
     gnc_numeric tax;
     gnc_numeric percent = gnc_numeric_create (100, 1);
     gnc_numeric tpercent = gnc_numeric_zero ();
     gnc_numeric tvalue = gnc_numeric_zero ();
 
     GList     * entries = gncTaxTableGetEntries (tax_table);
     GList     * node;
 
     /* Step 1: compute the aggregate price */
 
     aggregate = gnc_numeric_mul (qty, price, GNC_DENOM_AUTO, GNC_HOW_DENOM_LCD);
 
     /* Step 2: compute the pre-tax aggregate */
 
     /* First, compute the aggregate tpercent and tvalue numbers */
     for (node = entries; node; node = node->next)
     {
         GncTaxTableEntry *entry = node->data;
         gnc_numeric amount = gncTaxTableEntryGetAmount (entry);
 
         switch (gncTaxTableEntryGetType (entry))
         {
         case GNC_AMT_TYPE_VALUE:
             tvalue = gnc_numeric_add (tvalue, amount, GNC_DENOM_AUTO,
                                       GNC_HOW_DENOM_LCD);
             break;
         case GNC_AMT_TYPE_PERCENT:
             tpercent = gnc_numeric_add (tpercent, amount, GNC_DENOM_AUTO,
                                         GNC_HOW_DENOM_LCD);
             break;
         default:
             g_warning ("Unknown tax type: %d", gncTaxTableEntryGetType (entry));
             break;
         }
     }
     /* now we need to convert from 5% -> .05 */
     tpercent = gnc_numeric_div (tpercent, percent, GNC_DENOM_AUTO,
                                 GNC_HOW_DENOM_LCD);
 
     /* Next, actually compute the pre-tax aggregate value based on the
      * taxincluded flag.
      */
     if (tax_table && tax_included)
     {
         /* Back-compute the pre-tax aggregate value.
          * We know that aggregate = pretax + pretax*tpercent + tvalue, so
          * pretax = (aggregate-tvalue)/(1+tpercent)
          */
         pretax = gnc_numeric_sub (aggregate, tvalue, GNC_DENOM_AUTO,
                                   GNC_HOW_DENOM_LCD);
         pretax = gnc_numeric_div (pretax,
                                   gnc_numeric_add (tpercent,
                                           gnc_numeric_create (1, 1),
                                           GNC_DENOM_AUTO, GNC_HOW_DENOM_LCD),
                                   GNC_DENOM_AUTO, GNC_HOW_DENOM_LCD);
     }
     else
     {
         pretax = aggregate;
     }
 
     /* Step 3:  apply discount and taxes in the appropriate order */
 
     /*
      * There are two ways to apply discounts and taxes.  In one way, you
      * always compute the discount off the pretax number, and compute
      * the taxes off of either the pretax value or "pretax-discount"
      * value.  In the other way, you always compute the tax on "pretax",
      * and compute the discount on either "pretax" or "pretax+taxes".
      *
      * I don't know which is the "correct" way.
      */
 
     /*
      * Type:    discount    tax
      * PRETAX   pretax      pretax-discount
      * SAMETIME pretax      pretax
      * POSTTAX  pretax+tax  pretax
      */
 
     switch (discount_how)
     {
     case GNC_DISC_PRETAX:
     case GNC_DISC_SAMETIME:
         /* compute the discount from pretax */
 
         if (discount_type == GNC_AMT_TYPE_PERCENT)
         {
             discount = gnc_numeric_div (discount, percent, GNC_DENOM_AUTO,
                                         GNC_HOW_DENOM_LCD);
             discount = gnc_numeric_mul (pretax, discount, GNC_DENOM_AUTO,
                                         GNC_HOW_DENOM_LCD);
         }
 
         result = gnc_numeric_sub (pretax, discount, GNC_DENOM_AUTO, GNC_HOW_DENOM_LCD);
 
         /* Figure out when to apply the tax, pretax or pretax-discount */
         if (discount_how == GNC_DISC_PRETAX)
             pretax = result;
         break;
 
     case GNC_DISC_POSTTAX:
         /* compute discount on pretax+taxes */
 
         if (discount_type == GNC_AMT_TYPE_PERCENT)
         {
             gnc_numeric after_tax;
 
             tax = gnc_numeric_mul (pretax, tpercent, GNC_DENOM_AUTO, GNC_HOW_DENOM_LCD);
             after_tax = gnc_numeric_add (pretax, tax, GNC_DENOM_AUTO, GNC_HOW_DENOM_LCD);
             after_tax = gnc_numeric_add (after_tax, tvalue, GNC_DENOM_AUTO,
                                          GNC_HOW_DENOM_LCD);
             discount = gnc_numeric_div (discount, percent, GNC_DENOM_AUTO,
                                         GNC_HOW_DENOM_LCD);
             discount = gnc_numeric_mul (after_tax, discount, GNC_DENOM_AUTO,
                                         GNC_HOW_DENOM_LCD);
         }
 
         result = gnc_numeric_sub (pretax, discount, GNC_DENOM_AUTO, GNC_HOW_DENOM_LCD);
         break;
 
     default:
         g_warning ("unknown DiscountHow value: %d", discount_how);
         break;
     }
 
     /* Step 4:  return the requested results. */
 
     /* result == amount merchant gets
      * discount == amount of discount
      * need to compute taxes (based on 'pretax') if the caller wants it.
      */
 
     if (discount_value != NULL)
     {
         if (SCU) discount = gnc_numeric_convert(discount, SCU, GNC_HOW_RND_ROUND_HALF_UP);
         *discount_value = discount;
     }
 
     if (value != NULL)
     {
         if (SCU) result = gnc_numeric_convert(result, SCU, GNC_HOW_RND_ROUND_HALF_UP);
         *value = result;
     }
 
     /* Now... Compute the list of tax values (if the caller wants it) */
 
     if (tax_value != NULL)
     {
         GList * taxes = NULL;
 
         for (node = entries; node; node = node->next)
         {
             GncTaxTableEntry *entry = node->data;
             Account *acc = gncTaxTableEntryGetAccount (entry);
             gnc_numeric amount = gncTaxTableEntryGetAmount (entry);
 
             g_return_if_fail (acc);
 
             switch (gncTaxTableEntryGetType (entry))
             {
             case GNC_AMT_TYPE_VALUE:
                 if (SCU) amount = gnc_numeric_convert(amount, SCU, GNC_HOW_RND_ROUND_HALF_UP);
                 taxes = gncAccountValueAdd (taxes, acc, amount);
                 break;
             case GNC_AMT_TYPE_PERCENT:
                 amount = gnc_numeric_div (amount, percent, GNC_DENOM_AUTO,
                                           GNC_HOW_DENOM_LCD);
                 tax = gnc_numeric_mul (pretax, amount, GNC_DENOM_AUTO, GNC_HOW_DENOM_LCD);
                 if (SCU) tax = gnc_numeric_convert(tax, SCU, GNC_HOW_RND_ROUND_HALF_UP);
                 taxes = gncAccountValueAdd (taxes, acc, tax);
                 break;
             default:
                 break;
             }
         }
         *tax_value = taxes;
     }
 
     return;
 }

const char* gncEntryDiscountHowToString ( GncDiscountHow how )

How to apply the discount and taxes. There are three distinct ways to apply them:

Type: discount tax PRETAX pretax pretax-discount SAMETIME pretax pretax POSTTAX pretax+tax pretax

Definition at line 112 of file gncEntry.c.

 {
     switch (how)
     {
     case (GNC_DISC_PRETAX):
         return "PRETAX";
     case (GNC_DISC_SAMETIME):
         return "SAMETIME";
     case (GNC_DISC_POSTTAX):
         return "POSTTAX";
     default:
         g_warning ("asked to translate unknown discount-how %d.\n", how);
         break;
     }
     return NULL;
 }

AccountValueList* gncEntryGetBalTaxValues	(	GncEntry *	entry,
		gboolean	is_cust_doc
	)

Careful: the returned list is NOT owned by the entry and should be freed by the caller

Definition at line 1481 of file gncEntry.c.

 {
     AccountValueList *int_values = gncEntryGetIntTaxValues (entry, is_cust_doc);
     AccountValueList *values = NULL, *node;
 
     /* Make a copy of the list with negated values if necessary. */
     for (node = int_values; node; node = node->next)
     {
         GncAccountValue *acct_val = node->data;
         values = gncAccountValueAdd (values, acct_val->account,
                                      (is_cust_doc ? gnc_numeric_neg (acct_val->value)
                                       : acct_val->value));
     }
 
     return values;
 }

Timespec gncEntryGetDate ( const GncEntry * entry )

DEPRECATED - use gncEntryGetDateGDate() instead! (Because the time-of-day is a misleading extra information. We are only dealing with the day information!

Definition at line 878 of file gncEntry.c.

 {
     Timespec ts;
     ts.tv_sec = 0;
     ts.tv_nsec = 0;
     if (!entry) return ts;
     return entry->date;
 }

GDate gncEntryGetDateGDate ( const GncEntry * entry )

Returns the day of this entry

Definition at line 887 of file gncEntry.c.

 {
     return timespec_to_gdate(gncEntryGetDate(entry));
 }

gnc_numeric gncEntryGetDocQuantity	(	const GncEntry *	entry,
		gboolean	is_cn
	)

Get the quantity as on the physical document. This distinction is made because credit notes store their quantity sign-reversed compared to how the quantity is written on the actual credit note (and hence how the ledger and reports show it to the user).

Definition at line 925 of file gncEntry.c.

 {
     gnc_numeric value = gncEntryGetQuantity (entry);
     return (is_cn ? gnc_numeric_neg (value) : value);
 }

AccountValueList* gncEntryGetDocTaxValues	(	GncEntry *	entry,
		gboolean	is_cust_doc,
		gboolean	is_cn
	)

Careful: the returned list is NOT owned by the entry and should be freed by the caller

Definition at line 1445 of file gncEntry.c.

 {
     AccountValueList *int_values = gncEntryGetIntTaxValues (entry, is_cust_doc);
     AccountValueList *values = NULL, *node;
 
     /* Make a copy of the list with negated values if necessary. */
     for (node = int_values; node; node = node->next)
     {
         GncAccountValue *acct_val = node->data;
         values = gncAccountValueAdd (values, acct_val->account,
                                      (is_cn ? gnc_numeric_neg (acct_val->value)
                                       : acct_val->value));
     }
 
     return values;
 }

gnc_numeric gncEntryGetQuantity ( const GncEntry * entry )

Get the quantity as stored internally. This distinction is made because credit notes store their quantity sign-reversed compared to how the quantity is written on the actual credit note (and hence how the ledger and reports show it to the user).

Definition at line 919 of file gncEntry.c.

 {
     if (!entry) return gnc_numeric_zero();
     return entry->quantity;
 }

void gncEntrySetDate	(	GncEntry *	entry,
		Timespec	date
	)

DEPRECATED - use gncEntrySetDateGDate() instead! (Because the time-of-day is a misleading extra information. We are only dealing with the day information!

Definition at line 481 of file gncEntry.c.

 {
     gboolean first_date = FALSE;
     Timespec zero_time = { 0, 0 };
 
     if (!entry) return;
     if (timespec_equal (&entry->date, &date)) return;
     if (timespec_equal (&entry->date, &zero_time))
         first_date = TRUE;
     gncEntryBeginEdit (entry);
     entry->date = date;
     mark_entry (entry);
     gncEntryCommitEdit (entry);
 
     /* Don't re-sort the first time we set the date on this entry */
     if (!first_date)
     {
         if (entry->invoice)
             gncInvoiceSortEntries(entry->invoice);
         if (entry->bill)
             gncInvoiceSortEntries(entry->bill);
     }
 }

void gncEntrySetDateGDate	(	GncEntry *	entry,
		const GDate *	date
	)

Set the date of this entry

Definition at line 505 of file gncEntry.c.

 {
     if (!entry || !date || !g_date_valid(date))
         return;
 
     /* Watch out: Here we are deviating from the initial convention that a
     GDate always converts to the start time of the day. Instead, the GDate is
     converted to "noon" on the respective date. This is not nice, but this
     convention was used for the Timespec of GncEntry all the time, so we better
     stick to it.*/
     gncEntrySetDate(entry, timespecCanonicalDayTime(gdate_to_timespec(*date)));
 }

void gncEntrySetDocQuantity	(	GncEntry *	entry,
		gnc_numeric	quantity,
		gboolean	is_cn
	)

Set the internal quantity converting from the quantity as visible on the physical document. This distinction is made because credit notes store their quantity sign-reversed compared to how the quantity is written on the actual credit note (and hence how the ledger and reports show it to the user).

Definition at line 563 of file gncEntry.c.

 {
     if (!entry) return;
     if (gnc_numeric_eq (entry->quantity, (is_cn ? gnc_numeric_neg (quantity) : quantity))) return;
     gncEntryBeginEdit (entry);
     entry->quantity = (is_cn ? gnc_numeric_neg (quantity) : quantity);
     entry->values_dirty = TRUE;
     mark_entry (entry);
     gncEntryCommitEdit (entry);
 }

void gncEntrySetQuantity	(	GncEntry *	entry,
		gnc_numeric	quantity
	)

Set the internal quantity without any conversion. This distinction is made because credit notes store their quantity sign-reversed compared to how the quantity is written on the actual credit note (and hence how the ledger and reports show it to the user).

Definition at line 552 of file gncEntry.c.

 {
     if (!entry) return;
     if (gnc_numeric_eq (entry->quantity, quantity)) return;
     gncEntryBeginEdit (entry);
     entry->quantity = quantity;
     entry->values_dirty = TRUE;
     mark_entry (entry);
     gncEntryCommitEdit (entry);
 }

Files

Macros

Typedefs

Enumerations

Functions

Create/Destroy Functions

Generic (shared) data

Customer Invoices

Vendor Bills (and Employee Expenses)

employee-stuff

Getting Values

Detailed Description

Function Documentation