bstr_sequences_are_equal(3) — Subroutines
Name
bstr_sequences_are_equal − Compares two sequences to determine whether they are equal.
Syntax
bstr_t_status bstr_sequences_are_equal (
bstr_t_sequence ∗first_sequence,
bstr_t_sequence ∗second_sequence,
bstr_t_boolean ∗equality);
Description
The bstr_sequences_are_equal procedure determines whether two specified sequences are equal. Sequences are considered equal if they contain the same elements in the same order, and if the elements have the same length.
Arguments
first_sequence
access: read
The address of the first sequence to be compared.
second_sequence
access: read
The address of the second sequence to be compared.
equality
access: write
The result of the comparison. If the sequences are equal, the value is BSTR_C_TRUE; otherwise it is BSTR_C_FALSE.
Return Values
| BSTR_S_BAD_DATA_ELEMENTS | Bad data elements |
| BSTR_S_BAD_PARAMETER | Bad parameter value |
| BSTR_S_BAD_SEQUENCE | Bad sequence |
| BSTR_S_COM_PC_SIZE_MISMATCH | Number of bytes requested does not match the number of bytes returned |
| BSTR_S_NORMAL | Normal successful completion |
| BSTR_S_NOT_INITIALIZED | BASEstar Open not initialized |