35 #include <glib/gi18n.h> 38 #ifdef HAVE_SYS_TIME_H 39 # include <sys/time.h> 51 #include "TransactionP.h" 58 #include "qofinstance-p.h" 60 const char *void_former_amt_str =
"void-former-amount";
61 const char *void_former_val_str =
"void-former-value";
64 static QofLogModule log_module = GNC_MOD_ENGINE;
67 #define GNC_SX_ID "sched-xaction" 68 #define GNC_SX_ACCOUNT "account" 69 #define GNC_SX_CREDIT_FORMULA "credit-formula" 70 #define GNC_SX_DEBIT_FORMULA "debit-formula" 71 #define GNC_SX_CREDIT_NUMERIC "credit-numeric" 72 #define GNC_SX_DEBIT_NUMERIC "debit-numeric" 73 #define GNC_SX_SHARES "shares" 86 PROP_SX_CREDIT_FORMULA,
87 PROP_SX_CREDIT_NUMERIC,
88 PROP_SX_DEBIT_FORMULA,
89 PROP_SX_DEBIT_NUMERIC,
100 static const char * split_type_normal =
"normal";
101 static const char * split_type_stock_split =
"stock-split";
104 G_DEFINE_TYPE(Split, gnc_split, QOF_TYPE_INSTANCE)
107 gnc_split_init(Split* split)
111 split->orig_acc = NULL;
112 split->parent = NULL;
115 split->action = CACHE_INSERT(
"");
116 split->memo = CACHE_INSERT(
"");
117 split->reconciled =
NREC;
118 split->amount = gnc_numeric_zero();
119 split->value = gnc_numeric_zero();
121 split->date_reconciled = 0;
123 split->balance = gnc_numeric_zero();
124 split->cleared_balance = gnc_numeric_zero();
125 split->reconciled_balance = gnc_numeric_zero();
126 split->noclosing_balance = gnc_numeric_zero();
128 split->gains = GAINS_STATUS_UNKNOWN;
129 split->gains_split = NULL;
133 gnc_split_dispose(GObject *splitp)
135 G_OBJECT_CLASS(gnc_split_parent_class)->dispose(splitp);
139 gnc_split_finalize(GObject* splitp)
141 G_OBJECT_CLASS(gnc_split_parent_class)->finalize(splitp);
150 gnc_split_get_property(GObject *
object,
158 g_return_if_fail(GNC_IS_SPLIT(
object));
160 split = GNC_SPLIT(
object);
164 g_value_set_string(value, split->action);
167 g_value_set_string(value, split->memo);
170 g_value_set_boxed(value, &split->value);
173 g_value_set_boxed(value, &split->amount);
175 case PROP_RECONCILE_DATE:
176 t.t = split->date_reconciled;
177 g_value_set_boxed(value, &t);
180 g_value_take_object(value, split->parent);
183 g_value_take_object(value, split->acc);
186 g_value_take_object(value, split->lot);
188 case PROP_SX_CREDIT_FORMULA:
191 case PROP_SX_CREDIT_NUMERIC:
194 case PROP_SX_DEBIT_FORMULA:
197 case PROP_SX_DEBIT_NUMERIC:
200 case PROP_SX_ACCOUNT:
206 case PROP_ONLINE_ACCOUNT:
209 case PROP_GAINS_SPLIT:
212 case PROP_GAINS_SOURCE:
216 G_OBJECT_WARN_INVALID_PROPERTY_ID(
object, prop_id, pspec);
222 gnc_split_set_property(GObject *
object,
230 g_return_if_fail(GNC_IS_SPLIT(
object));
232 split = GNC_SPLIT(
object);
233 if (prop_id < PROP_RUNTIME_0 && split->parent != NULL)
234 g_assert (qof_instance_get_editlevel(split->parent));
245 number = g_value_get_boxed(value);
249 number = g_value_get_boxed(value);
252 case PROP_RECONCILE_DATE:
253 t = g_value_get_boxed(value);
257 xaccSplitSetParent(split, g_value_get_object(value));
260 xaccSplitSetAccount(split, g_value_get_object(value));
265 case PROP_SX_CREDIT_FORMULA:
268 case PROP_SX_CREDIT_NUMERIC:
271 case PROP_SX_DEBIT_FORMULA:
274 case PROP_SX_DEBIT_NUMERIC:
277 case PROP_SX_ACCOUNT:
283 case PROP_ONLINE_ACCOUNT:
286 case PROP_GAINS_SPLIT:
289 case PROP_GAINS_SOURCE:
293 G_OBJECT_WARN_INVALID_PROPERTY_ID(
object, prop_id, pspec);
299 gnc_split_class_init(SplitClass* klass)
301 GObjectClass* gobject_class = G_OBJECT_CLASS(klass);
303 gobject_class->dispose = gnc_split_dispose;
304 gobject_class->finalize = gnc_split_finalize;
305 gobject_class->set_property = gnc_split_set_property;
306 gobject_class->get_property = gnc_split_get_property;
308 g_object_class_install_property
311 g_param_spec_string(
"action",
313 "The action is an arbitrary string assigned " 314 "by the user. It is intended to be a short " 315 "string that contains extra information about " 320 g_object_class_install_property
323 g_param_spec_string(
"memo",
325 "The action is an arbitrary string assigned " 326 "by the user. It is intended to be a short " 327 "string that describes the purpose of " 332 g_object_class_install_property
335 g_param_spec_boxed(
"value",
337 "The value for this split in the common currency. " 338 "The value and the amount provide enough information to " 339 "calculate a conversion rate.",
343 g_object_class_install_property
346 g_param_spec_boxed(
"amount",
348 "The value for this split in the currency of its account. " 349 "The value and the amount provide enough information to " 350 "calculate a conversion rate.",
354 g_object_class_install_property
357 g_param_spec_boxed(
"reconcile-date",
359 "The date this split was reconciled.",
363 g_object_class_install_property
366 g_param_spec_object (
"transaction",
368 "The transaction that this split belongs to.",
369 GNC_TYPE_TRANSACTION,
372 g_object_class_install_property
375 g_param_spec_object (
"account",
377 "The account that this split belongs to.",
381 g_object_class_install_property
384 g_param_spec_object (
"lot",
386 "The lot that this split belongs to.",
390 g_object_class_install_property
392 PROP_SX_DEBIT_FORMULA,
393 g_param_spec_string(
"sx-debit-formula",
394 "Schedule Transaction Debit Formula",
395 "The formula used to calculate the actual debit " 396 "amount when a real split is generated from this " 401 g_object_class_install_property
403 PROP_SX_DEBIT_NUMERIC,
404 g_param_spec_boxed(
"sx-debit-numeric",
405 "Scheduled Transaction Debit Numeric",
406 "Numeric value to plug into the Debit Formula when a " 407 "real split is generated from this SX split.",
411 g_object_class_install_property
413 PROP_SX_CREDIT_FORMULA,
414 g_param_spec_string(
"sx-credit-formula",
415 "Schedule Transaction Credit Formula",
416 "The formula used to calculate the actual credit " 417 "amount when a real split is generated from this " 422 g_object_class_install_property
424 PROP_SX_CREDIT_NUMERIC,
425 g_param_spec_boxed(
"sx-credit-numeric",
426 "Scheduled Transaction Credit Numeric",
427 "Numeric value to plug into the Credit Formula when a " 428 "real split is generated from this SX split.",
436 g_object_class_install_property
439 g_param_spec_string(
"sx-shares",
440 "Scheduled Transaction Shares",
441 "Numeric value of shares to insert in a new split when " 442 "it's generated from this SX split.",
446 g_object_class_install_property
449 g_param_spec_boxed(
"sx-account",
450 "Scheduled Transaction Account",
451 "The target account for a scheduled transaction split.",
455 g_object_class_install_property
458 g_param_spec_string (
"online-id",
460 "The online account which corresponds to this " 461 "account for OFX/HCBI import",
465 g_object_class_install_property
468 g_param_spec_boxed (
"gains-split",
470 "The capital gains split associated with this " 471 "split when this split represents the proceeds " 472 "from the sale of a commodity inside a Lot.",
476 g_object_class_install_property
479 g_param_spec_boxed (
"gains-source",
481 "The source split for which this split this is " 493 xaccInitSplit(Split * split, QofBook *book)
499 xaccSplitReinit(Split * split)
503 split->orig_acc = NULL;
504 split->parent = NULL;
507 CACHE_REPLACE(split->action,
"");
508 CACHE_REPLACE(split->memo,
"");
509 split->reconciled =
NREC;
510 split->amount = gnc_numeric_zero();
511 split->value = gnc_numeric_zero();
513 split->date_reconciled = 0;
515 split->balance = gnc_numeric_zero();
516 split->cleared_balance = gnc_numeric_zero();
517 split->reconciled_balance = gnc_numeric_zero();
518 split->noclosing_balance = gnc_numeric_zero();
520 qof_instance_set_idata(split, 0);
522 split->gains = GAINS_STATUS_UNKNOWN;
523 split->gains_split = NULL;
533 g_return_val_if_fail (book, NULL);
535 split = g_object_new (GNC_TYPE_SPLIT, NULL);
536 xaccInitSplit (split, book);
551 xaccDupeSplit (
const Split *s)
553 Split *split = g_object_new (GNC_TYPE_SPLIT, NULL);
559 split->inst.e_type = NULL;
560 qof_instance_copy_guid(split, s);
563 split->parent = s->parent;
565 split->orig_acc = s->orig_acc;
568 CACHE_REPLACE(split->memo, s->memo);
569 CACHE_REPLACE(split->action, s->action);
571 qof_instance_copy_kvp (QOF_INSTANCE (split), QOF_INSTANCE (s));
573 split->reconciled = s->reconciled;
574 split->date_reconciled = s->date_reconciled;
576 split->value = s->value;
577 split->amount = s->amount;
589 xaccSplitCloneNoKvp (
const Split *s)
591 Split *split = g_object_new (GNC_TYPE_SPLIT, NULL);
593 split->parent = NULL;
594 split->memo = CACHE_INSERT(s->memo);
595 split->action = CACHE_INSERT(s->action);
596 split->reconciled = s->reconciled;
597 split->date_reconciled = s->date_reconciled;
598 split->value = s->value;
599 split->amount = s->amount;
600 split->balance = s->balance;
601 split->cleared_balance = s->cleared_balance;
602 split->reconciled_balance = s->reconciled_balance;
603 split->noclosing_balance = s->noclosing_balance;
605 split->gains = GAINS_STATUS_UNKNOWN;
606 split->gains_split = NULL;
620 xaccSplitCopyKvp (
const Split *from, Split *to)
622 qof_instance_copy_kvp (QOF_INSTANCE (to), QOF_INSTANCE (from));
639 if (!from_split || !to_split)
return;
652 qof_instance_set_dirty(QOF_INSTANCE(to_split));
659 #ifdef DUMP_FUNCTIONS 661 xaccSplitDump (
const Split *split,
const char *tag)
664 memset (datebuff, 0,
sizeof(datebuff));
666 printf(
" %s Split %p", tag, split);
668 printf(
" Account: %p (%s)\n", split->acc,
670 printf(
" Commod: %s\n",
674 printf(
" Lot: %p\n", split->lot);
675 printf(
" Parent: %p\n", split->parent);
676 printf(
" Gains: %p\n", split->gains_split);
677 printf(
" Memo: %s\n", split->memo ? split->memo :
"(null)");
678 printf(
" Action: %s\n", split->action ? split->action :
"(null)");
679 printf(
" KVP Data: %s\n", qof_instance_kvp_as_string (QOF_INSTANCE (split)));
680 printf(
" Recncld: %c (date %s)\n", split->reconciled, datebuff);
686 printf(
" RBalance: %s\n",
697 xaccFreeSplit (Split *split)
702 if (((
char *) 1) == split->memo)
704 PERR (
"double-free %p", split);
707 CACHE_REMOVE(split->memo);
708 CACHE_REMOVE(split->action);
711 split->memo = (
char *) 1;
712 split->action = NULL;
713 split->reconciled =
NREC;
714 split->amount = gnc_numeric_zero();
715 split->value = gnc_numeric_zero();
716 split->parent = NULL;
719 split->orig_acc = NULL;
721 split->date_reconciled = 0;
722 G_OBJECT_CLASS (QOF_INSTANCE_GET_CLASS (&split->inst))->dispose(G_OBJECT (split));
724 if (split->gains_split)
727 split->gains_split->gains_split = NULL;
729 other->gains_split = NULL;
732 g_object_unref(split);
735 void mark_split (Split *s)
739 g_object_set(s->acc,
"sort-dirty", TRUE,
"balance-dirty", TRUE, NULL);
750 xaccSplitEqualCheckBal (
const char *tag, gnc_numeric a, gnc_numeric b)
760 PINFO (
"%sbalances differ: %s vs %s", tag, str_a, str_b);
773 gboolean check_guids,
774 gboolean check_balances,
775 gboolean check_txn_splits)
779 if (!sa && !sb)
return TRUE;
783 PINFO (
"one is NULL");
787 if (sa == sb)
return TRUE;
795 PINFO (
"GUIDs differ");
801 if ((same_book && sa->memo != sb->memo) || (!same_book && g_strcmp0(sa->memo, sb->memo) != 0))
803 PINFO (
"memos differ: (%p)%s vs (%p)%s",
804 sa->memo, sa->memo, sb->memo, sb->memo);
808 if ((same_book && sa->action != sb->action) || (!same_book && g_strcmp0(sa->action, sb->action) != 0))
810 PINFO (
"actions differ: %s vs %s", sa->action, sb->action);
814 if (qof_instance_compare_kvp (QOF_INSTANCE (sa), QOF_INSTANCE (sb)) != 0)
819 frame_a = qof_instance_kvp_as_string (QOF_INSTANCE (sa));
820 frame_b = qof_instance_kvp_as_string (QOF_INSTANCE (sb));
822 PINFO (
"kvp frames differ:\n%s\n\nvs\n\n%s", frame_a, frame_b);
830 if (sa->reconciled != sb->reconciled)
832 PINFO (
"reconcile flags differ: %c vs %c", sa->reconciled, sb->reconciled);
836 if (sa->date_reconciled != sb->date_reconciled)
838 PINFO (
"reconciled date differs");
850 PINFO (
"amounts differ: %s vs %s", str_a, str_b);
866 PINFO (
"values differ: %s vs %s", str_a, str_b);
876 if (!xaccSplitEqualCheckBal (
"", sa->balance, sb->balance))
878 if (!xaccSplitEqualCheckBal (
"cleared ", sa->cleared_balance,
879 sb->cleared_balance))
881 if (!xaccSplitEqualCheckBal (
"reconciled ", sa->reconciled_balance,
882 sb->reconciled_balance))
884 if (!xaccSplitEqualCheckBal (
"noclosing ", sa->noclosing_balance,
885 sb->noclosing_balance))
889 if (!
xaccTransEqual(sa->parent, sb->parent, check_guids, check_txn_splits,
890 check_balances, FALSE))
892 PINFO (
"transactions differ");
905 xaccSplitListGetUniqueTransactionsReversed (
const GList *splits)
907 GHashTable *txn_hash = g_hash_table_new (NULL, NULL);
908 GList *transList = NULL;
911 for (snode = splits; snode; snode = snode->next)
915 if (g_hash_table_contains (txn_hash, trans))
918 g_hash_table_insert (txn_hash, trans, NULL);
919 transList = g_list_prepend (transList, trans);
921 g_hash_table_destroy (txn_hash);
926 xaccSplitListGetUniqueTransactions(
const GList *splits)
928 return g_list_reverse (xaccSplitListGetUniqueTransactionsReversed (splits));
941 return s ? s->acc : NULL;
945 xaccSplitSetAccount (Split *s,
Account *acc)
949 g_return_if_fail(s && acc);
957 qof_instance_set_dirty(QOF_INSTANCE(s));
965 PERR(
"commit error: %d", errcode);
966 gnc_engine_signal_commit_error( errcode );
971 xaccSplitCommitEdit(Split *s)
980 orig_acc = s->orig_acc;
982 if (GNC_IS_ACCOUNT(s->acc))
988 gnc_lot_remove_split (s->lot, s);
995 PERR(
"Account lost track of moved or deleted split.");
1011 PERR(
"Account grabbed split prematurely.");
1016 if (s->parent != s->orig_parent)
1026 qof_event_gen (QOF_INSTANCE(s->lot), QOF_EVENT_MODIFY, NULL);
1032 s->orig_acc = s->acc;
1033 s->orig_parent = s->parent;
1040 g_object_set(acc,
"sort-dirty", TRUE,
"balance-dirty", TRUE, NULL);
1047 xaccSplitRollbackEdit(Split *s)
1053 if (s->acc != s->orig_acc)
1054 s->acc = s->orig_acc;
1060 qof_instance_set_destroying(s, FALSE);
1068 xaccSplitSetParent(s, s->orig_parent);
1078 if (!guid || !book)
return NULL;
1094 xaccSplitDetermineGainStatus (Split *split)
1097 GValue v = G_VALUE_INIT;
1100 if (GAINS_STATUS_UNKNOWN != split->gains)
return;
1105 split->gains = GAINS_STATUS_A_VDIRTY | GAINS_STATUS_DATE_DIRTY;
1106 split->gains_split = other;
1111 if (G_VALUE_HOLDS_BOXED (&v))
1112 guid = (
GncGUID*)g_value_get_boxed (&v);
1116 split->gains = GAINS_STATUS_A_VDIRTY | GAINS_STATUS_DATE_DIRTY;
1123 split->gains = GAINS_STATUS_GAINS;
1125 split->gains_split = other;
1134 get_currency_denom(
const Split * s)
1136 if (!(s && s->parent && s->parent->common_currency))
1147 get_commodity_denom(
const Split * s)
1174 SET_GAINS_A_VDIRTY(s);
1176 qof_instance_set_dirty(QOF_INSTANCE(s));
1182 qofSplitSetSharePrice (Split *split, gnc_numeric price)
1184 g_return_if_fail(split);
1186 price, get_currency_denom(split),
1202 price, get_currency_denom(s),
1205 SET_GAINS_VDIRTY(s);
1207 qof_instance_set_dirty(QOF_INSTANCE(s));
1213 qofSplitSetAmount (Split *split, gnc_numeric amt)
1215 g_return_if_fail(split);
1223 split->amount = amt;
1233 ENTER (
"(split=%p) old amt=%" G_GINT64_FORMAT
"/%" G_GINT64_FORMAT
1234 " new amt=%" G_GINT64_FORMAT
"/%" G_GINT64_FORMAT, s,
1235 s->amount.num, s->amount.denom, amt.num, amt.denom);
1247 SET_GAINS_ADIRTY(s);
1249 qof_instance_set_dirty(QOF_INSTANCE(s));
1255 qofSplitSetValue (Split *split, gnc_numeric amt)
1257 g_return_if_fail(split);
1267 gnc_numeric new_val;
1271 ENTER (
"(split=%p) old val=%" G_GINT64_FORMAT
"/%" G_GINT64_FORMAT
1272 " new val=%" G_GINT64_FORMAT
"/%" G_GINT64_FORMAT, s,
1273 s->value.num, s->value.denom, amt.num, amt.denom);
1285 PERR(
"numeric error %s in converting the split value's denominator with amount %s and denom %d",
1290 SET_GAINS_VDIRTY(s);
1292 qof_instance_set_dirty(QOF_INSTANCE(s));
1303 return s ? s->balance : gnc_numeric_zero();
1309 return s ? s->noclosing_balance : gnc_numeric_zero();
1315 return s ? s->cleared_balance : gnc_numeric_zero();
1321 return s ? s->reconciled_balance : gnc_numeric_zero();
1326 const gnc_commodity * base_currency)
1328 const gnc_commodity *currency;
1329 const gnc_commodity *commodity;
1336 PERR (
"split must have a parent account");
1351 get_commodity_denom(s),
1355 get_currency_denom(s),
1365 PERR (
"inappropriate base currency %s " 1366 "given split currency=%s and commodity=%s\n",
1373 SET_GAINS_A_VDIRTY(s);
1375 qof_instance_set_dirty(QOF_INSTANCE(s));
1382 if (!s || !s->acc || !s->parent)
return gnc_numeric_zero();
1391 PERR (
"inappropriate base currency %s " 1392 "given split currency=%s and commodity=%s\n",
1396 return gnc_numeric_zero();
1403 xaccSplitConvertAmount (
const Split *split,
const Account * account)
1405 gnc_commodity *acc_com, *to_commodity;
1407 gnc_numeric amount, value, convrate;
1414 if (split_acc == account)
1437 gnc_commodity* split_comm =
1443 PERR(
"The split's (%s) amount can't be converted from %s into %s.",
1448 return gnc_numeric_zero();
1466 convrate = xaccTransGetAccountConvRate(txn, account);
1482 if (!split)
return TRUE;
1485 trans = split->parent;
1494 qof_instance_set_dirty(QOF_INSTANCE(split));
1495 qof_instance_set_destroying(split, TRUE);
1510 const char *da, *db;
1511 gboolean action_for_num;
1513 if (sa == sb)
return 0;
1524 sb->parent, sb->action);
1527 if (retval)
return retval;
1530 da = sa->memo ? sa->memo :
"";
1531 db = sb->memo ? sb->memo :
"";
1532 retval = g_utf8_collate (da, db);
1537 da = sa->action ? sa->action :
"";
1538 db = sb->action ? sb->action :
"";
1539 retval = g_utf8_collate (da, db);
1544 if (sa->reconciled < sb->reconciled)
return -1;
1545 if (sa->reconciled > sb->reconciled)
return +1;
1549 if (comp < 0)
return -1;
1550 if (comp > 0)
return +1;
1553 if (comp < 0)
return -1;
1554 if (comp > 0)
return +1;
1557 if (sa->date_reconciled < sb->date_reconciled)
1559 else if (sa->date_reconciled > sb->date_reconciled)
1564 if (retval)
return retval;
1570 xaccSplitOrderDateOnly (
const Split *sa,
const Split *sb)
1572 Transaction *ta, *tb;
1574 if (sa == sb)
return 0;
1581 if ( !ta && !tb )
return 0;
1582 if ( !tb )
return -1;
1583 if ( !ta )
return +1;
1585 if (ta->date_posted == tb->date_posted)
1587 return (ta->date_posted > tb->date_posted) - (ta->date_posted < tb->date_posted);
1591 get_corr_account_split(
const Split *sa,
const Split **retval)
1594 g_return_val_if_fail(sa, FALSE);
1610 static const char *split_const = NULL;
1611 const Split *other_split;
1613 if (!get_corr_account_split(sa, &other_split))
1616 split_const = _(
"-- Split Transaction --");
1627 static const char *split_const = NULL;
1628 const Split *other_split;
1630 if (!get_corr_account_split(sa, &other_split))
1633 split_const = _(
"-- Split Transaction --");
1635 return g_strdup(split_const);
1643 static const char *split_const = NULL;
1644 const Split *other_split;
1646 if (!get_corr_account_split(sa, &other_split))
1649 split_const = C_(
"Displayed account code of the other account in a multi-split transaction",
"Split");
1661 char *full_a, *full_b;
1663 if (!sa && !sb)
return 0;
1671 retval = g_utf8_collate(full_a, full_b);
1682 if (!sa && !sb)
return 0;
1697 if (!sa && !sb)
return 0;
1707 retval = g_strcmp0(ca, cb);
1716 const char *ca, *cb;
1717 if (!sa && !sb)
return 0;
1723 return g_strcmp0(ca, cb);
1727 qofSplitSetMemo (Split *split,
const char* memo)
1729 g_return_if_fail(split);
1730 CACHE_REPLACE(split->memo, memo);
1736 if (!split || !memo)
return;
1739 CACHE_REPLACE(split->memo, memo);
1740 qof_instance_set_dirty(QOF_INSTANCE(split));
1746 qofSplitSetAction (Split *split,
const char *actn)
1748 g_return_if_fail(split);
1749 CACHE_REPLACE(split->action, actn);
1755 if (!split || !actn)
return;
1758 CACHE_REPLACE(split->action, actn);
1759 qof_instance_set_dirty(QOF_INSTANCE(split));
1765 qofSplitSetReconcile (Split *split,
char recn)
1767 g_return_if_fail(split);
1775 split->reconciled = recn;
1780 PERR(
"Bad reconciled flag");
1788 if (!split || split->reconciled == recn)
return;
1798 split->reconciled = recn;
1800 qof_instance_set_dirty(QOF_INSTANCE(split));
1804 PERR(
"Bad reconciled flag");
1817 split->date_reconciled = secs;
1818 qof_instance_set_dirty(QOF_INSTANCE(split));
1828 return split ? split->date_reconciled : 0;
1839 return split ? split->parent : NULL;
1843 xaccSplitSetParent(Split *s, Transaction *t)
1845 Transaction *old_trans;
1848 g_return_if_fail(s);
1849 if (s->parent == t)
return;
1851 if (s->parent != s->orig_parent && s->orig_parent != t)
1852 PERR(
"You may not add the split to more than one transaction" 1853 " during the BeginEdit/CommitEdit block.");
1855 old_trans = s->parent;
1863 qof_event_gen(&old_trans->inst, GNC_EVENT_ITEM_REMOVED, &ed);
1868 qof_instance_set_dirty(QOF_INSTANCE(s));
1876 if (NULL == g_list_find(t->splits, s))
1877 t->splits = g_list_append(t->splits, s);
1889 return split ? split->lot : NULL;
1897 qof_instance_set_dirty(QOF_INSTANCE(split));
1904 return split ? split->memo : NULL;
1910 return split ? split->action : NULL;
1916 return split ? split->reconciled :
' ';
1923 return split ? split->amount : gnc_numeric_zero();
1929 return split ? split->value : gnc_numeric_zero();
1935 gnc_numeric amt, val, price;
1936 if (!split)
return gnc_numeric_create(0, 1);
1946 return gnc_numeric_create(0, 1);
1958 PERR(
"Computing share price failed (%d): [ %" G_GINT64_FORMAT
" / %" 1959 G_GINT64_FORMAT
" ] / [ %" G_GINT64_FORMAT
" / %" G_GINT64_FORMAT
" ]",
1961 return gnc_numeric_create(0, 1);
1979 if (!s)
return NULL;
1981 GValue v = G_VALUE_INIT;
1984 type = G_VALUE_HOLDS_STRING (&v) ? g_value_get_string (&v) : NULL;
1986 if (!type || !g_strcmp0 (type, split_type_normal))
1987 rv = split_type_normal;
1988 else if (!g_strcmp0 (type, split_type_stock_split))
1989 rv = split_type_stock_split;
1992 PERR (
"unexpected split-type %s, reset to normal.", type);
1993 rv = split_type_normal;
2004 GValue v = G_VALUE_INIT;
2007 s->value = gnc_numeric_zero();
2008 g_value_init (&v, G_TYPE_STRING);
2009 g_value_set_static_string (&v, split_type_stock_split);
2011 SET_GAINS_VDIRTY(s);
2013 qof_instance_set_dirty(QOF_INSTANCE(s));
2024 g_return_if_fail (split != NULL);
2025 g_return_if_fail (other_split != NULL);
2029 qof_instance_kvp_add_guid (QOF_INSTANCE (split),
"lot-split",
2032 qof_instance_set_dirty (QOF_INSTANCE (split));
2039 return qof_instance_has_slot (QOF_INSTANCE (split),
"lot-split");
2047 g_return_val_if_fail (split != NULL, FALSE);
2048 g_return_val_if_fail (other_split != NULL, FALSE);
2051 return qof_instance_kvp_has_guid (QOF_INSTANCE (split),
"lot-split",
2060 g_return_if_fail (split != NULL);
2061 g_return_if_fail (other_split != NULL);
2065 qof_instance_kvp_remove_guid (QOF_INSTANCE (split),
"lot-split",
2068 qof_instance_set_dirty (QOF_INSTANCE (split));
2076 qof_instance_kvp_merge_guids (QOF_INSTANCE (split),
2077 QOF_INSTANCE (other_split),
"lot-split");
2079 qof_instance_set_dirty (QOF_INSTANCE (split));
2099 Split *other = NULL;
2101 if (!split)
return NULL;
2102 trans = split->parent;
2103 if (!trans)
return NULL;
2109 (!xaccTransStillHasSplit(trans, s)) ||
2111 (qof_instance_has_slot (QOF_INSTANCE (s),
"lot-split")))
2128 GValue v = G_VALUE_INIT;
2129 gnc_numeric *num = NULL;
2131 g_return_val_if_fail(split, gnc_numeric_zero());
2133 if (G_VALUE_HOLDS_BOXED (&v))
2134 num = (gnc_numeric*)g_value_get_boxed (&v);
2135 retval = num ? *num : gnc_numeric_zero();
2143 GValue v = G_VALUE_INIT;
2144 gnc_numeric *num = NULL;
2146 g_return_val_if_fail(split, gnc_numeric_zero());
2148 if (G_VALUE_HOLDS_BOXED (&v))
2149 num = (gnc_numeric*)g_value_get_boxed (&v);
2150 retval = num ? *num : gnc_numeric_zero();
2156 xaccSplitVoid(Split *split)
2158 gnc_numeric zero = gnc_numeric_zero(), num;
2159 GValue v = G_VALUE_INIT;
2161 g_value_init (&v, GNC_TYPE_NUMERIC);
2163 g_value_set_boxed (&v, &num);
2167 g_value_set_boxed (&v, &num);
2178 xaccSplitUnvoid(Split *split)
2185 qof_instance_set_dirty (QOF_INSTANCE (split));
2201 static QofObject split_object_def =
2204 DI(.e_type = ) GNC_ID_SPLIT,
2205 DI(.type_label = ) "Split",
2207 DI(.book_begin = ) NULL,
2208 DI(.book_end = ) NULL,
2217 split_account_guid_getter (gpointer obj, const QofParam *p)
2222 if (!s)
return NULL;
2224 if (!acc)
return NULL;
2229 DxaccSplitGetShareAmount (
const Split * split)
2235 no_op (gpointer obj,
const QofParam *p)
2241 qofSplitSetParentTrans(Split *s,
QofInstance *ent)
2243 Transaction *trans = (Transaction*)ent;
2245 g_return_if_fail(trans);
2246 xaccSplitSetParent(s, trans);
2254 g_return_if_fail(acc);
2255 xaccSplitSetAccount(s, acc);
2258 gboolean xaccSplitRegister (
void)
2260 static const QofParam params[] =
2263 SPLIT_DATE_RECONCILED, QOF_TYPE_DATE,
2271 "d-share-amount", QOF_TYPE_DOUBLE,
2275 "d-share-int64", QOF_TYPE_INT64,
2279 SPLIT_BALANCE, QOF_TYPE_NUMERIC,
2283 SPLIT_CLEARED_BALANCE, QOF_TYPE_NUMERIC,
2287 SPLIT_RECONCILED_BALANCE, QOF_TYPE_NUMERIC,
2291 SPLIT_MEMO, QOF_TYPE_STRING,
2295 SPLIT_ACTION, QOF_TYPE_STRING,
2299 SPLIT_RECONCILE, QOF_TYPE_CHAR,
2304 SPLIT_AMOUNT, QOF_TYPE_NUMERIC,
2308 SPLIT_SHARE_PRICE, QOF_TYPE_NUMERIC,
2313 SPLIT_VALUE, QOF_TYPE_DEBCRED,
2318 SPLIT_VOIDED_AMOUNT, QOF_TYPE_NUMERIC,
2322 SPLIT_VOIDED_VALUE, QOF_TYPE_NUMERIC,
2327 SPLIT_TRANS, GNC_ID_TRANS,
2332 SPLIT_ACCOUNT, GNC_ID_ACCOUNT,
2338 { SPLIT_ACCT_FULLNAME, SPLIT_ACCT_FULLNAME, no_op, NULL },
2339 { SPLIT_CORR_ACCT_NAME, SPLIT_CORR_ACCT_NAME, no_op, NULL },
2340 { SPLIT_CORR_ACCT_CODE, SPLIT_CORR_ACCT_CODE, no_op, NULL },
2343 QOF_PARAM_GUID, QOF_TYPE_GUID,
2362 _utest_split_fill_functions (
void)
2366 func->xaccSplitEqualCheckBal = xaccSplitEqualCheckBal;
2367 func->get_currency_denom = get_currency_denom;
2368 func->get_commodity_denom = get_commodity_denom;
2369 func->get_corr_account_split = get_corr_account_split;
void xaccSplitSetValue(Split *s, gnc_numeric amt)
The xaccSplitSetValue() method sets the value of this split in the transaction's commodity.
int qof_instance_version_cmp(const QofInstance *left, const QofInstance *right)
Compare two instances, based on their last update times.
gnc_numeric xaccSplitGetClearedBalance(const Split *s)
The cleared-balance is the currency-denominated balance of all transactions that have been marked as ...
gint xaccSplitOrder(const Split *sa, const Split *sb)
The xaccSplitOrder(sa,sb) method is useful for sorting.
void xaccSplitAddPeerSplit(Split *split, const Split *other_split, time64 timestamp)
Add a peer split to this split's lot-split list.
gboolean gnc_numeric_equal(gnc_numeric a, gnc_numeric b)
Equivalence predicate: Returns TRUE (1) if a and b represent the same number.
void xaccSplitSetBaseValue(Split *s, gnc_numeric value, const gnc_commodity *base_currency)
Depending on the base_currency, set either the value or the amount of this split or both: If the base...
void xaccSplitSetAction(Split *split, const char *actn)
The Action is an arbitrary user-assigned string.
gchar * gnc_num_dbg_to_string(gnc_numeric n)
Convert to string.
int gnc_commodity_get_fraction(const gnc_commodity *cm)
Retrieve the fraction for the specified commodity.
void xaccSplitMakeStockSplit(Split *s)
Mark a split to be of type stock split - after this, you shouldn't modify the value anymore...
const GncGUID * qof_instance_get_guid(gconstpointer inst)
Return the GncGUID of this instance.
void qof_instance_set_kvp(QofInstance *, GValue const *value, unsigned count,...)
Sets a KVP slot to a value from a GValue.
int xaccSplitCompareAccountCodes(const Split *sa, const Split *sb)
Compare two splits by code of account.
const char * gnc_commodity_get_mnemonic(const gnc_commodity *cm)
Retrieve the mnemonic for the specified commodity.
#define qof_instance_is_dirty
Return value of is_dirty flag.
QofBook * qof_instance_get_book(gconstpointer inst)
Return the book pointer.
gboolean qof_collection_is_dirty(const QofCollection *col)
Return value of 'dirty' flag on collection.
QofInstance * qof_collection_lookup_entity(const QofCollection *col, const GncGUID *guid)
Find the entity going only from its guid.
#define PINFO(format, args...)
Print an informational note.
gnc_numeric xaccSplitGetReconciledBalance(const Split *s)
Returns the reconciled-balance of this split.
GNCAccountType xaccAccountGetType(const Account *acc)
Returns the account's account type.
gboolean xaccSplitDestroy(Split *split)
Destructor.
QofBackendError
The errors that can be reported to the GUI & other front-end users.
int xaccAccountGetCommoditySCU(const Account *acc)
Return the SCU for the account.
const char * xaccAccountGetCode(const Account *acc)
Get the account's accounting code.
gnc_numeric gnc_numeric_neg(gnc_numeric a)
Returns a newly created gnc_numeric that is the negative of the given gnc_numeric value...
GncGUID * guid_copy(const GncGUID *guid)
Returns a newly allocated GncGUID that matches the passed-in GUID.
const char * xaccTransGetReadOnly(Transaction *trans)
Returns a non-NULL value if this Transaction was marked as read-only with some specific "reason" text...
gboolean qof_instance_get_destroying(gconstpointer ptr)
Retrieve the flag that indicates whether or not this object is about to be destroyed.
void xaccSplitCopyOnto(const Split *from_split, Split *to_split)
This is really a helper for xaccTransCopyOnto.
void qof_instance_set(QofInstance *inst, const gchar *first_prop,...)
Wrapper for g_object_set Group setting multiple parameters in a single begin/commit/rollback.
gboolean qof_book_use_split_action_for_num_field(const QofBook *book)
Returns TRUE if this book uses split action field as the 'Num' field, FALSE if it uses transaction nu...
void qof_class_register(QofIdTypeConst obj_name, QofSortFunc default_sort_function, const QofParam *params)
This function registers a new object class with the Qof subsystem.
char xaccSplitGetReconcile(const Split *split)
Returns the value of the reconcile flag.
gboolean gnc_commodity_equal(const gnc_commodity *a, const gnc_commodity *b)
This routine returns TRUE if the two commodities are equal.
void gnc_lot_add_split(GNCLot *lot, Split *split)
The gnc_lot_add_split() routine adds a split to this lot.
gboolean gnc_account_remove_split(Account *acc, Split *s)
Remove the given split from an account.
gboolean gnc_numeric_zero_p(gnc_numeric a)
Returns 1 if the given gnc_numeric is 0 (zero), else returns 0.
void xaccSplitSetReconcile(Split *split, char recn)
Set the reconcile flag.
void xaccAccountInsertLot(Account *acc, GNCLot *lot)
The xaccAccountInsertLot() method will register the indicated lot with this account.
Transaction * xaccSplitGetParent(const Split *split)
Returns the parent transaction of the split.
API for Transactions and Splits (journal entries)
gchar * guid_to_string_buff(const GncGUID *guid, gchar *str)
The guid_to_string_buff() routine puts a null-terminated string encoding of the id into the memory po...
void xaccSplitRemovePeerSplit(Split *split, const Split *other_split)
Remove a peer split from this split's lot-split list.
int(* QofSortFunc)(gconstpointer, gconstpointer)
This function is the default sort function for a particular object type.
int gnc_numeric_compare(gnc_numeric a, gnc_numeric b)
Returns 1 if a>b, -1 if b>a, 0 if a == b.
gboolean xaccTransIsBalanced(const Transaction *trans)
Returns true if the transaction is balanced according to the rules currently in effect.
#define QOF_OBJECT_VERSION
Defines the version of the core object object registration interface.
gchar * gnc_numeric_to_string(gnc_numeric n)
Convert to string.
int xaccSplitCompareOtherAccountFullNames(const Split *sa, const Split *sb)
Compare two splits by full name of the other account.
#define PERR(format, args...)
Log a serious error.
QofBook * xaccSplitGetBook(const Split *split)
Returns the book of this split, i.e.
int xaccTransOrder_num_action(const Transaction *ta, const char *actna, const Transaction *tb, const char *actnb)
The xaccTransOrder_num_action(ta,actna,tb,actnb) method is useful for sorting.
#define ENTER(format, args...)
Print a function entry debugging message.
gnc_numeric xaccSplitGetBalance(const Split *s)
Returns the running balance up to and including the indicated split.
#define QOF_PARAM_BOOK
"Known" Object Parameters – all objects must support these
Split * xaccSplitGetCapGainsSplit(const Split *split)
The xaccSplitGetCapGainsSplit() routine returns the split that records the cap gains for this split...
void gnc_lot_set_closed_unknown(GNCLot *lot)
Reset closed flag so that it will be recalculated.
void qof_collection_foreach(const QofCollection *col, QofInstanceForeachCB cb_func, gpointer user_data)
Call the callback for each entity in the collection.
void(* QofSetterFunc)(gpointer, gpointer)
The QofSetterFunc defines an function pointer for parameter setters.
void qof_instance_get_kvp(QofInstance *, GValue *value, unsigned count,...)
Retrieves the contents of a KVP slot into a provided GValue.
int xaccSplitCompareAccountFullNames(const Split *sa, const Split *sb)
Compare two splits by full name of account.
#define VREC
split is void
Account used to record multiple commodity transactions.
gboolean xaccSplitEqual(const Split *sa, const Split *sb, gboolean check_guids, gboolean check_balances, gboolean check_txn_splits)
Equality.
gboolean xaccSplitHasPeers(const Split *split)
Does this split have peers?
void qof_instance_init_data(QofInstance *inst, QofIdType type, QofBook *book)
Initialise the settings associated with an instance.
int xaccTransCountSplits(const Transaction *trans)
Returns the number of splits in this transaction.
#define xaccAccountGetGUID(X)
double gnc_numeric_to_double(gnc_numeric in)
Convert numeric to floating-point value.
convert single-entry accounts to clean double-entry
void xaccSplitMergePeerSplits(Split *split, const Split *other_split)
Merge the other_split's peer splits into split's peers.
gnc_numeric xaccSplitVoidFormerAmount(const Split *split)
Returns the original pre-void amount of a split.
Split * xaccSplitLookup(const GncGUID *guid, QofBook *book)
The xaccSplitLookup() subroutine will return the split associated with the given id, or NULL if there is no such split.
guint32 qof_instance_get_idata(gconstpointer inst)
get the instance tag number used for kvp management in sql backends.
void xaccSplitSetAmount(Split *s, gnc_numeric amt)
The xaccSplitSetAmount() method sets the amount in the account's commodity that the split should have...
gchar * gnc_account_get_full_name(const Account *account)
The gnc_account_get_full_name routine returns the fully qualified name of the account using the given...
gboolean xaccTransEqual(const Transaction *ta, const Transaction *tb, gboolean check_guids, gboolean check_splits, gboolean check_balances, gboolean assume_ordered)
Equality.
gnc_numeric gnc_numeric_convert(gnc_numeric n, gint64 denom, gint how)
Change the denominator of a gnc_numeric value to the specified denominator under standard arguments '...
gnc_numeric xaccSplitVoidFormerValue(const Split *split)
Returns the original pre-void value of a split.
#define YREC
The Split has been reconciled.
gnc_numeric gnc_numeric_mul(gnc_numeric a, gnc_numeric b, gint64 denom, gint how)
Multiply a times b, returning the product.
const char * gnc_numeric_errorCode_to_string(GNCNumericErrorCode error_code)
Returns a string representation of the given GNCNumericErrorCode.
void xaccSplitSetMemo(Split *split, const char *memo)
The memo is an arbitrary string associated with a split.
#define GUID_ENCODING_LENGTH
Number of characters needed to encode a guid as a string not including the null terminator.
#define FREC
frozen into accounting period
int xaccSplitCompareOtherAccountCodes(const Split *sa, const Split *sb)
Compare two splits by code of the other account.
void xaccSplitSetSharePriceAndAmount(Split *s, gnc_numeric price, gnc_numeric amt)
The xaccSplitSetSharePriceAndAmount() method will simultaneously update the share price and the numbe...
void qof_instance_copy_book(gpointer ptr1, gconstpointer ptr2)
Copy the book from one QofInstances to another.
gnc_numeric xaccSplitGetNoclosingBalance(const Split *s)
The noclosing-balance is the currency-denominated balance of all transactions except 'closing' transa...
#define SPLIT_ACCOUNT_GUID
for guid_match_all
void xaccAccountRecomputeBalance(Account *acc)
The following recompute the partial balances (stored with the transaction) and the total balance...
gboolean xaccSplitIsPeerSplit(const Split *split, const Split *other_split)
Report if a split is a peer of this one.
char * xaccSplitGetCorrAccountFullName(const Split *sa)
These functions take a split, get the corresponding split on the "other side" of the transaction...
gboolean qof_commit_edit_part2(QofInstance *inst, void(*on_error)(QofInstance *, QofBackendError), void(*on_done)(QofInstance *), void(*on_free)(QofInstance *))
part2 – deal with the backend
gpointer(* QofAccessFunc)(gpointer object, const QofParam *param)
The QofAccessFunc defines an arbitrary function pointer for access functions.
#define MAX_DATE_LENGTH
The maximum length of a string created by the date printers.
void qof_collection_mark_clean(QofCollection *)
reset value of dirty flag
void xaccTransCommitEdit(Transaction *trans)
The xaccTransCommitEdit() method indicates that the changes to the transaction and its splits are com...
Additional event handling code.
gnc_numeric gnc_numeric_div(gnc_numeric a, gnc_numeric b, gint64 denom, gint how)
Division.
#define xaccSplitGetGUID(X)
void xaccTransBeginEdit(Transaction *trans)
The xaccTransBeginEdit() method must be called before any changes are made to a transaction or any of...
gnc_numeric xaccSplitGetSharePrice(const Split *split)
Returns the price of the split, that is, the value divided by the amount.
int xaccTransGetSplitIndex(const Transaction *trans, const Split *split)
Inverse of xaccTransGetSplit()
gboolean gnc_numeric_eq(gnc_numeric a, gnc_numeric b)
Equivalence predicate: Returns TRUE (1) if a and b are exactly the same (have the same numerator and ...
All type declarations for the whole Gnucash engine.
const GncGUID * qof_entity_get_guid(gconstpointer ent)
#define CREC
The Split has been cleared.
gboolean qof_instance_books_equal(gconstpointer ptr1, gconstpointer ptr2)
See if two QofInstances share the same book.
gnc_numeric xaccSplitGetBaseValue(const Split *s, const gnc_commodity *base_currency)
Depending on the base_currency, return either the value or the amount of this split: If the base_curr...
Split * xaccMallocSplit(QofBook *book)
Constructor.
const char * xaccSplitGetCorrAccountName(const Split *sa)
document me
Encapsulate all the information about a dataset.
gboolean gnc_account_insert_split(Account *acc, Split *s)
Insert the given split from an account.
void xaccSplitSetLot(Split *split, GNCLot *lot)
Assigns the split to a specific Lot.
API for the transaction logger.
const char * gnc_commodity_get_printname(const gnc_commodity *cm)
Retrieve the 'print' name for the specified commodity.
void xaccSplitSetDateReconciledSecs(Split *split, time64 secs)
Set the date on which this split was reconciled by specifying the time as time64. ...
time64 xaccSplitGetDateReconciled(const Split *split)
Retrieve the date when the Split was reconciled.
gnc_numeric xaccSplitGetValue(const Split *split)
Returns the value of this split in the transaction's commodity.
Account * xaccSplitGetAccount(const Split *s)
Returns the account of this split, which was set through xaccAccountInsertSplit().
gnc_commodity * xaccAccountGetCommodity(const Account *acc)
Get the account's commodity.
gnc_commodity * xaccTransGetCurrency(const Transaction *trans)
Returns the valuation commodity of this transaction.
#define xaccAccountInsertSplit(acc, s)
The xaccAccountInsertSplit() method will insert the indicated split into the indicated account...
This is the private header for the account structure.
gint qof_instance_guid_compare(gconstpointer ptr1, gconstpointer ptr2)
Compare the GncGUID values of two instances.
const char * xaccSplitGetCorrAccountCode(const Split *sa)
document me
Split * xaccSplitGetOtherSplit(const Split *split)
The xaccSplitGetOtherSplit() is a convenience routine that returns the other of a pair of splits...
#define LEAVE(format, args...)
Print a function exit debugging message.
Round to the nearest integer, rounding away from zero when there are two equidistant nearest integers...
void xaccSplitSetSharePrice(Split *s, gnc_numeric price)
time64 gnc_time(time64 *tbuf)
get the current time
int xaccTransOrder(const Transaction *ta, const Transaction *tb)
The xaccTransOrder(ta,tb) method is useful for sorting.
GNCNumericErrorCode gnc_numeric_check(gnc_numeric in)
Check for error signal in value.
const char * xaccSplitGetMemo(const Split *split)
Returns the memo string.
const char * xaccSplitGetAction(const Split *split)
Returns the action string.
QofCollection * qof_book_get_collection(const QofBook *book, QofIdType entity_type)
Return The table of entities of the given type.
gint64 time64
Most systems that are currently maintained, including Microsoft Windows, BSD-derived Unixes and Linux...
Account * gnc_lot_get_account(const GNCLot *lot)
The gnc_lot_get_account() routine returns the account with which this lot is associated.
gboolean qof_object_register(const QofObject *object)
Register new types of object objects.
const char * xaccSplitGetType(const Split *s)
The xaccIsPeerSplit() is a convenience routine that returns TRUE (a non-zero value) if the two splits...
const char * xaccAccountGetName(const Account *acc)
Get the account's name.
void qof_event_gen(QofInstance *entity, QofEventId event_id, gpointer event_data)
Invoke all registered event handlers using the given arguments.
#define GNC_EVENT_ITEM_ADDED
These events are used when a split is added to an account.
#define GNC_DENOM_AUTO
Values that can be passed as the 'denom' argument.
The type used to store guids in C.
Utilities to Automatically Compute Capital Gains/Losses.
size_t qof_print_date_buff(char *buff, size_t buflen, time64 secs)
Convenience: calls through to qof_print_date_dmy_buff().
SplitList * xaccTransGetSplitList(const Transaction *trans)
The xaccTransGetSplitList() method returns a GList of the splits in a transaction.
Commodity handling public routines.
gboolean gnc_commodity_equiv(const gnc_commodity *a, const gnc_commodity *b)
This routine returns TRUE if the two commodities are equivalent.
GNCLot * xaccSplitGetLot(const Split *split)
Returns the pointer to the debited/credited Lot where this split belongs to, or NULL if it doesn't be...
#define NREC
not reconciled or cleared
gnc_numeric xaccSplitGetAmount(const Split *split)
Returns the amount of the split in the account's commodity.