Difference between revisions of "SETFLDSTATE()"

From Lianjapedia
Jump to: navigation, search
 
 
(6 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
==Purpose==
 
==Purpose==
 
Function to assign a field modification value to a field or record
 
Function to assign a field modification value to a field or record
 
  
 
==Syntax==
 
==Syntax==
 
SETFLDSTATE(<expC> | <expN1>, <expN2> [, <workarea | alias>])
 
SETFLDSTATE(<expC> | <expN1>, <expN2> [, <workarea | alias>])
 
  
 
==See Also==
 
==See Also==
 
[[CURSORGETPROP()]], [[CURSORSETPROP()]], [[CURVAL()]], [[GETFLDSTATE()]], [[OLDVAL()]], [[TABLEREVERT()]], [[TABLEUPDATE()]]
 
[[CURSORGETPROP()]], [[CURSORSETPROP()]], [[CURVAL()]], [[GETFLDSTATE()]], [[OLDVAL()]], [[TABLEREVERT()]], [[TABLEUPDATE()]]
 
  
 
==Description==
 
==Description==
Line 17: Line 14:
  
 
====<expN2>====
 
====<expN2>====
{| class="wikitable"
+
{| class="wikitable" width="100%"
 
!Value||Description
 
!Value||Description
 
|-
 
|-
Line 25: Line 22:
 
|-
 
|-
 
|}
 
|}
 
  
  
Line 46: Line 42:
 
? "Fieldstate at start: " + getfldstate("customerid")
 
? "Fieldstate at start: " + getfldstate("customerid")
  
replace customerid WITH "RECIT"
+
replace customerid WITH "LIANJ"
  
 
// Alter in another session
 
// Alter in another session
! recital -c "update southwind\!customers set customerid = 'MULTI' where recno() = 1"
+
// update southwind!customers set customerid = 'MULTI' where recno() = 1
 
? "Someone else just updated the record!"
 
? "Someone else just updated the record!"
 
? "New customerid value: " +  customerid  
 
? "New customerid value: " +  customerid  
Line 62: Line 58:
 
? "Fieldstate after revert: " + getfldstate("customerid")
 
? "Fieldstate after revert: " + getfldstate("customerid")
  
replace customerid WITH "RECIT"
+
replace customerid WITH "LIANJ"
 
? "New customerid value: " +  customerid  
 
? "New customerid value: " +  customerid  
 
tableupdate(.T.)
 
tableupdate(.T.)
Line 75: Line 71:
 
</code>
 
</code>
  
 
==Products==
 
Recital, Recital Server
 
 
[[Category:Documentation]]
 
[[Category:Documentation]]
 
[[Category:Functions]]
 
[[Category:Functions]]
[[Category:Buffered Processing]]
+
[[Category:Cursor Functions]]
[[Category:Buffered Processing Functions]]
+

Latest revision as of 13:39, 19 May 2014

Purpose

Function to assign a field modification value to a field or record

Syntax

SETFLDSTATE(<expC> | <expN1>, <expN2> [, <workarea | alias>])

See Also

CURSORGETPROP(), CURSORSETPROP(), CURVAL(), GETFLDSTATE(), OLDVAL(), TABLEREVERT(), TABLEUPDATE()

Description

The SETFLDSTATE() function can be used to change the field modification value for a field. The field can be specified using the field name in <expC> or the field number in <expN1>. The value to be assigned is specified in <expN2>.

If the optional <workarea | alias> is specified, then the function will operate in the required location.

<expN2>

Value Description
1 Field has not been modified
2 Field has been modified


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 "LIANJ"
 
// Alter in another session
// 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 "LIANJ"
? "New customerid value: " +  customerid 
tableupdate(.T.)
? "Updated customerid value: " +  customerid
? "Curval(): " + curval("customerid")
? "Oldval(): " + oldval("customerid")
? "Fieldstate after replace and update: " + getfldstate("customerid")
 
setfldstate("customerid",2)
? "Fieldstate after set: " + getfldstate("customerid")
?