Abstract

   CSPICE_REPMI replaces a marker with an integer.

I/O

   Given:

      in       an arbitrary character string.

               [1,c1] = size(in); char = class(in)

                  or

               [1,1] = size(in); cell = class(in)

      marker   an arbitrary character string.

               [1,c2] = size(marker); char = class(marker)

                  or

               [1,1] = size(marker); cell = class(marker)

               The first occurrence of `marker' in the input string is to
               be replaced by `value'.

               Leading and trailing blanks in `marker' are NOT
               significant. In particular, no substitution is performed
               if `marker' is blank or empty.

      value    an arbitrary integer.

               [1,1] = size(value); int32 = class(value)

   the call:

      [out] = cspice_repmi( in, marker, value )

   returns:

      out      the string obtained by substituting the text representation
               of `value' for the first occurrence of `marker' in the input
               string.

               [1,c3] = size(out); char = class(out)

Parameters

   None.

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.

   1) The following example illustrate the use of cspice_repmi to
      replace a marker within a string with the text representation
      of an integer value.


      Example code begins here.


      function repmi_ex1()

         %
         % 1. Single marker
         %
         marker   = '#';
         instr    = 'Invalid value. The value was:  #';

         [outstr] = cspice_repmi( instr, marker, 75 );

         fprintf( 'Case 1: Single marker.\n' )
         fprintf( '   Input : %s\n', instr )
         fprintf( '   Output: %s\n', outstr )
         fprintf( '\n' )

         %
         % 2. Multiple markers
         %
         marker   = ' XX ';
         instr    = 'Left > Right endpoint. Left: XX; Right: XX';

         [outstr] = cspice_repmi( instr, marker, 2035 );

         fprintf( 'Case 2: Multiple markers.\n' )
         fprintf( '   Input : %s\n', instr )
         fprintf( '   Output: %s\n', outstr )
         fprintf( '\n' )


      When this program was executed on a Mac/Intel/Octave6.x/64-bit
      platform, the output was:


      Case 1: Single marker.
         Input : Invalid value. The value was:  #
         Output: Invalid value. The value was:  75

      Case 2: Multiple markers.
         Input : Left > Right endpoint. Left: XX; Right: XX
         Output: Left > Right endpoint. Left: 2035; Right: XX

Particulars

   This is one of a family of related routines for inserting values
   into strings. They are typically to construct messages that
   are partly fixed, and partly determined at run time. For example,
   a message like

      'Fifty-one pictures were found in directory [USER.DATA].'

   might be constructed from the fixed string

      '#1 pictures were found in directory #2.'

   by the calls

      [string] = cspice_repmct( string, '#1', 51, 'C' );
      [string] = cspice_repmc( string, '#2', '[USER.DATA]' );

   which substitute the cardinal text 'Fifty-one' and the character
   string '[USER.DATA]' for the markers '#1' and '#2' respectively.

   The complete list of routines is shown below.

      cspice_repmc    ( Replace marker with character string value )
      cspice_repmd    ( Replace marker with double precision value )
      cspice_repmf    ( Replace marker with formatted d.p. value   )
      cspice_repmi    ( Replace marker with integer value          )
      cspice_repml    ( Replace marker with logical value          )
      cspice_repmct   ( Replace marker with cardinal text          )
      cspice_repmot   ( Replace marker with ordinal text           )

Exceptions

   1)  If `marker' is blank or empty, or if `marker' is not a substring of
       `in', no substitution is performed. (`out' and `in' are identical.)

   2)  If any of the input arguments, `in', `marker' or `value', is
       undefined, an error is signaled by the Matlab error handling
       system.

   3)  If any of the input arguments, `in', `marker' or `value', is
       not of the expected type, or it does not have the expected
       dimensions and size, an error is signaled by the Mice
       interface.

Files

   None.

Restrictions

   None.

Required_Reading

   MICE.REQ

Literature_References

   None.

Author_and_Institution

   J. Diaz del Rio     (ODC Space)

Version

   -Mice Version 1.0.0, 22-JAN-2021 (JDR)

Index_Entries

   replace marker with integer