Namespace: Consultingwerk.Assertion
Class 
Assert Copy to Clipboard
Parent classes:
Inherits: Progress.Lang.Object

File:Assert
Purpose:Provides generic methods for validation of ABL primitive values
Description:Routines in this class typically raise an error condition
when the condition is not met.
Author(s):Mike Fechner / Consultingwerk Ltd.
Created:Fri Apr 27 23:31:14 CEST 2012



Top Method Summary
Options Name Purpose
+ Equals (character, character) Validates that two character values are equal
+ Equals (date, date) Validates that two date values are equal
+ Equals (datetime, datetime) Validates that two datetime values are equal
+ Equals (datetime-tz, datetime-tz) Validates that two datetime-tz values are equal
+ Equals (decimal, decimal) Validates that two decimal values are equal
+ Equals (handle, handle) Validates that handles are equal
+ Equals (int64, int64) Validates that two integer values are equal
+ Equals (logical, logical) Validates that two logical values are equal
+ Equals (longchar, longchar) Validates that two longchar values are equal
+ Equals (raw, raw) Validates that two raw values are equal
+ Equals (recid, recid) Validates that two recid values are equal
+ Equals (rowid, rowid) Validates that two rowid values are equal
+ EqualsCaseSensitive (character, character) Validates that two character values are equal based on a raw compare
+ EqualsCaseSensitive (longchar, longchar) Validates that two longchar values are equal based on a raw compare
+ EqualsFalse (logical) Validates that a LOGICAL Value is FALSE
+ EqualsRaw (character, character) Validates that two character values are equal based on a raw compare
+ EqualsRaw (longchar, longchar) Validates that two longchar values are equal based on a raw compare
+ EqualsTrue (logical) Validates that a LOGICAL Value is TRUE
+ Fail (character) Fails unconditionally
+ GE (date, date) Validates that the first value is GE the second value
+ GE (datetime, datetime) Validates that the first value is GE the second value
+ GE (datetime-tz, datetime-tz) Validates that the first value is GE the second value
+ GE (decimal, decimal) Validates that the first value is GE the second value
+ GE (int64, int64) Validates that the first value is GE the second value
+ GE (integer, integer) Validates that the first value is GE the second value
+ GreaterThanZero (integer) Validates an ABL Integer value so that it is greater than 0
+ GreaterThanZero (integer, character) Validates an ABL Integer value so that it is greater than 0
+ GT (date, date) Validates that the first value is GT the second value
+ GT (datetime, datetime) Validates that the first value is GT the second value
+ GT (datetime-tz, datetime-tz) Validates that the first value is GT the second value
+ GT (decimal, decimal) Validates that the first value is GT the second value
+ GT (int64, int64) Validates that the first value is GT the second value
+ GT (integer, integer) Validates that the first value is GT the second value
+ IsGuid (character) Validates that an Character value is a valid GUID
+ LE (date, date) Validates that the first value is LE the second value
+ LE (datetime, datetime) Validates that the first value is LE the second value
+ LE (datetime-tz, datetime-tz) Validates that the first value is LE the second value
+ LE (decimal, decimal) Validates that the first value is LE the second value
+ LE (int64, int64) Validates that the first value is LE the second value
+ LE (integer, integer) Validates that the first value is LE the second value
+ LT (date, date) Validates that the first value is LT the second value
+ LT (datetime, datetime) Validates that the first value is LT the second value
+ LT (datetime-tz, datetime-tz) Validates that the first value is LT the second value
+ LT (decimal, decimal) Validates that the first value is LT the second value
+ LT (int64, int64) Validates that the first value is GT the second value
+ LT (integer, integer) Validates that the first value is LT the second value
+ NE (character, character) Validates that two character values are not equal
+ NE (date, date) Validates that two date values are not equal
+ NE (datetime, datetime) Validates that two datetime values are not equal
+ NE (datetime-tz, datetime-tz) Validates that two datetime-tz values are not equal
+ NE (decimal, decimal) Validates that two decimal values are not equal
+ NE (handle, handle) Validates that two handles are not equal
+ NE (int64, int64) Validates that two integer values are not equal
+ NE (logical, logical) Validates that two logical values are not equal
+ NE (longchar, longchar) Validates that two longchar values are not equal
+ NE (raw, raw) Validates that two raw values are not equal
+ NE (recid, recid) Validates that two recid values are not equal
+ NE (rowid, rowid) Validates that two rowid values are not equal
+ NotNull (date) Validates an ABL Logical value so that it is not ?
+ NotNull (datetime) Validates an ABL Logical value so that it is not ?
+ NotNull (datetime-tz) Validates an ABL Logical value so that it is not ?
+ NotNull (logical) Validates an ABL Logical value so that it is not ?
+ NotNullOrEmpty (character) Validates an ABL Charcater value so that it is not ? or Empty
+ NotNullOrEmpty (character, character) Validates an ABL Charcater value so that it is not ? or Empty
+ NotNullOrEmpty (longchar) Validates an ABL LONGCHAR value so that it is not ? or Empty
+ NotNullOrEmpty (longchar, character) Validates an ABL LONGCHAR value so that it is not ? or Empty
+ NotNullOrZero (decimal) Validates an ABL Decimal value so that it is not ? or 0
+ NotNullOrZero (decimal, character) Validates an ABL Decimal value so that it is not ? or 0
+ NotNullOrZero (integer) Validates an ABL Integer value so that it is not ? or 0
+ NotNullOrZero (integer, character) Validates an ABL Integer value so that it is not ? or 0

Top Constructor Summary
Options Name Purpose
- Assert () Disallow instance creation


Method Detail
Top

PUBLIC Equals (character, character)

Purpose: Validates that two character values are equal
Notes:
Throws: Consultingwerk.Assertion.AssertException

Parameters:
pcValue1 CHARACTER
The first value to compare
pcValue2 CHARACTER
The second value to compare
Top

PUBLIC Equals (date, date)

Purpose: Validates that two date values are equal
Notes:
Throws: Consultingwerk.Assertion.AssertException

Parameters:
pdtValue1 DATE
The first value to compare
pdtValue2 DATE
The second value to compare
Top

PUBLIC Equals (datetime, datetime)

Purpose: Validates that two datetime values are equal
Notes:
Throws: Consultingwerk.Assertion.AssertException

Parameters:
pdtValue1 DATETIME
The first value to compare
pdtValue2 DATETIME
The second value to compare
Top

PUBLIC Equals (datetime-tz, datetime-tz)

Purpose: Validates that two datetime-tz values are equal
Notes:
Throws: Consultingwerk.Assertion.AssertException

Parameters:
pdtValue1 DATETIME-TZ
The first value to compare
pdtValue2 DATETIME-TZ
The second value to compare
Top

PUBLIC Equals (decimal, decimal)

Purpose: Validates that two decimal values are equal
Notes:
Throws: Consultingwerk.Assertion.AssertException

Parameters:
pdeValue1 DECIMAL
The first value to compare
pdeValue2 DECIMAL
The second value to compare
Top

PUBLIC Equals (handle, handle)

Purpose: Validates that handles are equal
Notes:
Throws: Consultingwerk.Assertion.AssertException

Parameters:
phValue1 HANDLE
The first value to compare
phValue2 HANDLE
The second value to compare
Top

PUBLIC Equals (int64, int64)

Purpose: Validates that two integer values are equal
Notes:
Throws: Consultingwerk.Assertion.AssertException

Parameters:
piValue1 INT64
The first value to compare
piValue2 INT64
The second value to compare
Top

PUBLIC Equals (logical, logical)

Purpose: Validates that two logical values are equal
Notes:
Throws: Consultingwerk.Assertion.AssertException

Parameters:
plValue1 LOGICAL
The first value to compare
plValue2 LOGICAL
The second value to compare
Top

PUBLIC Equals (longchar, longchar)

Purpose: Validates that two longchar values are equal
Notes:
Throws: Consultingwerk.Assertion.AssertException

Parameters:
plcValue1 LONGCHAR
The first value to compare
plcValue2 LONGCHAR
The second value to compare
Top

PUBLIC Equals (raw, raw)

Purpose: Validates that two raw values are equal
Notes:
Throws: Consultingwerk.Assertion.AssertException

Parameters:
praValue1 RAW
The first value to compare
praValue2 RAW
The second value to compare
Top

PUBLIC Equals (recid, recid)

Purpose: Validates that two recid values are equal
Notes:
Throws: Consultingwerk.Assertion.AssertException

Parameters:
preValue1 RECID
The first value to compare
preValue2 RECID
The second value to compare
Top

PUBLIC Equals (rowid, rowid)

Purpose: Validates that two rowid values are equal
Notes:
Throws: Consultingwerk.Assertion.AssertException

Parameters:
proValue1 ROWID
The first value to compare
proValue2 ROWID
The second value to compare
Top

PUBLIC EqualsCaseSensitive (character, character)

Purpose: Validates that two character values are equal based on a raw compare
Notes:
Throws: Consultingwerk.Assertion.AssertException

Parameters:
pcValue1 CHARACTER
The first value to compare
pcValue2 CHARACTER
The second value to compare
Top

PUBLIC EqualsCaseSensitive (longchar, longchar)

Purpose: Validates that two longchar values are equal based on a raw compare
Notes:
Throws: Consultingwerk.Assertion.AssertException

Parameters:
plcValue1 LONGCHAR
The first value to compare
plcValue2 LONGCHAR
The second value to compare
Top

PUBLIC EqualsFalse (logical)

Purpose: Validates that a LOGICAL Value is FALSE
Notes:
Throws: Consultingwerk.Assertion.AssertException

Parameters:
plValue LOGICAL
The logical value to validate
Top

PUBLIC EqualsRaw (character, character)

Purpose: Validates that two character values are equal based on a raw compare
Notes:
Throws: Consultingwerk.Assertion.AssertException

Parameters:
pcValue1 CHARACTER
The first value to compare
pcValue2 CHARACTER
The second value to compare
Top

PUBLIC EqualsRaw (longchar, longchar)

Purpose: Validates that two longchar values are equal based on a raw compare
Notes:
Throws: Consultingwerk.Assertion.AssertException

Parameters:
plcValue1 LONGCHAR
The first value to compare
plcValue2 LONGCHAR
The second value to compare
Top

PUBLIC EqualsTrue (logical)

Purpose: Validates that a LOGICAL Value is TRUE
Notes:
Throws: Consultingwerk.Assertion.AssertException

Parameters:
plValue LOGICAL
The logical value to validate
Top

PUBLIC Fail (character)

Purpose: Fails unconditionally
Notes: Useful Assertion method when reaching a certain code location is
unexpected
Throws: Consultingwerk.Assertion.AssertException

Parameters:
pcMessage CHARACTER
The error message to throw
Top

PUBLIC GE (date, date)

Purpose: Validates that the first value is GE the second value
Notes:
Throws: Consultingwerk.Assertion.AssertException

Parameters:
pdaValue1 DATE
The first value to compare
pdaValue2 DATE
The second value to compare
Top

PUBLIC GE (datetime, datetime)

Purpose: Validates that the first value is GE the second value
Notes:
Throws: Consultingwerk.Assertion.AssertException

Parameters:
pdtValue1 DATETIME
The first value to compare
pdtValue2 DATETIME
The second value to compare
Top

PUBLIC GE (datetime-tz, datetime-tz)

Purpose: Validates that the first value is GE the second value
Notes:
Throws: Consultingwerk.Assertion.AssertException

Parameters:
pdtValue1 DATETIME-TZ
The first value to compare
pdtValue2 DATETIME-TZ
The second value to compare
Top

PUBLIC GE (decimal, decimal)

Purpose: Validates that the first value is GE the second value
Notes:
Throws: Consultingwerk.Assertion.AssertException

Parameters:
pdeValue1 DECIMAL
The first value to compare
pdeValue2 DECIMAL
The second value to compare
Top

PUBLIC GE (int64, int64)

Purpose: Validates that the first value is GE the second value
Notes:
Throws: Consultingwerk.Assertion.AssertException

Parameters:
piValue1 INT64
The first value to compare
piValue2 INT64
The second value to compare
Top

PUBLIC GE (integer, integer)

Purpose: Validates that the first value is GE the second value
Notes:
Throws: Consultingwerk.Assertion.AssertException

Parameters:
piValue1 INTEGER
The first value to compare
piValue2 INTEGER
The second value to compare
Top

PUBLIC GreaterThanZero (integer)

Purpose: Validates an ABL Integer value so that it is greater than 0
Notes:
Throws: Consultingwerk.Exceptions.InvalidValueException

Parameters:
piValue INTEGER
The Integer value to validate
Top

PUBLIC GreaterThanZero (integer, character)

Purpose: Validates an ABL Integer value so that it is greater than 0
Notes:
Throws: Consultingwerk.Exceptions.InvalidValueException

Parameters:
piValue INTEGER
The Integer value to validate
pcValueDesc CHARACTER
The optional description of the value used in the InvalidValueException
Top

PUBLIC GT (date, date)

Purpose: Validates that the first value is GT the second value
Notes:
Throws: Consultingwerk.Assertion.AssertException

Parameters:
pdaValue1 DATE
The first value to compare
pdaValue2 DATE
The second value to compare
Top

PUBLIC GT (datetime, datetime)

Purpose: Validates that the first value is GT the second value
Notes:
Throws: Consultingwerk.Assertion.AssertException

Parameters:
pdtValue1 DATETIME
The first value to compare
pdtValue2 DATETIME
The second value to compare
Top

PUBLIC GT (datetime-tz, datetime-tz)

Purpose: Validates that the first value is GT the second value
Notes:
Throws: Consultingwerk.Assertion.AssertException

Parameters:
pdtValue1 DATETIME-TZ
The first value to compare
pdtValue2 DATETIME-TZ
The second value to compare
Top

PUBLIC GT (decimal, decimal)

Purpose: Validates that the first value is GT the second value
Notes:
Throws: Consultingwerk.Assertion.AssertException

Parameters:
pdeValue1 DECIMAL
The first value to compare
pdeValue2 DECIMAL
The second value to compare
Top

PUBLIC GT (int64, int64)

Purpose: Validates that the first value is GT the second value
Notes:
Throws: Consultingwerk.Assertion.AssertException

Parameters:
piValue1 INT64
The first value to compare
piValue2 INT64
The second value to compare
Top

PUBLIC GT (integer, integer)

Purpose: Validates that the first value is GT the second value
Notes:
Throws: Consultingwerk.Assertion.AssertException

Parameters:
piValue1 INTEGER
The first value to compare
piValue2 INTEGER
The second value to compare
Top

PUBLIC IsGuid (character)

Purpose: Validates that an Character value is a valid GUID
Notes: Based on Consultingwerk.GuidType:IsGuid.
Throws: Consultingwerk.Exceptions.InvalidValueException

Parameters:
pcGuid CHARACTER
The guid to verify
Top

PUBLIC LE (date, date)

Purpose: Validates that the first value is LE the second value
Notes:
Throws: Consultingwerk.Assertion.AssertException

Parameters:
pdaValue1 DATE
The first value to compare
pdaValue2 DATE
The second value to compare
Top

PUBLIC LE (datetime, datetime)

Purpose: Validates that the first value is LE the second value
Notes:
Throws: Consultingwerk.Assertion.AssertException

Parameters:
pdtValue1 DATETIME
The first value to compare
pdtValue2 DATETIME
The second value to compare
Top

PUBLIC LE (datetime-tz, datetime-tz)

Purpose: Validates that the first value is LE the second value
Notes:
Throws: Consultingwerk.Assertion.AssertException

Parameters:
pdtValue1 DATETIME-TZ
The first value to compare
pdtValue2 DATETIME-TZ
The second value to compare
Top

PUBLIC LE (decimal, decimal)

Purpose: Validates that the first value is LE the second value
Notes:
Throws: Consultingwerk.Assertion.AssertException

Parameters:
pdeValue1 DECIMAL
The first value to compare
pdeValue2 DECIMAL
The second value to compare
Top

PUBLIC LE (int64, int64)

Purpose: Validates that the first value is LE the second value
Notes:
Throws: Consultingwerk.Assertion.AssertException

Parameters:
piValue1 INT64
The first value to compare
piValue2 INT64
The second value to compare
Top

PUBLIC LE (integer, integer)

Purpose: Validates that the first value is LE the second value
Notes:
Throws: Consultingwerk.Assertion.AssertException

Parameters:
piValue1 INTEGER
The first value to compare
piValue2 INTEGER
The second value to compare
Top

PUBLIC LT (date, date)

Purpose: Validates that the first value is LT the second value
Notes:
Throws: Consultingwerk.Assertion.AssertException

Parameters:
pdaValue1 DATE
The first value to compare
pdaValue2 DATE
The second value to compare
Top

PUBLIC LT (datetime, datetime)

Purpose: Validates that the first value is LT the second value
Notes:
Throws: Consultingwerk.Assertion.AssertException

Parameters:
pdtValue1 DATETIME
The first value to compare
pdtValue2 DATETIME
The second value to compare
Top

PUBLIC LT (datetime-tz, datetime-tz)

Purpose: Validates that the first value is LT the second value
Notes:
Throws: Consultingwerk.Assertion.AssertException

Parameters:
pdtValue1 DATETIME-TZ
The first value to compare
pdtValue2 DATETIME-TZ
The second value to compare
Top

PUBLIC LT (decimal, decimal)

Purpose: Validates that the first value is LT the second value
Notes:
Throws: Consultingwerk.Assertion.AssertException

Parameters:
pdeValue1 DECIMAL
The first value to compare
pdeValue2 DECIMAL
The second value to compare
Top

PUBLIC LT (int64, int64)

Purpose: Validates that the first value is GT the second value
Notes:
Throws: Consultingwerk.Assertion.AssertException

Parameters:
piValue1 INT64
The first value to compare
piValue2 INT64
The second value to compare
Top

PUBLIC LT (integer, integer)

Purpose: Validates that the first value is LT the second value
Notes:
Throws: Consultingwerk.Assertion.AssertException

Parameters:
piValue1 INTEGER
The first value to compare
piValue2 INTEGER
The second value to compare
Top

PUBLIC NE (character, character)

Purpose: Validates that two character values are not equal
Notes:
Throws: Consultingwerk.Assertion.AssertException

Parameters:
pcValue1 CHARACTER
The first value to compare
pcValue2 CHARACTER
The second value to compare
Top

PUBLIC NE (date, date)

Purpose: Validates that two date values are not equal
Notes:
Throws: Consultingwerk.Assertion.AssertException

Parameters:
pdtValue1 DATE
The first value to compare
pdtValue2 DATE
The second value to compare
Top

PUBLIC NE (datetime, datetime)

Purpose: Validates that two datetime values are not equal
Notes:
Throws: Consultingwerk.Assertion.AssertException

Parameters:
pdtValue1 DATETIME
The first value to compare
pdtValue2 DATETIME
The second value to compare
Top

PUBLIC NE (datetime-tz, datetime-tz)

Purpose: Validates that two datetime-tz values are not equal
Notes:
Throws: Consultingwerk.Assertion.AssertException

Parameters:
pdtValue1 DATETIME-TZ
The first value to compare
pdtValue2 DATETIME-TZ
The second value to compare
Top

PUBLIC NE (decimal, decimal)

Purpose: Validates that two decimal values are not equal
Notes:
Throws: Consultingwerk.Assertion.AssertException

Parameters:
pdeValue1 DECIMAL
The first value to compare
pdeValue2 DECIMAL
The second value to compare
Top

PUBLIC NE (handle, handle)

Purpose: Validates that two handles are not equal
Notes:
Throws: Consultingwerk.Assertion.AssertException

Parameters:
phValue1 HANDLE
The first value to compare
phValue2 HANDLE
The second value to compare
Top

PUBLIC NE (int64, int64)

Purpose: Validates that two integer values are not equal
Notes:
Throws: Consultingwerk.Assertion.AssertException

Parameters:
piValue1 INT64
The first value to compare
piValue2 INT64
The second value to compare
Top

PUBLIC NE (logical, logical)

Purpose: Validates that two logical values are not equal
Notes:
Throws: Consultingwerk.Assertion.AssertException

Parameters:
plValue1 LOGICAL
The first value to compare
plValue2 LOGICAL
The second value to compare
Top

PUBLIC NE (longchar, longchar)

Purpose: Validates that two longchar values are not equal
Notes:
Throws: Consultingwerk.Assertion.AssertException

Parameters:
plcValue1 LONGCHAR
The first value to compare
plcValue2 LONGCHAR
The second value to compare
Top

PUBLIC NE (raw, raw)

Purpose: Validates that two raw values are not equal
Notes:
Throws: Consultingwerk.Assertion.AssertException

Parameters:
praValue1 RAW
The first value to compare
praValue2 RAW
The second value to compare
Top

PUBLIC NE (recid, recid)

Purpose: Validates that two recid values are not equal
Notes:
Throws: Consultingwerk.Assertion.AssertException

Parameters:
preValue1 RECID
The first value to compare
preValue2 RECID
The second value to compare
Top

PUBLIC NE (rowid, rowid)

Purpose: Validates that two rowid values are not equal
Notes:
Throws: Consultingwerk.Assertion.AssertException

Parameters:
proValue1 ROWID
The first value to compare
proValue2 ROWID
The second value to compare
Top

PUBLIC NotNull (date)

Purpose: Validates an ABL Logical value so that it is not ?
Notes:
Throws: Consultingwerk.Exceptions.InvalidValueException

Parameters:
pdtValue DATE
The Date value to validate
Top

PUBLIC NotNull (datetime)

Purpose: Validates an ABL Logical value so that it is not ?
Notes:
Throws: Consultingwerk.Exceptions.InvalidValueException

Parameters:
pdtValue DATETIME
The DateTime value to validate
Top

PUBLIC NotNull (datetime-tz)

Purpose: Validates an ABL Logical value so that it is not ?
Notes:
Throws: Consultingwerk.Exceptions.InvalidValueException

Parameters:
pdtValue DATETIME-TZ
The DateTime-Tz value to validate
Top

PUBLIC NotNull (logical)

Purpose: Validates an ABL Logical value so that it is not ?
Notes:
Throws: Consultingwerk.Exceptions.InvalidValueException

Parameters:
plValue LOGICAL
The Logical value to validate
Top

PUBLIC NotNullOrEmpty (character)

Purpose: Validates an ABL Charcater value so that it is not ? or Empty
Notes:
Throws: Consultingwerk.Exceptions.InvalidValueException

Parameters:
pcValue CHARACTER
The Character value to validate
Top

PUBLIC NotNullOrEmpty (character, character)

Purpose: Validates an ABL Charcater value so that it is not ? or Empty
Notes:
Throws: Consultingwerk.Exceptions.InvalidValueException

Parameters:
pcValue CHARACTER
The Character value to validate
pcValueDesc CHARACTER
The optional description of the value used in the InvalidValueException
Top

PUBLIC NotNullOrEmpty (longchar)

Purpose: Validates an ABL LONGCHAR value so that it is not ? or Empty
Notes:
Throws: Consultingwerk.Exceptions.InvalidValueException

Parameters:
plcValue LONGCHAR
The Character value to validate
Top

PUBLIC NotNullOrEmpty (longchar, character)

Purpose: Validates an ABL LONGCHAR value so that it is not ? or Empty
Notes:
Throws: Consultingwerk.Exceptions.InvalidValueException

Parameters:
plcValue LONGCHAR
The Character value to validate
pcValueDesc CHARACTER
The optional description of the value used in the InvalidValueException
Top

PUBLIC NotNullOrZero (decimal)

Purpose: Validates an ABL Decimal value so that it is not ? or 0
Notes:
Throws: Consultingwerk.Exceptions.InvalidValueException

Parameters:
piValue DECIMAL
The Decimal value to validate
Top

PUBLIC NotNullOrZero (decimal, character)

Purpose: Validates an ABL Decimal value so that it is not ? or 0
Notes:
Throws: Consultingwerk.Exceptions.InvalidValueException

Parameters:
piValue DECIMAL
The Decimal value to validate
pcValueDesc CHARACTER
The optional description of the value used in the InvalidValueException
Top

PUBLIC NotNullOrZero (integer)

Purpose: Validates an ABL Integer value so that it is not ? or 0
Notes:
Throws: Consultingwerk.Exceptions.InvalidValueException

Parameters:
piValue INTEGER
The Integer value to validate
Top

PUBLIC NotNullOrZero (integer, character)

Purpose: Validates an ABL Integer value so that it is not ? or 0
Notes:
Throws: Consultingwerk.Exceptions.InvalidValueException

Parameters:
piValue INTEGER
The Integer value to validate
pcValueDesc CHARACTER
The optional description of the value used in the InvalidValueException


Constructor Detail
Top

PRIVATE Assert ()

Purpose: Disallow instance creation
Notes:



©2006-2020 Consultingwerk Ltd.         info@consultingwerk.de         http://www.consultingwerk.de       04.02.2020 23:10:48