
k_2Comp( cBinNum ) --> c2CompStr

Perform a binary 2's compliment.

--------------------------------------------------------------------------------

k_AAverage( anArray ) --> nAverage

Get average value of a numeric array.

--------------------------------------------------------------------------------

k_Ack( cAckMsg, cAckColor, nBoxType ) --> cAckMsg

Present a boxed message and wait for user acknowledgement.

--------------------------------------------------------------------------------

k_Add( cNum1, cNum2 ) --> cString

Perform addition up to 64,000 digits (I swear I'm not making this up!)

--------------------------------------------------------------------------------

k_AHighElement( axArray ) --> nHighElement

Find element with highest numeric, char or date value.

--------------------------------------------------------------------------------

k_AHighVal( axArray ) --> xHighVal

Get the highest VALUE from an array of chars, numerics or dates.

--------------------------------------------------------------------------------

k_Alen( aName ) --> nArrayLength

Determine the number of array elements, excluding NIL elements.

--------------------------------------------------------------------------------

k_AllFields(cFileName,cSepChar,cFieldFunc) --> cFieldNameString

Create a string expression containing all database field names.

--------------------------------------------------------------------------------

k_AllAlpha( cInStr ) --> lIsAllAlpha

Check if all characters in a string are alphabetic (A...Z only).

--------------------------------------------------------------------------------

k_ALowElement( axArray ) --> nLowElement

Get the element number of the lowest value in an array of char, num, or date.

--------------------------------------------------------------------------------

k_ALowVal( axArray ) --> xHighVal

Get the LOWEST value from an array of char, num, or date.

--------------------------------------------------------------------------------

k_AMaxStrElement( acArray ) --> nLongestElement

Get element number of longest character string in array.

--------------------------------------------------------------------------------

k_AMaxStrLen( acArray ) --> nLongestStringLength

Determine the length of the longest string from an array of strings.

--------------------------------------------------------------------------------

k_AND( nBinNum1, nBinNum2 ) --> nInteger

Perform Binary AND operation.

--------------------------------------------------------------------------------

k_AntiLog(nLog, nBase) --> nAntiLog

Calculate the Antilogarithm of a number.

--------------------------------------------------------------------------------

k_Ap( cAp_Char ) --> nOrdinalPosition

Determine alphabetic ordinal position of an alphabetic character.

--------------------------------------------------------------------------------

k_AppKill(cKillFileName) --> NIL

Prevent an application from being run, or stop one that is already running.

--------------------------------------------------------------------------------

k_AppxEqual(nNum1, nNum2, nDec) --> lIsAppxEqual

Determine floating point equality to a given decimal place.

--------------------------------------------------------------------------------

k_Array2Str(xArray) --> cString

Convert an array to a single character string.

--------------------------------------------------------------------------------

k_arraylen(axArrayName) --> nNumberElements

Count number of array elements that actually contain values.

--------------------------------------------------------------------------------

k_ArrayText( acArray, cFile, nWidth, lAppend ) --> nElementsWritten

Write an array to a text file.

--------------------------------------------------------------------------------

k_ASum( anArray, nDim ) --> nSum

Sum the values of an array of numerics.

--------------------------------------------------------------------------------

k_Attn( cMessage, aOptions, cColor, nRowMod, nColMod, nDefault ) --> nChoice

Replacement for Clipper's Alert() with additional control.

--------------------------------------------------------------------------------

k_B2Int(cBinString) --> nInteger

Convert binary string to integer equivalent

--------------------------------------------------------------------------------

k_BaseX2Dec( cNum, nBase ) --> nDecimalValue

Convert any base between 1 and 72 to decimal.

--------------------------------------------------------------------------------

k_BarGraphH(TopRow,TopCol,BotRow,BotCol,Degree_Prcnt,Fore_Char,Back_Char,Fore_

Color,Back_Color,Final_Only,Use_Zero) --> NIL

Provides a horizontal bargraph based upon "percent."

--------------------------------------------------------------------------------

k_BGraphV(TopRow,TopCol,BotRow,BotCol,Degree_Prcnt,Fore_Char,Back_Char,Fore_

Color,Back_Color,Final_Only,Use_Zero) --> NIL

Provides a verticle BarGraph based upon "percent."

--------------------------------------------------------------------------------

k_BigStuff(cString, acFindText )

Find and replace multiple occurances of multiple strings.

--------------------------------------------------------------------------------

k_Bold( cWhat ) --> cString

Double strike a print string.

--------------------------------------------------------------------------------

k_Box( nFRow, nFCol, nTRow, nTCol, nBox_Type, nLabel, cLabel_Txt) --> NIL

Draw a box with a "shadow."

--------------------------------------------------------------------------------

k_BtoI( xIn_Var ) --> nInteger

Convert Binary to Decimal Integer.

--------------------------------------------------------------------------------

k_BaseX2BaseY( cXNum, nXBase, nYBase ) --> cNumStr

Convert a number of any base 1...72 to any other base 1...72.

--------------------------------------------------------------------------------

k_CapFirst( cCap_Str ) --> cString

Return a string with captialized first letters.

--------------------------------------------------------------------------------

k_Cascade( cStartDir, cUDFName ) --> nInteger

Execute a function in every subdirectory.

--------------------------------------------------------------------------------

k_CDbl2Cld( cByteStr ) --> dDate

C Double to Clipper Date

--------------------------------------------------------------------------------

k_CDbl2Cln( cByteStr ) --> nDecimalNum

Convert C Double to Clipper Numeric.

--------------------------------------------------------------------------------

k_Chars( nLowBound, nHighBound ) --> cString

Create a string of characters between a low and high range.

--------------------------------------------------------------------------------

k_CheckDrive( cDrive ) --> lDriveReady

Check if Drive is available for READ/WRITE.

--------------------------------------------------------------------------------

k_CheckIndex(cDName, cNName, cKey ) --> NIL

Check and, if missing, build an index file.

--------------------------------------------------------------------------------

k_CheckSet(nSet) --> nStackSpaceRemaining

Check Set Stack space available.

--------------------------------------------------------------------------------

k_CheckSum( cString, nMode ) --> xRetVal

k_CheckSum() is a checksum generation and testing function.

--------------------------------------------------------------------------------

k_ChrLimit( cVar, cChar, nPercent ) --> lExceedsPercent

Determine if a string is composed of n% or more of any given character.

--------------------------------------------------------------------------------

k_ChCount( cInChar, cInStr ) --> nInteger

Count the number of times a character occurs in a string.

--------------------------------------------------------------------------------

k_Clr( nLine, nCol, nToLine, nToCol ) --> NIL

Clear a screen, region of a screen, line, or portion of a line.

--------------------------------------------------------------------------------

k_ClrWin( Win_Name ) --> NIL

Clear a window created by _Init_Win().

--------------------------------------------------------------------------------

k_Color2Num( cColor ) --> nColor

Convert a clipper color string to a Clipper internal color number.

--------------------------------------------------------------------------------

k_ColorOf( nColor ) --> cColor

k_ColorOf() returns the color pair setting for a given clipper color scheme.

--------------------------------------------------------------------------------

k_ColorSay(nRow, nCol, cString) --> NIL

Write text on screen matching colors already on screen at that position(s).

--------------------------------------------------------------------------------

k_Convert( cString, cException ) --> cString

Strip all non-alphanumeric from a string (with optional exceptions).

--------------------------------------------------------------------------------

k_Crypto( @cString, cKey ) --> NIL

--------------------------------------------------------------------------------

k_CryptoHI( @cString, cKey ) --> NIL

--------------------------------------------------------------------------------

k_Ctr( nCtrLine, cCtrMsg, lCtrClearLine ) --> NIL

Center a string on given line, optionally clearing line first.

--------------------------------------------------------------------------------

k_CtrVar( cCenterStr ) --> cString

Center (redistribute) a string within it's own length.

--------------------------------------------------------------------------------

k_CurVol() --> cDriveLette

Return the current DOS drive letter.

--------------------------------------------------------------------------------

k_DayFirst( dDate ) --> dFirstDay

Return the DATE of the first day of the month in date passed.

--------------------------------------------------------------------------------

k_DayLast( dDate ) --> nDay

Determine the date of the last day of the month, with respect for leap years.

--------------------------------------------------------------------------------

k_DaysBetween( xDate1, xDate2, nExcludeDays ) --> nDays

Determine days between dates.

--------------------------------------------------------------------------------

k_DaysInMonth( nMonth, nYear ) --> nDaysInMonth

Return the number of days in any given month, accounting for leap years.

--------------------------------------------------------------------------------

k_DBChoice(cDBName, cDBIndex, cDBFdExp, cRetExpr, nTRow, nTCol, nBRow, nBCol,

cColor, lBorder ) --> xExpression

Windowed database field picklist with return value from specified fields.

--------------------------------------------------------------------------------

k_Dec2BaseX( nNum, nBase ) --> cBaseNumString

Convert a decimal integer to any other base in the range 1...72.

--------------------------------------------------------------------------------

k_Dial(cPhoneNum, [nComPort]) --> nResult

Dial a number on the specified com port.

--------------------------------------------------------------------------------

k_Doy( dDate ) --> nDay

Calculate a "Julian" day of year number from a given date.

--------------------------------------------------------------------------------

k_DupRec( cSource_Area, cTarget_Area, l_move, l_Append ) --> lAppendStatus

Copy, optionally MOVE, records between work areas.

--------------------------------------------------------------------------------

k_Encrypt( cEncStr, cKey ) --> cEncryptStr

Encrypt a string.

--------------------------------------------------------------------------------

k_ExeName()

Return current application .EXE name and path.

--------------------------------------------------------------------------------

k_Extract( cStr, cDelim, nOccurance ) --> cString

Extract nth occurance of delimited string from another string.

--------------------------------------------------------------------------------

k_False() --> lFALSE

Return FALSE.

--------------------------------------------------------------------------------

k_FCombine(cFileName, cInsFileName, nInsByte ) --> nBytesWritten

Comine two files by inserting one into the other at a specified byte.

--------------------------------------------------------------------------------

k_cFCRC(cString) --> cCRCStamp

Generate CRC on a string.

--------------------------------------------------------------------------------

k_FDate(cFileName) --> dFileDate

Get date of specified DOS file.

--------------------------------------------------------------------------------

k_FDelete(cFileSpec) --> nNumberFilesDeleted

Delete specified file(s) from drive.

--------------------------------------------------------------------------------

k_FEOF( nHandle ) --> lEOFStatus

Check for end of file reached.

--------------------------------------------------------------------------------

k_File2Var(cFileName) --> xVariable

Retrieve variable values from disk file written by k_Var2File().

--------------------------------------------------------------------------------

k_FileBox( nTRow, nTCol, nBRow, cFileSpec, nBoxType, cBoxColor ) --> cFileStr

Display picklist of specified files and return filename/ext.

--------------------------------------------------------------------------------

k_FileBrowse( nFRow, nFCol, nTRow, nTCol, nHandle, nTabSpaces ) --> lFilePtr

Browse a text file  - will accomodate many megabytes in size.

--------------------------------------------------------------------------------

k_FIn( cFieldName, cFieldVal, cPassword ) --> NIL

Write data to database field, optionally with encryption.

--------------------------------------------------------------------------------

k_FIOConvert( cConvVal, cPassword ) --> cString

Decrypt a value encrypted by the k_FIn() Function.

--------------------------------------------------------------------------------

k_FirstNon( cString ) --> cString

Return string up to but not including first non-numeric character.

--------------------------------------------------------------------------------

k_FOpen(cFileName, nMode) --> nHandle

OS File Open with optional file pointer placements.

--------------------------------------------------------------------------------

k_FOut( cFieldName, cPassword ) --> cDBFieldData

Retrieve a database field written by k_FIn() with optional decryption.

--------------------------------------------------------------------------------

k_FPeekByte( nHandle, nMode, nBytes ) --> cString

Read bytes before or after the current position without moving file pointer

--------------------------------------------------------------------------------

k_FScreen( cScrMsg , cKeyList , cHeader ) --> NIL

Display a standard KLIPPER screen.

--------------------------------------------------------------------------------

k_FSeek( xValue, cUDFFound, cUDFNFound ) -->lFound

SEEK without moving record pointer if value not found.

--------------------------------------------------------------------------------

k_FSelect(cAlias) -->lAliasFound

Select a database by work area alias.

--------------------------------------------------------------------------------

k_FSize( xFile ) --> nFileSize

Determine the size of a file.

--------------------------------------------------------------------------------

k_FWriteLine( nHandle, cText ) --> nBytesWritten

Write a line of text to an ASCII file.

--------------------------------------------------------------------------------

k_FX286MS( nMaster_Select, nTopRow, nTopCol ) --> NIL

Displays and accepts changes to an Epson 286MX/FX print setting box.

--------------------------------------------------------------------------------

k_FLock() --> lLockStatus

Lock current database file if possible.

--------------------------------------------------------------------------------

k_Gather(acRecord) --> lSuccess

Gather array to database fields.  Create array with k_Scatter().

--------------------------------------------------------------------------------

k_GetKey() --> nLastKeyCode

Wait state INKEY(0)-like function.

--------------------------------------------------------------------------------

k_GetNum( cGetStr, cNumPic, nGRowMod, nGColMod ) --> nInteger

Prompt for and accept a numeric value.

--------------------------------------------------------------------------------

k_GetStr(cGetStr, nStrWidth, lMatchWidth, cPicture, nGRowMod, nGColMod,

lUpper) --> cString

Prompt for and accept user character string input.

--------------------------------------------------------------------------------

k_Hilight( nLine, cText, cColor ) --> NI

Highlight text wherever it appears on a screen or screen line.

--------------------------------------------------------------------------------

k_HPrintf( cFont_Id, nF_Val ) --> lPrinterStatus

Set various Hewlett Packard LaserJet font options.

--------------------------------------------------------------------------------

k_HToI( cVar ) --> nIntege

Convert hexadecimal to decimal integer.

--------------------------------------------------------------------------------

k_ImportP(cDefFileName,cImpFileName,cCommentChar,cDataChar) --> nNumLinesRead

Formatted import from text file.

--------------------------------------------------------------------------------

k_InArray( axArray, xData ) --> lIsInArray

Determine if a value is in any element of specified array.

--------------------------------------------------------------------------------

k_IndexFields() --> acFieldList

Build an array containing field names referenced in the current index.

--------------------------------------------------------------------------------

k_InitWin(Win_Name, Win_TR, Win_TC, Win_BR, Win_BC, Win_Color,Win_Up) --> NIL

Initialize a scrolling window for use by other _????Win() functions.

--------------------------------------------------------------------------------

k_InRange( ndInVar, ndInLow, ndInHigh ) --> lInRange

Determine if a numeric or date value is within a specified range.

--------------------------------------------------------------------------------

k_Int2B(nInteger, nPlaces) --> cBinString

Convert integer to binary string

--------------------------------------------------------------------------------

k_Int2LB(nInteger, nPlaces)

Convert integer to long binary string

--------------------------------------------------------------------------------

k_IsAverage( anArray, nRange ) --> nElement

Determine the array element that contains the average value of the array.

--------------------------------------------------------------------------------

k_IsDBF( cFileName ) --> lIsDBF

Determine if a file is a dBASE III+ compatible database file.

--------------------------------------------------------------------------------

k_IsDBFMem( cFileName ) --> cMemField(s)

Return the name(s) of any memo fields in the specified (unopen) database.

--------------------------------------------------------------------------------

k_IsEnvVar( acVarNames, lContent ) --> xElement

Tests existence of, and optionally returns, contents of DOS env variables.

--------------------------------------------------------------------------------

k_IsOpen( cDBFileName ) --> cOpenStatus

Determine USE mode of database for current or other application.

--------------------------------------------------------------------------------

k_IsPrcntOf( nVar1, nVar2 ) --> nPercent

Returns "what is Var1 percent of Var2"

--------------------------------------------------------------------------------

k_IToB( nInteger, nMax ) --> nInteger

Convert a base 10 integer to binary (base 2).

--------------------------------------------------------------------------------

k_IToBS( nInteger, nMax ) --> cBitString

Convert a base 10 integer to binary string (up to 52 binary digits).

--------------------------------------------------------------------------------

k_ItoH( nInteger ) --> cHexString

Convert base 10 integer to base 16 hex string.

--------------------------------------------------------------------------------

k_KeyList( cKey_List, cKey_Color, nKey_Line ) --> NIL

Present a line of text on a given line.

--------------------------------------------------------------------------------

k_KillWin( Win_Name ) --> NIL

Kill a window created by k_InitWin().

--------------------------------------------------------------------------------

k_KMenu(__level,__prefuncarg,__postfuncarg,__scrnarea) --> NIL

A data driven general purpose menuing subsystem.

--------------------------------------------------------------------------------

k_Arg( cArgText, cArgStr ) --> cString

Parse strings to extract text following specfied token.

--------------------------------------------------------------------------------

k_LineEdAvail(cAlias, cField) --> nBytesAvail

Determine the number of recyclable bytes in a LineEdit comment database.

--------------------------------------------------------------------------------

k_LineEdGet( cKey, cAlias, cField ) --> cString

Retrieve text from LineEdit comment database.

--------------------------------------------------------------------------------

k_LineEdKill( cKey, cAlias, cField ) --> nBytesRecovered

Recycle LineEdit Comments for use by other comments.

--------------------------------------------------------------------------------

k_LineEdPut( cKey, cAlias, cField, cString ) --> nBytesWritten

Write LineEdit Comments to comment base.

--------------------------------------------------------------------------------

k_LineEdSize(cKey, cAlias, cField) --> nCommentSize

Determine size of a comment stored in a comment base.

--------------------------------------------------------------------------------

k_LockKey(cProc, nLine, cVar, cPassword) --> NIL

Clear and lock-up screen with password.

--------------------------------------------------------------------------------

k_Logr(nNumber, nBase) --> nLog

Solve for any base log (not just the common log as Clipper's Log() does).

--------------------------------------------------------------------------------

_LongSeconds() --> nSeconds

Return seconds since 01/01/80, rather than from midnight of current day.

--------------------------------------------------------------------------------

k_LPrint( cPtrData, lCrLf ) --> NIL

Print text directly to the printer.

--------------------------------------------------------------------------------

k_LeadSpace( cInStr ) --> nInteger

Count the numer of leading spaces in a character string.

--------------------------------------------------------------------------------

k_MakeDict( cFileSpec ) --> NIL

Create a file structure listing for all files meeting filespec criteria.

--------------------------------------------------------------------------------

k_MemToArray( cMemFile ) --> aArray

Load .MEM file to local array instead of main application memory.

--------------------------------------------------------------------------------

k_Menu( nMenuTopRow, nMenuLeftCol, cMenuTitle, acMenuArray ) --> nSelection

General purpose menu facility.

--------------------------------------------------------------------------------

k_MenuA(nMenuTopRow, nMenuLeftCol, nMenuMaxItems, cMenuTitle, acMenuArray,

lMsgDisable, lClkDisable) --> nSelection

Genral purpose menuing facility.

--------------------------------------------------------------------------------

k_MetricConvert( nVal, cTypeConvert ) --> nVal

Perform various metric/American conversions.

--------------------------------------------------------------------------------

k_Msg( cMsgText, nMsgLine, nBoxType ) --> NIL

Present a boxed centered message without pausing execution.

--------------------------------------------------------------------------------

k_Mult( cVal1, cVal2 ) --> cProduct

Perform multiplication to 64,000 digits (I swear, it's the truth!, kinda)

--------------------------------------------------------------------------------

k_Nearest( nNum1, nNum2 nTarget, nRange )

Determine which of two values is closest to target value (with rules).

--------------------------------------------------------------------------------

k_Neon( nRow, nCol, cMsg ) --> NIL

A truly brainless wonder!

--------------------------------------------------------------------------------

k_NewRec( lNewRec_DateStamp ) --> lAppendStatus

Append a new record to the current database, optionally with date/time stamp.

--------------------------------------------------------------------------------

k_NthOccr( cInStr, cInChar, nNthOccr ) --> nInteger

Return the "nth" occurance of one string in another string (delimited).

--------------------------------------------------------------------------------

k_NtxKey(cFileName, lNtx) --> cIndexExpression

Extract the index key expression from an index file (without db/ntx open).

--------------------------------------------------------------------------------

k_Nullify( cFunctionRetVal, cRetType ) --> xValue

Nullify an expression of any type in-line.

--------------------------------------------------------------------------------

k_Num2Color( nColor ) --> cColor

Convert Clipper INTERNAL color number to color string.

--------------------------------------------------------------------------------

k_OR( nData, nKey ) --> nInteger

Perform binary OR on two integers.

--------------------------------------------------------------------------------

k_ParseFE( cString ) --> cFilenameEXTENSION

Extract the filename EXTENTION from a fully qualified filename.

--------------------------------------------------------------------------------

k_ParseFN( cString ) --> cFileNAME

Extract the file NAME (NO EXTENTION) from a fully qualified filename.

--------------------------------------------------------------------------------

k_Password(nRow,nCol,cPrompt,nStrLen,nMinLen,cColor,lUpper,lShow) --> cString

Provides a coloured, boxed, prompted, hidden or masked password entry field

--------------------------------------------------------------------------------

k_PeekSet(nSet) --> nStackSpaceLeft

Check the amount of "stack" space left on a _SetStack() stack.

--------------------------------------------------------------------------------

k_PopBox( nTmax, nLMax, nBMax, nRMax, nType, cFill ) --> NIL

"Exploding" screen boxes.

--------------------------------------------------------------------------------

k_PopScrSave() --> lSuccess

Screen capture utility function (ASCII).

--------------------------------------------------------------------------------

k_PopSet(nSet) -> xStackSetting

Pop the next setting of a k_PushSet() stack.

--------------------------------------------------------------------------------

k_PrcntOfIs( nVar1, nVar2 ) --> nPercent

Returns "what is Var1 percent of Var2?"

--------------------------------------------------------------------------------

k_Prepare(lUseErrHandler) --> NIL

Sets various run time envrionments, options, and a custom error handler.

--------------------------------------------------------------------------------

k_PrintFile(cFileName,nLinesPerPage,nPageNum,cExcludeText,lPageNum,lDate,lLin

eNums) --> NIL

Print text to printer (HP LaserJet formatting).

--------------------------------------------------------------------------------

k_PrintText( cFileName, nLinesPerPage, nPageNum, cExcludeText ) --> NIL

Print text to printer (no formatting).

--------------------------------------------------------------------------------

k_PullCap( cPullString ) --> cString

Upper Case first letters of a string and extract them.

--------------------------------------------------------------------------------

k_PullText( nFile, cFromText, cToText ) --> cString

_PullText extracts lines from a text file between two tokens.

--------------------------------------------------------------------------------

k_PushSet(nSet,xVal) --> nStackSpaceRemaining

Push a Clipper set() setting onto a SetStack() stack.

--------------------------------------------------------------------------------

k_QuickDecrypt( cString, nKey ) --> cDecryptStr

Quick Decrypt for _QEncrypt() values.

--------------------------------------------------------------------------------

k_QuickEncrypt( cString, nKey ) --> cEncryptStr

Quick encryption routine (less secure, but faster).

--------------------------------------------------------------------------------

k_QClose( cTable, cAlias ) --> NIL

Quick Close a file in-line.

--------------------------------------------------------------------------------

k_QConfirm( cConfirm_Desc, nQRowMod, nQColMod ) --> lYesNo

Asks a Y/N Question, returning TRUE or FALSE.

--------------------------------------------------------------------------------

k_QOpen( cTable, cAlias, cIndex, lXFlag ) --> nSelectArea

Quick Open a file in-line.

--------------------------------------------------------------------------------

k_ReadF() --> NIL

An ultimately simplistic yet useful READ issuer.

--------------------------------------------------------------------------------

k_ReadLine( nHandle, nLength ) --> cString

Read a line of text from an ASCII file.

--------------------------------------------------------------------------------

k_ReColor( nFRow, nFCol, nTRow, nTCol, cColor) --> NIL

Rewrite screen region in different color, leaving text intact.

--------------------------------------------------------------------------------

k_ReIndex( acFileName ) --> NIL

Reindex databases according to index specifications on file.

--------------------------------------------------------------------------------

k_Reverse( cStr ) --> cString

Reverse the order of characters in a string.

--------------------------------------------------------------------------------

k_RLock() --> lLockStatus

Simple record lock.

--------------------------------------------------------------------------------

k_SaveScreen( cFileName ) --> lSuccess

Save screen to a text file.

--------------------------------------------------------------------------------

k_Scatter(lReadOnly) --> axFieldArray

Scatter field variables to array (not memvars).  Gather with k_Gather().

--------------------------------------------------------------------------------

k_ScreenScan( nLine, cText, nType, cChar ) --> xRetVal

Scan screen to locate or extract text.

--------------------------------------------------------------------------------

k_Select( xSelectArea ) --> lSelectStatus

Select a work area by number or alias.

--------------------------------------------------------------------------------

k_SelectUsrPrint( cPrintType ) --> NIL

Set various printer settings for printers defined in PRINTDEF.DAT.

--------------------------------------------------------------------------------

k_SetColor( nColorArea, cNewColor ) --> cOldSetting

Set individual color settings without affecting others in the

scheme.

--------------------------------------------------------------------------------

k_SetIndex( cFileName, cIndexName ) --> NIL

Open Indexes (and set controlling index) according to definition file.

--------------------------------------------------------------------------------

__SetStack()

_Internal SESTACK function engine. (Not for direct use).

--------------------------------------------------------------------------------

k_SetUsrPrint( nFRow, nFCol, nTRow, nTCol, cColor ) --> NIL

Set printer settings per individual user.

--------------------------------------------------------------------------------

k_Skip2Next( cField ) --> lIsEOF()

Skip to the next index key value in a database.

--------------------------------------------------------------------------------

k_SlideBox( cDir, nTmax, nLMax, nBMax, nRMax, nType, cFill, lShadow ) --> NIL

Displays a "sliding" exploding box from any direction (ala popbox()).

--------------------------------------------------------------------------------

k_Snatch( cInStr, nLowBound, nHighBound ) --> cString

A modified SUBSTR() with absolute from/to params rather than from/len.

--------------------------------------------------------------------------------

k_SearchPath( cFileName ) --> cPathString

Determine where in the OS PATH a specified file exists.

--------------------------------------------------------------------------------

k_Str2Array(cString) --> xArray

Convert _Arr2Str()'s string back to an array.

--------------------------------------------------------------------------------

k_StrAdd( cString, cInsert, nPos ) --> cString

Insert one string into another at a specified point.

--------------------------------------------------------------------------------

k_StrRem( cString, cRemove ) --> cString

Remove characters from a string wherever they occur.

--------------------------------------------------------------------------------

k_Strtempl(cString, cPattern) --> NIL

Overlays a string with a template, returning the result string.

--------------------------------------------------------------------------------

k_SubUntil( cStr, cFromText, cToText ) --> cString

Return substring between two tokens in a string.

--------------------------------------------------------------------------------

Help() --> NIL

General Purpose Context-Sensitive On-Line Help system.

--------------------------------------------------------------------------------

k_SUse( cFile, cAlias, nArea, nSecs ) --> lError

General Purpose SHARED Use File Opener.

--------------------------------------------------------------------------------

k_Terminate( cTermMsg, nErrorLevel ) --> NIL

General purpose application death-invoker with ERRORLEVEL set.

--------------------------------------------------------------------------------

k_TextBrowse(nFRow, nFCol, nTRow, nTCol, cVar, nBoxType, nBoxLabel, cLabelStr,

cColor, lViewOnly ) --> NIL

General Purpose text browse.

--------------------------------------------------------------------------------

k_Ticker(nLine,nCol,nLength,cText,nDelay,lPause,cSepChar) --> NIL

A Times-Square'esque ticker tape display.

--------------------------------------------------------------------------------

k_Timer(nChannel, nAction, nOptVal) --> nTimerData

16 channel "timer & stopwatch."

--------------------------------------------------------------------------------

k_ToChar( xValue, xFill ) --> cString

Convert any data type to string equivalent.

--------------------------------------------------------------------------------

k_ToPower( nNum1, nNum2 ) --> nInteger

Exponent function (Don't get too excited!).

--------------------------------------------------------------------------------

k_ToPrn( cPrinterCodesFile, lRetryable ) --> lPrinterStatus

Set printer on (with optional command codes from file).

--------------------------------------------------------------------------------

k_ToScr() --> NIL

Set output device to screen.

--------------------------------------------------------------------------------

k_True() --> lTRUE

Return TRUE in an inline expression (as a function call).

--------------------------------------------------------------------------------

k_TextArray(cFileName, nWidth) --> acTextArray

Loads the contents of a text file into an array

--------------------------------------------------------------------------------

k_TrailSpace( cInStr ) --> nInteger

Count number of trailing spaces in a string.

--------------------------------------------------------------------------------

k_Underline( cWhat ) --> cString

Underline print data as it is sent to the printer.

--------------------------------------------------------------------------------

_Updt_Win( Win_Name, Win_Text ) --> NIL

Update an k_InitWin() scrolling window with the specified text.

--------------------------------------------------------------------------------

k_Var2File(xValue, cFileName) --> cFileName

Store data variables of any type, including arrays, to file.

--------------------------------------------------------------------------------

k_Wait( nSeconds ) --> NIL

Pause program execution for nSeconds, regardless of keyboard activity.

--------------------------------------------------------------------------------

k_WaitFor( nWKey1, nWKey2, nWKey3, nWKey4, nWKey5, nWKey6 ) --> nKeyCode

Wait for the user to press any of (up to) 6 predefined keys, returning key.

--------------------------------------------------------------------------------

k_WhichElement( aArrayName, cString, lBegins ) --> nElementNumber

Scan an array looking for the element that contains the specified value.

--------------------------------------------------------------------------------

k_SaveWorkAreas( cSetName ) --> NIL

Save status of all databases and indexes.

--------------------------------------------------------------------------------

k_WSPopScrSave() --> lSuccess

Save screen to user specified file in WordStar format.

--------------------------------------------------------------------------------

k_WSSaveScreen( cFileName ) --> lSuccess

Screen capture utility (WordStar format).

--------------------------------------------------------------------------------

__WSSaveScreen( nHandle ) --> NIL

Save screen to existing and already open file, in WordStar format.

--------------------------------------------------------------------------------

k_XDup( cOutFile, lKeep ) --> nRecsDeleted

Delete duplicate records in a database based upon index key.

--------------------------------------------------------------------------------

k_XLog( cWhat, cWhere ) --> nAppendStatus

Log a line of text to a system log file.

--------------------------------------------------------------------------------

k_XOR( nData, nKey ) --> nInteger

Perform a binary Exclusive OR with binary INTEGERS.

--------------------------------------------------------------------------------

k_XORS( cData, cKey ) --> cStringInt

Perform a binary Exclusive OR with binary STRINGS.

--------------------------------------------------------------------------------

k_XUse( cFile, cAlias, nArea, nSecs ) --> lError

General Purpose EXCLUSIVE file opener.

--------------------------------------------------------------------------------
