Index Page
cspice_ucase
A  B  C  D  E  F  G  H  I  J  K  L  M  N  O  P  Q  R  S  T  U  V  W  X 

Abstract
I/O
Examples
Particulars
Required Reading
Version
Index_Entries

Abstract


   CSPICE_UCASE converts the characters in an input string 
   to upper case.

   For important details concerning this module's function, please refer to
   the CSPICE routine ucase_c.

I/O

   
   Given:
   
      in   an arbitrary scalar string
   
           The routine allocates memory for the 'out' string based on
           the length of the 'in' string. An 'in' string with length
           zero causes a no-op.
   
   the call:
   
      cspice_ucase, in, out
   
   returns:
   
      out   a scalar string copy of 'in' with all letter 
            characters converted to upper case
   
   IDL native code to perform the same operation:
   
      out = strupcase (in)
   

Examples


   Any numerical results shown for this example may differ between
   platforms as the results depend on the SPICE kernels used as input
   and the machine specific arithmetic implementation.

      ;;
      ;; A string of lower case characters.
      ;;
      low_string = 'carthago destructus est'
   
      ;;
      ;; Convert low_string to uppercase. 
      ;;
      cspice_ucase, low_string, upper
      print, upper
   
   With an output: CARTHAGO DESTRUCTUS EST

Particulars


   None.

Required Reading


   ICY.REQ

Version


   -Icy Version 1.0.1, 12-JUL-2005, EDW (JPL)

      I/O header format tweak. No effect on functionality.

   -Icy Version 1.0.0, 16-JUN-2003, EDW (JPL)

Index_Entries

 
   convert to uppercase 
 



Wed Apr  5 17:58:04 2017