Difference between revisions of "CURSORSETPROP()"
From Recital Documentation Wiki
Yvonnemilne (Talk | contribs) |
Yvonnemilne (Talk | contribs) |
||
| Line 44: | Line 44: | ||
==Example== | ==Example== | ||
<code lang="recital"> | <code lang="recital"> | ||
| + | close databases | ||
| + | clear | ||
| + | set exclusive off | ||
| + | open database southwind | ||
| + | use customers | ||
| + | // Set to known value before start | ||
| + | replace customerid with "ALFKI" | ||
| + | cursorsetprop("Buffering", 5, "customers") | ||
| + | messagebox("Buffering set to " +etos(cursorgetprop("Buffering"))) | ||
| + | |||
| + | ? "Original customerid value: " + customerid | ||
| + | ? "Curval(): " + curval("customerid") | ||
| + | ? "Oldval(): " + oldval("customerid") | ||
| + | ? "Fieldstate at start: " + getfldstate("customerid") | ||
| + | |||
| + | replace customerid WITH "RECIT" | ||
| + | |||
| + | // Alter in another session | ||
| + | ! recital -c "update southwind\!customers set customerid = 'MULTI' where recno() = 1" | ||
| + | ? "Someone else just updated the record!" | ||
| + | ? "New customerid value: " + customerid | ||
| + | ? "Curval(): " + curval("customerid") | ||
| + | ? "Oldval(): " + oldval("customerid") | ||
| + | ? "Fieldstate after replace: " + getfldstate("customerid") | ||
| + | tablerevert(.T.) | ||
| + | |||
| + | ? "Reverted customerid value: " + customerid | ||
| + | ? "Curval(): " + curval("customerid") | ||
| + | ? "Oldval(): " + oldval("customerid") | ||
| + | ? "Fieldstate after revert: " + getfldstate("customerid") | ||
| + | |||
| + | replace customerid WITH "RECIT" | ||
| + | ? "New customerid value: " + customerid | ||
| + | tableupdate(.T.) | ||
| + | ? "Updated customerid value: " + customerid | ||
| + | ? "Curval(): " + curval("customerid") | ||
| + | ? "Oldval(): " + oldval("customerid") | ||
| + | ? "Fieldstate after replace and update: " + getfldstate("customerid") | ||
| + | ? | ||
</code> | </code> | ||
Latest revision as of 12:15, 22 August 2011
Purpose
Function to define current property settings for a table or cursor
Syntax
CURSORSETPROP(<expC>, <expN> [, <workarea | alias>])
See Also
CURSORGETPROP(), CURVAL(), GETFLDSTATE(), OLDVAL(), TABLEREVERT(), TABLEUPDATE(), SETFLDSTATE()
Description
The CURSORSETPROP() function can be used to define the current property settings for a table or cursor.
If the optional <workarea | alias> is specified, then the function will operate in the required location.
<expC>
| Value | Description |
|---|---|
| Buffering | Current Buffering setting |
<expN>
| Value | Description |
|---|---|
| 1 | Row and table buffering off (default) |
| 2 | Pessimistic row buffering on |
| 3 | Optimistic row buffering on |
| 4 | Pessimistic table buffering on |
| 5 | Optimistic table buffering on |
Example
close databases clear set exclusive off open database southwind use customers // Set to known value before start replace customerid with "ALFKI" cursorsetprop("Buffering", 5, "customers") messagebox("Buffering set to " +etos(cursorgetprop("Buffering"))) ? "Original customerid value: " + customerid ? "Curval(): " + curval("customerid") ? "Oldval(): " + oldval("customerid") ? "Fieldstate at start: " + getfldstate("customerid") replace customerid WITH "RECIT" // Alter in another session ! recital -c "update southwind\!customers set customerid = 'MULTI' where recno() = 1" ? "Someone else just updated the record!" ? "New customerid value: " + customerid ? "Curval(): " + curval("customerid") ? "Oldval(): " + oldval("customerid") ? "Fieldstate after replace: " + getfldstate("customerid") tablerevert(.T.) ? "Reverted customerid value: " + customerid ? "Curval(): " + curval("customerid") ? "Oldval(): " + oldval("customerid") ? "Fieldstate after revert: " + getfldstate("customerid") replace customerid WITH "RECIT" ? "New customerid value: " + customerid tableupdate(.T.) ? "Updated customerid value: " + customerid ? "Curval(): " + curval("customerid") ? "Oldval(): " + oldval("customerid") ? "Fieldstate after replace and update: " + getfldstate("customerid") ?
Products
Recital, Recital Server
