JYACC FORMAKER C Programmer's Guide Contents 1 ... - Prolifics

NAMESYNOPSISsm_bitop - manipulate validation and data editing bits#include "smbitops.h"int sm_bitop(field_number, action, bit)int field_number;int action;int bit;DESCRIPTIONYou can use this function to inspect and modify validation and data editing bitsof screen fields, without reference to internal data structures. The firstparameter identifies the field to be operated upon.Action can include a test and at most one manipulation, from the following tableof mnemonics:MnemonicBIT_CLRMeaningTurn bit off BIT_SETTurn bit on BIT_TOGLFlip state of bit BIT_TSTReport state of bitThe third parameter is a bit identifier, drawn from the following table:Character editsN_ALLN_DIGIT N_YES_NON_ALPHA N_NUMERICN_ALPHNUM N_FCMASKField editsN_RTJUSTN_REQD N_VALIDEDN_MDT N_CLRINPN_MENU N_UPPERN_LOWER N_RETENTRYN_FILLED N_NOTABN_WRAP N_EPROTECTN_TPROTECT N_CPROTECTN_VPROTECT N_ALLPROTECTN_ADDLEDSThe character edits are not, strictly speaking, bits; you cannot toggle them,but the other functions work as you would expect. N_ALLPROTECT is a specialvalue meaning all four protect bits at once.N_VALIDED and N_MDT are the only bit operations that can apply offscreen. Allother bit operations are attached to fixed onscreen positions.This function has two variants, sm_a_bitop and sm_t_bitop, which perform therequested bit operation on all elements of an array. Their synopses appearbelow. If you include BIT_TST, these variants return 1 only if bit is set forevery element of the array. The variants sm_i_bitop and sm_o_bitop arerestricted to N_VALIDED and N_MDT.