test_format (library)

Author(s): Isabel Martín García.

Version: 1.11#222 (2004/5/24, 13:8:7 CEST)

Version of last change: 1.9#170 (2003/12/4, 17:39:57 CET)

Most of the predicates exported by this module perform some checks to determine whether the arguments attain some conditions or not. In the second case an exception will be thrown. To catch the exceptions you can use the following metapredicates when invoking chartlib exported predicates:

• chartlib_text_error_protect/1
• chartlib_text_error_protect/1

Both metapredicates are defined in the chartlib_errhandle module that comes with this library. Some of the predicates have a Predicate argument which will be used in case of error to show which chartlib predicate causes the error.

• Usage and interface (test_format)
• Documentation on exports (test_format)

Usage and interface (test_format)

Documentation on exports (test_format)

PREDICATE: equalnumber/3:

equalnumber(X, Y, Predicate)

Test whether the list X and the list Y contain the same number of elements.

Usage:

• The following properties should hold at call time: X is a list. (basic_props:list/1) Y is a list. (basic_props:list/1) Predicate is a term which represents a goal, i.e., an atom or a structure. (basic_props:callable/1)

PREDICATE: not_empty/4:

not_empty(X, Y, Z, Predicate)

Tests whether at least one the lists X, Y or Z are empty.

Usage:

• The following properties should hold at call time: X is a list. (basic_props:list/1) Y is a list. (basic_props:list/1) Z is a list. (basic_props:list/1) Predicate is a term which represents a goal, i.e., an atom or a structure. (basic_props:callable/1)

PREDICATE: not_empty/3:

not_empty(X, Y, Predicate)

Tests whether the lists X or Y are empty.

Usage:

• The following properties should hold at call time: X is a list. (basic_props:list/1) Y is a list. (basic_props:list/1) Predicate is a term which represents a goal, i.e., an atom or a structure. (basic_props:callable/1)

PREDICATE: check_sublist/4:

check_sublist(List, Number, Number, Predicate)

Tests if the number of elements in each sublist of List is Number1 or Number2.

Usage:

• The following properties should hold at call time: List is a list. (basic_props:list/1) Number is currently instantiated to an integer. (term_typing:integer/1) Number is currently instantiated to an integer. (term_typing:integer/1) Predicate is an atom. (basic_props:atm/1)

PREDICATE: valid_format/4:

valid_format(XVector, YVector, BarsAttributes, Predicate)

Tests the following restrictions:

• The XVector number of elements is the same as each YVector sublist number of elements.
• The YVector length is equal to BarsAttributes length.

Usage:

• The following properties should hold at call time: XVector is a list. (basic_props:list/1) YVector is a list. (basic_props:list/1) BarsAttributes is a list. (basic_props:list/1) Predicate is a term which represents a goal, i.e., an atom or a structure. (basic_props:callable/1)

PREDICATE: vectors_format/4:

vectors_format(XVector, YVectors, LinesAttributes, Predicate)

Tests the following conditions:

• YVectors list and LinesAttributes list have the same number of elements.
• XVector list and each YVectors element have the same number of elements.
• Each sublist of LinesAttributes is composed of 5, 3 or 1 elements.

Usage:

• The following properties should hold at call time: XVector is a list. (basic_props:list/1) YVectors is a list. (basic_props:list/1) LinesAttributes is a list. (basic_props:list/1) Predicate is a term which represents a goal, i.e., an atom or a structure. (basic_props:callable/1)

PREDICATE: valid_vectors/4:

valid_vectors(XVector, YVectors, LinesAttributes, Predicate)

Tests the following conditions:

• XVector list, YVectors list and LinesAttributes list have the same number of elements.
• Each sublist of LinesAttributes is composed of 5, 3 or 1 element.

Usage:

• The following properties should hold at call time: XVector is a list. (basic_props:list/1) YVectors is a list. (basic_props:list/1) LinesAttributes is a list. (basic_props:list/1) Predicate is a term which represents a goal, i.e., an atom or a structure. (basic_props:callable/1)

PREDICATE: valid_attributes/2:

valid_attributes(BarsAttibuttes, Predicate)

Check if each BarsAttibuttes element is a list composed of one or four elements.

Usage:

• The following properties should hold at call time: BarsAttibuttes is a list. (basic_props:list/1) Predicate is a term which represents a goal, i.e., an atom or a structure. (basic_props:callable/1)

PREDICATE: valid_table/2:

valid_table(ElementTable, Predicate)

All of the ElementTable sublists have the same number of elements and are not empty.

Usage:

• The following properties should hold at call time: ElementTable is a list. (basic_props:list/1) Predicate is a term which represents a goal, i.e., an atom or a structure. (basic_props:callable/1)

Go to the first, previous, next, last section, table of contents.