diff_c |

## Procedurevoid diff_c ( SpiceCell * a, SpiceCell * b, SpiceCell * c ) ## AbstractTake the difference of two sets of any data type to form a third set. ## Required_ReadingSETS ## KeywordsCELLS, SETS ## Brief_I/OVARIABLE I/O DESCRIPTION -------- --- -------------------------------------------------- a I First input set. b I Second input set. c O Difference of a and b. ## Detailed_Inputa is a CSPICE set. a must be declared as a SpiceCell of data type character, double precision, or integer. b is a CSPICE set, distinct from a. b must have the same data type as a. ## Detailed_Outputc is a CSPICE set, distinct from sets a and b, which contains the difference of a and b (that is, all of the elements which are in a but NOT in b). c must have the same data type as a and b. When comparing elements of character sets, this routine ignores trailing blanks. Trailing blanks will be trimmed from the members of the output set c. ## ParametersNone. ## Exceptions1) If the input set arguments don't have identical data types, the error SPICE(TYPEMISMATCH) is signaled. 2) If the difference of the two sets contains more elements than can be contained in the output set, the error SPICE(SETEXCESS) is signaled. 3) If the set arguments have character type and the length of the elements of the output set is less than the maximum of the lengths of the elements of the input sets, the error SPICE(ELEMENTSTOOSHORT) is signaled. 4) If either of the input arguments may be unordered or contain duplicates, the error SPICE(NOTASET) is signaled. ## FilesNone. ## ParticularsThis is a generic CSPICE set routine; it operates on sets of any supported data type. The difference of two sets contains every element which is in the first set, but NOT in the second. {a,b} difference {c,d} = {a,b} {a,b,c} {b,c,d} {a} {a,b,c,d} {} {a,b,c,d} {} {a,b,c,d} {} {} {} {} ## Examples1) The following code fragment places the difference of the character sets planets and asteroids into the character set result. #include "SpiceUsr.h" . . . /. Declare the sets with string length NAMLEN and with maximum number of elements MAXSIZ. ./ SPICECHAR_CELL ( planets, MAXSIZ, NAMLEN ); SPICECHAR_CELL ( asteroids, MAXSIZ, NAMLEN ); SPICECHAR_CELL ( result, MAXSIZ, NAMLEN ); . . . /. Compute the difference. ./ ## Restrictions1) The output set must be distinct from both of the input sets. For example, the following calls are invalid. ## Literature_ReferencesNone. ## Author_and_InstitutionN.J. Bachman (JPL) C.A. Curzon (JPL) W.L. Taber (JPL) I.M. Underwood (JPL) ## Version-CSPICE Version 1.1.0, 15-FEB-2005 (NJB) Bug fix: loop bound changed from 2 to 3 in loop used to free dynamically allocated arrays. -CSPICE Version 1.0.0, 08-AUG-2002 (NJB) (CAC) (WLT) (IMU) ## Index_Entriesdifference of two sets |

Wed Apr 5 17:54:31 2017