CBEV Help Table of Contents
 HELP for CBEV Version 2.03E

 (C) 1994 by 	Eiji Wakimoto	(jbb01432@niftyserve.or.jp / 100203.2504@compuserve.com)

Translated By:	Hitoshi Ozawa	(CIS:100220,3402 / HCC00417@niftyserve.or.jp)

Contents:

How to Use CBEV

Settings

Numeric Expressions

Operators

Functions

Constants

Calculation Results

Result Window

Concerning Hexadecimal Number

Q&A

Support

Copyright and Distribution

Liability


How to use
How to Use CBEV

When CBEV.EXE file is executed, CBEV window will appear minimized.

When CBEV is in the Operating Mode, CBEV will evaluate the content of the clipboard and replace it with the evaluated result when an equation (less than 1KB long) with an Evaluation Key is cut or copied to the clipboard.  If CBEV can not evaluate the equation, it will not change the content of the clipboard.

Evaluated result is always a number that can be pasted back to an application.

Evaluated result can be displayed by opening the clipboard or by opening the Result Window.

If it is necessary to copy a calculable expression without evaluating it, CBEV can be set to the Pause mode by removing the check mark from the Operating in either the System menu or the Settings dialog box.

If it is necessary to confirm the evaluated result before replacing the equation in the clipboard, check the No Copy option.  Result will only be updated in the Result Window.

CBEV settings are defined in the Settings dialog box.


System Menu

System Menu is also called Control Menu.

System Menu usually lists frequently used commands common to all Windows applications (e.g. Resize and Move windows).  CBEV appends Operating and Show Result Window to this list.

System Menu is opened from most application by selecting the box located at the upper left hand corner of a window or by pressing Alt + Space keys.  However, to open a System Menu when an application window is minimized, the corresponding icon must be selected before pressing Alt + Space keys or the corresponding icon must be clicked with the left mouse button.


Settings

How CBEV is to evaluation an equation is defined in the Settings dialog box.

This dialog box is opened by double-clicking the left mouse button on the CBEV icon, selecting Resize in the CBEV System Menu, or by switching to CBEV from Task Manager.

Operating

No Copy

Delay

Use Shift-JIS Code

Evaluation Key

Unit Of Angles

Format

Constants


Settings - Operating

When Operating option is checked, CBEV will be in the Operating Mode and equation with  an Evaluation Key will be evaluated when it is copied to a clipboard.

When it is not checked, CBEV will be in the Pausing Mode and all equations will not be evaluated.

Mode can also be changed by choosing Operating in the System Menu.  Successively choosing Operating will toggle CBEV between Operating and Pausing Modes.


Setting-No Copy
Settings - No Copy

When No Copy option is checked, CBEV will not automatically replace the equation in the clipboard with the evaluated result.  However, the result will be updated in the Result Window and these numerical can be copied to the clipboard by choosing the Copy button.


Settings - Delay

Delay option is used to set how many milliseconds to wait after the content of the clipboard have been changed before CBEV attempts to evaluate an expression.

When the time is set to 00 (default setting), CBEV will not wait.

If CBEV is not properly evaluation an equation or it does not seem to be functioning properly with other applications, increase the Delay time.

Related Topic:

Q&A: When I tried to use CBEV with an application, Not enough memory message keep appearing.


Settings - Use Shift-JIS Code

Use Shift-JIS Code option is checked if 2 byte shift-JIS codes are to be included in the expression.

When this option is checked:

1. CBEV will evaluate expression including 1 and 2 byte codes.  In this case, 2 byte codes will be evaluated as their corresponding Shift-JIS code.

2.  and [image] 2 byte characters can be used instead of * and / characters respectively.

3. Evaluation Key (i.e., [image], [image], [image], and [image]) can be entered as 2 bytes codes instead of 1 byte code.

4. CBEV will return 1 byte or 2 byte code when Evaluation Key is 1 byte of 2 byte code respectively.  However, result displayed in the Result Window will always be 1 byte code and results copied from this window will thus be in 1 byte code format.

When this option is not checked:

1. CBEV will not recognize 2 byte codes.

2. Multiplication and division characters represented by ANSI codes 215 and 247 can be used instead of * and / characters respectively.

WARNING:

This option is only meaningful to users using system supporting SHIFT-JIS codes such as Japanese DOS with Japanese Windows.


Settings_Evaluation Key
Settings - Evaluation Key

Evaluation Key is the character that notifies CBEV that the adjacent expression is to be evaluated.  It may be added to the front or at the back of the expression and one of the 5 characters may be used.

Prefix / Suffix

Specify whether Evaluation Key is the first (include spaces) or the last (include spaces but ignores Return) character in the expression.

Key

Specify the key to be used for the Evaluation Key.  Evaluation Key can be one of "=", "?", "!", "@", or "#" characters.

Examples:

 When Evaluation Key is set to Prefix and "?", expression should be written like:

?21.9+35.7

 When Evaluation Key is set to Suffix and "=", expression should be written like:

125.3/24=


Settings-Unit of Angle
Settings - Unit Of Angles

Trigonometric expressions can be calculated either in radians or in degrees.  Parameters in sin, cos, and tan and results from asin, acos, and atan functions will differ when the option is switched.


Settings - Format

Format of the returned value may be specified by specifying the Format option.

Type:

Type specifies the format of the returned number.  It may be one of the followings:

##.## or #.#e##	Return result in shorter of floating point or exponential formats

##.## or #.#E##	Same as above but uses capital letter "E"

#.#e##	Always return result in exponential format

#.#E##	Same as above but use capital letter "E"

##.##	Always return result in floating point format

Precision:

Precision specifies the number of digits to return after the calculation.

When Type is set to return result in shorter of either exponential or floating point format, precision denotes the total number of digits excluding signs and a decimal point.

When Type is set to exponential format or to floating point format, precision denotes the number of digits to the right of the decimal point.

Example:

When the expression is 11111.11111+22222.22222=, following are results using various formats and precision:

Type	Precision	Result

#.## or #.#e##	    6	33333.3

#.#e##	    6	3.333333e+004

#.##	    6	33333.333330

#.## or #.#e##	    5	33333

#.#e##	    5	3.33333e+004

#.##	    5	33333.33333

'+' sign:

When "+" sign option is checked, a "+" sign is inserted in front of all positive numbers.

When this option in not checked, only "-" sign is inserted in front of negative numbers.

Insert Commas:

When Insert Commas option is checked, a "," character is inserted in every 3 digit to the left of the decimal point (i.e. integer) when the format is not exponential.  Furthermore, CBEV will evaluate expressions including numbers with commas.

Hexadecimal:

Expressions with numerals prefixed with "0x" are treated as hexadecimal numbers and CBEV will return result in hexadecimal format.  This format may be one of the 4 formats below:

With Sign	prefix result less than 8 digits with a sign (i.e. "+" or

 "-")

2's Complement, n bit	return result in 2's complement with n bit precision

Examples:

The is -1 in different hexadecimal formats:

With Sign	-0x1

2's Complement, 8 bit	 0xff

2's Complement,16 bit	 0xffff

2's Complement,32 bit	 0xffffffff

WARNING:

1. Precision only specifies the precision of the output and not the precision used during the calculation.  All calculations are done in real numbers.  After the evaluation has been calculated, result is then rounded to the specified precision and returned in the specified output.

2. If there is an overflow during the calculation or if the result does not fit in the specified format, CBEV will treat expression as an illegal expression and not return a result.

NOTE:

If CBEV was able to calculate the expression, the result may be used in the expression by inserting a "?".

For more information, refer to Recall Last Result section.


Settings - Constants

Up to 256  numbers may be set as a constant to be used in all CBEV calculations.

To define a constant:

1. Enter a name and a value of the constant in the Name and the Value fields respectively.

2. Choose the Add Constant button to append it to the constants list below.

A name should be composed of letters and underscore characters and should be within 8 characters.  All characters will be converted to capital letters when added to the constants list.

Value assigned to a constant should be a valid  numeric expression.  However, do not use commas and hexadecimal numbers.

To change the value of a constant

1. Redefine the constant entering the new value in the Value field.

2. Choose the Add Constant button.

3. A dialog box will appear confirming your entry.  Choose the OK button to change the value.

To delete a constant

1. Click the left mouse button on the constant expression that is to be deleted.

2. Choose the Delete Constant button.

3. A dialog box will appear confirming your choice.  Choose the OK button to delete the entry.

Related Topics:

Constants

Examples of Constant Names

Numeric Expressions


Numeric expression
Numeric Expressions

Conventions

[] surrounds objects that are optional parameters

<> surrounds objects that are required

Decimal Number

Decimal numbers should have the following format:

[sign][digits][.][digits][E][sign][exponent]

A letter "e" used as an exponential sign may be in upper or lower case.

Example:  125 , 12.53 , -1.3e+13 , .25E15

Hexadecimal Number

Hexadecimal numbers should have the following format:

[sign]<prefix><digits>	where digits are represented in hexadecimal

and prefix is one of 0x, 0X,&h or &H

Permissible hexadecimal digit are 01234567890ABCDEF

where letter A-F may be in lower case

Only hexadecimal number between -0xffffffff and +0xffffffff are recognized by CBEV

Example: 0x31ef , -0X12AD , &h31231423 , &HA

WARNINGS:

1. All numbers starting with a "+" sign and all numbers without any signs will be treated as a positive number independent of the output format.

2. All numbers starting with a "-" sign will be treated as a negative number independent of the output format.

3. All hexadecimal numbers are converted to a decimal number internally.  Thus, it is not possible to use binary overflow manipulations.

4. Insert Commas option must be checked if "," are inserted between digits. (Do not insert commas in a hexadecimal number.)

5. Space, Return, and Tab may be inserted within a expression, but do not insert them within a number.

6. Output format is set in the Settings - format dialog box.  To output a number as a hexadecimal number, insert a @x, @X , @h, or @H characters at the end of the expression before the Evaluation Key.

Examples:

Evaluation Key is set to  Suffix "="

0x12+0x3D@x=

Evaluation Key is set to Prefix "?"

?0x12+0x3D@x


Operators

CBEV supports the following 2 operands operators.

  Priority of an operator may be changed by enclosing and expression in a parenthesis.

Unitary operators, such as "-" and "+" has the lowest priority and will be applied after all other operators unless it is preceded by another operator.

Examples:

-2^3= will be evaluated as -(2^3)=-8

2^-1= will be evaluated as 2(-1)=0.5

WARNING:

In an exponential expression such as x^y=, an exponent, y, must be an integer.


Function
Functions

CBEV supports the following functions:

1. Absolute value, sign, round

abs(x) :	absolute value of x

sgn(x) :	sign of x, if x>0 then 1, if x=0 then 0,if x<0 then -1

floor(x) : 	Largest integer less than x

ceil(x) : 	Smallest integer greater than x

2. Trigonometric, hyperbolic

sin(x),cos(x),tan(x) : 	trigonometric functions

asin(x),acos(x),atan(x) : 	arc trigonometric functions

sinh(x),cosh(x),tanh(x) : 	hyperbolic trigonometric functions

asinh(x),acosh(x),atanh(x) :	arc hyperbolic trigonometric functions

3. Exponent, logarithm

exp(x) : 	exponential of e (i.e. ex)

log(x), :	natural logarithm of x

ln(x),loge(x)

log10(x) :	logarithm of x with base number 10

log2(x) : 	logarithm of x with base number 2

sqrt(x) :	square root of x

4.Angle

deg(x) :	convert radian angle measurement to degrees

rad(x) : 	convert degree angle measurement to radians

WARNINGS:

1. Parameters must be surrounded by parenthesis (i.e. exp(10)).

2. Log(x) has the same meaning as ln(x) and loge(x).  To calculate the logarithm of x with base 10, use log10(x).

NOTES:

1. X may be an expression instead of a number.

2. CBEV does not differentiate between capital and lower case letters.


Constants

Constant names should consist of 8 alphanumeric characters (i.e. letters A to Z, numbers 0 to 9, and underscore).  Furthermore, names should start with either a letter or an underscore.

WARNINGS:

1. Capital and lower case letter are not differentiated.

2. Do not use double byte characters

3. Do not name constants with functions names.

Related Topics:

Settings - Constants

Example of Constant Names


Constants-Example
Example of Constant Names

Correct Names:

A

ABCDEFGH

A01

Names*1

_A_01_X_

Erroneous Names:

0A	(Do not start constant name with a number)

ABCDEFGHI	(Constant names must be within 8 characters)

A 01	(Do no insert spaces within a constant name)

A&B	(& is not an alphanumeric character)

*1: All lower case letters will be converted to capital letters.


Result
Recall Last Result

Last calculation result can be used by inserting a question mark (?) in an expression.

Example: expression 3+?*5= will multiply 5 and add 3 to the last calculated result.

WARNING:

Results are only saved in its internal format and are independent of any formats.


Result Window

A Result Window will be displayed by selecting the Show Result Window in the System Menu.  (If Result Window is already opened, it will become active.)

Result Window will contain the result of CBEV calculation and will contain "Not Evaluated" when it can not evaluate the copied expression.

To always keep the Result Window on top, check the Float option.

To copy the content to the clipboard, choose the Copy button.  This can be used even when No Copy option is selected.

To close the Result Window, choose the Close button.  Location of the window when it is closed will be saved to the CBEV.INI file.

If CBEV or Windows is closed while the Result Window is open, CBEV will open the Result Window next time it is opened.

Related Topic:

Q&A: Result window does not display


Concerning hexadecimal
Concerning Hexadecimal Number

Hexadecimal numbers are entered by prefixing hexadecimal digits with 0x, 0X, &h, or &H.  A minus sign may be attached before these characters to denote a negative value.

Output format is set in the Settings - format dialog box.  To output a number as a hexadecimal number, insert a @x, @X , @h, or @H characters at the end of the expression before the Evaluation Key.

WARNINGS:

1. Hexadecimal number must be within -0xffffffff and +0xffffffff.

Related Topics:

Settings-Format

Numeric Expressions


Q&A
Question and Answers

Q&A: When I tried to use CBEV with an application, Not enough memory message keep appearing.

Q&A: Result window does not display

Q&A: Is there a way to calculate without entering an Evaluation Key?


Q&A;Not enough memory
Q&A: When I tried to use CBEV with an application, Not enough memory message keep appearing

Increase the delay time in the  Setting - Delay dialog box.

If this does solve the problem, try closing all other applications your are not currently using.

If this still does not solve the problem, you just have to add more memory to your system to have CBEV work with the current application.


Q&A;Result Window not displayed
Q&A: Result Window does not Display

Change the position where Result Window is to be displayed

1. End CBEV.

2. Open CBEV.INI in the WINDOWS directory using an editor such as a NotePad.

3. Search for ResultWindowsPos.

4. Set ResultWindowsPosX=0

    Set ResultWindowsPosY=0

5. Start CBEV

Result Window should appear at the upper left hand corner of the screen.


Q&A;Without Evaluation Key
Q&A: Is there a way to calculate without entering an Evaluation Key?

There is not option in the current version of CBEV to do this.  Furthermore, it probably won't be too useful to have CBEV automatically evaluate each number copied to the clipboard and exchange words matching constant names.


Support

Support for Clipboard Evaluator is provided by CompuServe E-mail.

If you have any question, opinion, suggestions, or any other comments, please

send an E-mail to:

Eiji Wakimoto	Nifty Serve:JBB01432    (JBB01432@niftyserve.or.jp)

Hitoshi Ozawa	CompuServe:100220,3402  (HCC00417@niftyserve.or.jp)

We will try to reply to your questions, but we are not able to provide complete coverage of all your requests and we are not able to provide step through guidance.


Copyright & Distribution
Copyright and Distribution

Clipboard Evaluator is copyrighted by Eiji Wakimoto.  No part of program, data, or any other file in the CBEV.LZH file may be reproduced, in any form or by any means, without permission in writing from Eiji Wakimoto.

This file can be freely distributed if the following conditions are obeyed:

1. If it is to be copied to another forum or to another distribution channel, please contact the developer to let us know exactly where it is to be copied.  We will need this information to maintain and upgrade Clipboard Evaluator at all locations.

2. This program can be distributed only in the original archived CBEV.LZH formatted file.  Do not change this file or any files within.

3. Please make it apparent that Clipboard Evaluator is a FREEWARE.  It is necessary to state this in the program description.

4. If this program is to be mentioned in any article, please send a E-mail to one of the developers.

The developer is willing to discuss other means of distribution.  Please send a mail to one of the E-mail addresses below.


Liability

  The author and the developer of this software will not take any responsibilities for any damages that may occur with the use of this software.  The files contained in CBEV.LZH file are distributed "as is" and without  any expressed and implied warranties.  The user assumes the entire risk of using the software.