set_c |

Table of contents## Procedureset_c ( Compare sets ) SpiceBoolean set_c ( SpiceCell * a, ConstSpiceChar * op, SpiceCell * b ) ## AbstractCompare two sets of any data type, as indicated by a relational operator. ## Required_ReadingCELLS SETS ## KeywordsCELLS SETS ## Brief_I/OVARIABLE I/O DESCRIPTION -------- --- -------------------------------------------------- a I First set. op I Comparison operator. b I Second set. The function returns the result of the comparison: a (op) b. ## Detailed_Inputa is a SPICE set. `a' must be declared as a character, double precision or integer SpiceCell. CSPICE provides the following macros, which declare and initialize the cell SPICECHAR_CELL ( a, ASZ, AMLEN ); SPICEDOUBLE_CELL ( a, ASZ ); SPICEINT_CELL ( a, ASZ ); where ASZ is the maximum capacity of `a' and AMLEN is the maximum length of any member in the character cell. op is a comparison operator, indicating the way in which the input sets are to be compared. `op' may be any of the following: Operator Meaning -------- ------------------------------------- "=" a = b is true if a and b are equal (contain the same elements). "<>" a <> b is true if a and b are not equal. "<=" a <= b is true if a is a subset of b. "<" a < b is true if a is a proper subset of b. ">=" a >= b is true if b is a subset of a. ">" a > b is true if b is a proper subset of a. "&" a & b is true if a and b have one or more elements in common (the intersection of the two sets in non-empty.) "~" a ~ b is true if a and b are disjoint sets. When comparing elements of character sets, this routine ignores trailing blanks. b is a second SPICE set, to be compared to `a'. `b' must be declared as a SpiceCell of the same data type as `a'. CSPICE provides the following macros, which declare and initialize the cell SPICECHAR_CELL ( b, BSZ, BMLEN ); SPICEDOUBLE_CELL ( b, BSZ ); SPICEINT_CELL ( b, BSZ ); where BSZ is the maximum capacity of `b' and BMLEN is the maximum length of any member in the character cell. ## Detailed_OutputThe function returns the result of the comparison: a (op) b. ## ParametersNone. ## Exceptions1) If the set relational operator is not recognized, the error SPICE(INVALIDOPERATION) is signaled by a routine in the call tree of this routine. 2) If the `op' input string pointer is null, the error SPICE(NULLPOINTER) is signaled. 3) If the `op' input string has zero length, the error SPICE(EMPTYSTRING) is signaled. 4) If the `a' and `c' cell arguments do not have identical data types, the error SPICE(TYPEMISMATCH) is signaled. 5) If any of the `a' or `c' cell arguments does not qualify as a SPICE set, the error SPICE(NOTASET) is signaled. SPICE sets have their data elements stored in increasing order and contain no duplicate elements. 6) If any of the `a' or `c' cell arguments does not have a recognized data type, the error SPICE(NOTSUPPORTED) is signaled. 7) If the cell arguments are of type SpiceChar and the string length associated with any of them is non-positive or too short to be usable when constructing the equivalent SPICE character cells required by the wrapped SPICELIB routine, an error is signaled by a routine in the call tree of this routine. ## FilesNone. ## ParticularsNone. ## Examples1) In the following code fragment, ## Restrictions1) String comparisons performed by this routine are Fortran-style: trailing blanks in the input sets are ignored. This gives consistent behavior with CSPICE code generated by the f2c translator, as well as with the Fortran SPICE Toolkit. Note that this behavior is not identical to that of the ANSI C library functions strcmp and strncmp. ## Literature_ReferencesNone. ## Author_and_InstitutionN.J. Bachman (JPL) C.A. Curzon (JPL) J. Diaz del Rio (ODC Space) W.L. Taber (JPL) I.M. Underwood (JPL) ## Version-CSPICE Version 1.1.1, 29-OCT-2021 (JDR) Edited the header to comply with NAIF standard. Extended description of arguments "a", and "b" to include type and preferred declaration method. Added entries #5 and #6 in -Exceptions section. -CSPICE Version 1.1.0, 15-FEB-2005 (NJB) Bug fix: loop bound changed from 1 to 2 in loop used to free dynamically allocated arrays. -CSPICE Version 1.0.0, 08-AUG-2002 (NJB) (CAC) (WLT) (IMU) ## Index_Entriescompare sets |

Fri Dec 31 18:41:12 2021