Name

dce_cf_same_cell_name - Indicates whether or not two cell names refer to the same cell

Synopsis

#include <stdio.h>
#include <dce/dce_cf.h> void dce_cf_same_cell_name(
char ∗cell_name1,
char ∗cell_name2,
boolean result,
error_status_t ∗status);

Parameters

Input

cell_name1A character string that specifies the name of a cell. 

cell_name2A character string that specifies the name of a cell to compare with cell_name1.  If this value is NULL, the routine determines whether or not the cell name specified in cell_name1 is the name of the local cell. 

Output

resultA boolean value that indicates whether or not the specified cell names match, when two cell names are given, and indicates whether or not the specified cell name is the name of the local cell, when only one cell name is given.  A value of TRUE indicates that the cell names refer to the same cell. 

statusReturns the status code from this operation.  The status code is a value that indicates whether the routine completed successfully and if not, why not. 

Description

The dce_cf_same_cell_name () routine, when given the names of two cells as input parameters, compares the cell names to determine whether or not they refer to the same call.  The result parameter is set to TRUE if they do, and to FALSE if they do not. 

If only one cell name is specified as an input parameter, the dce_cf_same_cell_name() routine determines whether or not the specified cell name is the same as the local cell’s primary name (which it retrieves by calling dce_cf_get_cell_name()).  You can use the routine in this way to determine whether a given cell name is the primary name of your local cell. 

Errors

The following describes a partial list of errors that might be returned.  Refer to the OSF DCE Problem Determination Guide for complete descriptions of all error messages. 

dce_cf_st_ok

dce_cf_e_no_match

Related Information

Functions: dce_cf_free_cell_aliases(3dce), dce_cf_get_cell_aliases(3dce), dce_cf_get_cell_name(3dce). 

Books: OSF DCE Application Development Guide—Core Components, OSF DCE Command Reference.