xref: /petsc/src/sys/utils/str.c (revision 7d0a6c19129e7069c8a40e210b34ed62989173db)
1*7d0a6c19SBarry Smith 
2e5c89e4eSSatish Balay /*
3e5c89e4eSSatish Balay     We define the string operations here. The reason we just do not use
4e5c89e4eSSatish Balay   the standard string routines in the PETSc code is that on some machines
5e5c89e4eSSatish Balay   they are broken or have the wrong prototypes.
6e5c89e4eSSatish Balay 
7e5c89e4eSSatish Balay */
8d382aafbSBarry Smith #include "petscsys.h"                   /*I  "petscsys.h"   I*/
9e5c89e4eSSatish Balay #if defined(PETSC_HAVE_STRING_H)
10e5c89e4eSSatish Balay #include <string.h>
11e5c89e4eSSatish Balay #endif
12e5c89e4eSSatish Balay #if defined(PETSC_HAVE_STRINGS_H)
13e5c89e4eSSatish Balay #include <strings.h>
14e5c89e4eSSatish Balay #endif
15e5c89e4eSSatish Balay 
16e5c89e4eSSatish Balay #undef __FUNCT__
173c311c98SBarry Smith #define __FUNCT__ "PetscStrToArray"
183c311c98SBarry Smith /*@C
193c311c98SBarry Smith    PetscStrToArray - Seperates a string by its spaces and creates and array of strings
203c311c98SBarry Smith 
213c311c98SBarry Smith    Not Collective
223c311c98SBarry Smith 
233c311c98SBarry Smith    Input Parameters:
243c311c98SBarry Smith .  s - pointer to string
253c311c98SBarry Smith 
263c311c98SBarry Smith    Output Parameter:
273c311c98SBarry Smith +   argc - the number of entries in the array
283c311c98SBarry Smith -   args - an array of the entries with a null at the end
293c311c98SBarry Smith 
303c311c98SBarry Smith    Level: intermediate
313c311c98SBarry Smith 
32301d30feSBarry Smith    Notes: this may be called before PetscInitialize() or after PetscFinalize()
333c311c98SBarry Smith 
346f013253SBarry Smith    Not for use in Fortran
356f013253SBarry Smith 
36301d30feSBarry Smith    Developer Notes: Using raw malloc() since this may be used before PETSc is initialized
37301d30feSBarry Smith 
38301d30feSBarry Smith .seealso: PetscStrToArrayDestroy()
393c311c98SBarry Smith 
403c311c98SBarry Smith @*/
417087cfbeSBarry Smith PetscErrorCode  PetscStrToArray(const char s[],int *argc,char ***args)
423c311c98SBarry Smith {
433c311c98SBarry Smith   int        i,n,*lens,cnt = 0;
44ace3abfcSBarry Smith   PetscBool  flg = PETSC_FALSE;
453c311c98SBarry Smith 
463c311c98SBarry Smith   n = strlen(s);
473c311c98SBarry Smith   *argc = 0;
483c311c98SBarry Smith   for (i=0; i<n; i++) {
493c311c98SBarry Smith     if (s[i] != ' ') break;
503c311c98SBarry Smith   }
513c311c98SBarry Smith   for (;i<n+1; i++) {
523c311c98SBarry Smith     if ((s[i] == ' ' || s[i] == 0) && !flg) {flg = PETSC_TRUE; (*argc)++;}
533c311c98SBarry Smith     else if (s[i] != ' ') {flg = PETSC_FALSE;}
543c311c98SBarry Smith   }
55301d30feSBarry Smith   (*args) = (char **) malloc(((*argc)+1)*sizeof(char**)); if (!*args) return PETSC_ERR_MEM;
5653e6e2c4SHong Zhang   lens    = (int*) malloc((*argc)*sizeof(int)); if (!lens) return PETSC_ERR_MEM;
573c311c98SBarry Smith   for (i=0; i<*argc; i++) lens[i] = 0;
583c311c98SBarry Smith 
593c311c98SBarry Smith   *argc = 0;
603c311c98SBarry Smith   for (i=0; i<n; i++) {
613c311c98SBarry Smith     if (s[i] != ' ') break;
623c311c98SBarry Smith   }
633c311c98SBarry Smith   for (;i<n+1; i++) {
643c311c98SBarry Smith     if ((s[i] == ' ' || s[i] == 0) && !flg) {flg = PETSC_TRUE; (*argc)++;}
653c311c98SBarry Smith     else if (s[i] != ' ') {lens[*argc]++;flg = PETSC_FALSE;}
663c311c98SBarry Smith   }
673c311c98SBarry Smith 
683c311c98SBarry Smith   for (i=0; i<*argc; i++) {
69675282fdSHong Zhang     (*args)[i] = (char*) malloc((lens[i]+1)*sizeof(char)); if (!(*args)[i]) return PETSC_ERR_MEM;
703c311c98SBarry Smith   }
71301d30feSBarry Smith   (*args)[*argc] = 0;
723c311c98SBarry Smith 
733c311c98SBarry Smith   *argc = 0;
743c311c98SBarry Smith   for (i=0; i<n; i++) {
753c311c98SBarry Smith     if (s[i] != ' ') break;
763c311c98SBarry Smith   }
773c311c98SBarry Smith   for (;i<n+1; i++) {
783c311c98SBarry Smith     if ((s[i] == ' ' || s[i] == 0) && !flg) {flg = PETSC_TRUE; (*args)[*argc][cnt++] = 0; (*argc)++; cnt = 0;}
79301d30feSBarry Smith     else if (s[i] != ' ' && s[i] != 0) {(*args)[*argc][cnt++] = s[i]; flg = PETSC_FALSE;}
803c311c98SBarry Smith   }
813c311c98SBarry Smith   return 0;
823c311c98SBarry Smith }
833c311c98SBarry Smith 
843c311c98SBarry Smith #undef __FUNCT__
85301d30feSBarry Smith #define __FUNCT__ "PetscStrToArrayDestroy"
86301d30feSBarry Smith /*@C
87301d30feSBarry Smith    PetscStrToArrayDestroy - Frees array created with PetscStrToArray().
88301d30feSBarry Smith 
89301d30feSBarry Smith    Not Collective
90301d30feSBarry Smith 
91301d30feSBarry Smith    Output Parameters:
92301d30feSBarry Smith +  argc - the number of arguments
93301d30feSBarry Smith -  args - the array of arguments
94301d30feSBarry Smith 
95301d30feSBarry Smith    Level: intermediate
96301d30feSBarry Smith 
97301d30feSBarry Smith    Concepts: command line arguments
98301d30feSBarry Smith 
99301d30feSBarry Smith    Notes: This may be called before PetscInitialize() or after PetscFinalize()
100301d30feSBarry Smith 
1016f013253SBarry Smith    Not for use in Fortran
1026f013253SBarry Smith 
103301d30feSBarry Smith .seealso: PetscStrToArray()
104301d30feSBarry Smith 
105301d30feSBarry Smith @*/
1067087cfbeSBarry Smith PetscErrorCode  PetscStrToArrayDestroy(int argc,char **args)
107301d30feSBarry Smith {
108301d30feSBarry Smith   PetscInt i;
109301d30feSBarry Smith 
110301d30feSBarry Smith   for (i=0; i<argc; i++) {
111301d30feSBarry Smith     free(args[i]);
112301d30feSBarry Smith   }
113301d30feSBarry Smith   free(args);
114301d30feSBarry Smith   return 0;
115301d30feSBarry Smith }
116301d30feSBarry Smith 
117301d30feSBarry Smith #undef __FUNCT__
118e5c89e4eSSatish Balay #define __FUNCT__ "PetscStrlen"
119e5c89e4eSSatish Balay /*@C
120e5c89e4eSSatish Balay    PetscStrlen - Gets length of a string
121e5c89e4eSSatish Balay 
122e5c89e4eSSatish Balay    Not Collective
123e5c89e4eSSatish Balay 
124e5c89e4eSSatish Balay    Input Parameters:
125e5c89e4eSSatish Balay .  s - pointer to string
126e5c89e4eSSatish Balay 
127e5c89e4eSSatish Balay    Output Parameter:
128e5c89e4eSSatish Balay .  len - length in bytes
129e5c89e4eSSatish Balay 
130e5c89e4eSSatish Balay    Level: intermediate
131e5c89e4eSSatish Balay 
132e5c89e4eSSatish Balay    Note:
133e5c89e4eSSatish Balay    This routine is analogous to strlen().
134e5c89e4eSSatish Balay 
135e5c89e4eSSatish Balay    Null string returns a length of zero
136e5c89e4eSSatish Balay 
1376f013253SBarry Smith    Not for use in Fortran
1386f013253SBarry Smith 
139e5c89e4eSSatish Balay   Concepts: string length
140e5c89e4eSSatish Balay 
141e5c89e4eSSatish Balay @*/
1427087cfbeSBarry Smith PetscErrorCode  PetscStrlen(const char s[],size_t *len)
143e5c89e4eSSatish Balay {
144e5c89e4eSSatish Balay   PetscFunctionBegin;
145e5c89e4eSSatish Balay   if (!s) {
146e5c89e4eSSatish Balay     *len = 0;
147e5c89e4eSSatish Balay   } else {
148e5c89e4eSSatish Balay     *len = strlen(s);
149e5c89e4eSSatish Balay   }
150e5c89e4eSSatish Balay   PetscFunctionReturn(0);
151e5c89e4eSSatish Balay }
152e5c89e4eSSatish Balay 
153e5c89e4eSSatish Balay #undef __FUNCT__
154e5c89e4eSSatish Balay #define __FUNCT__ "PetscStrallocpy"
155e5c89e4eSSatish Balay /*@C
156e5c89e4eSSatish Balay    PetscStrallocpy - Allocates space to hold a copy of a string then copies the string
157e5c89e4eSSatish Balay 
158e5c89e4eSSatish Balay    Not Collective
159e5c89e4eSSatish Balay 
160e5c89e4eSSatish Balay    Input Parameters:
161e5c89e4eSSatish Balay .  s - pointer to string
162e5c89e4eSSatish Balay 
163e5c89e4eSSatish Balay    Output Parameter:
164e5c89e4eSSatish Balay .  t - the copied string
165e5c89e4eSSatish Balay 
166e5c89e4eSSatish Balay    Level: intermediate
167e5c89e4eSSatish Balay 
168e5c89e4eSSatish Balay    Note:
169e5c89e4eSSatish Balay       Null string returns a new null string
170e5c89e4eSSatish Balay 
1716f013253SBarry Smith       Not for use in Fortran
1726f013253SBarry Smith 
173e5c89e4eSSatish Balay   Concepts: string copy
174e5c89e4eSSatish Balay 
175e5c89e4eSSatish Balay @*/
1767087cfbeSBarry Smith PetscErrorCode  PetscStrallocpy(const char s[],char *t[])
177e5c89e4eSSatish Balay {
178e5c89e4eSSatish Balay   PetscErrorCode ierr;
179e5c89e4eSSatish Balay   size_t         len;
18071573d7dSBarry Smith   char           *tmp = 0;
181e5c89e4eSSatish Balay 
182e5c89e4eSSatish Balay   PetscFunctionBegin;
183e5c89e4eSSatish Balay   if (s) {
184e5c89e4eSSatish Balay     ierr = PetscStrlen(s,&len);CHKERRQ(ierr);
18571573d7dSBarry Smith     ierr = PetscMalloc((1+len)*sizeof(char),&tmp);CHKERRQ(ierr);
18671573d7dSBarry Smith     ierr = PetscStrcpy(tmp,s);CHKERRQ(ierr);
187e5c89e4eSSatish Balay   }
18871573d7dSBarry Smith   *t = tmp;
189e5c89e4eSSatish Balay   PetscFunctionReturn(0);
190e5c89e4eSSatish Balay }
191e5c89e4eSSatish Balay 
192e5c89e4eSSatish Balay #undef __FUNCT__
193e5c89e4eSSatish Balay #define __FUNCT__ "PetscStrcpy"
194e5c89e4eSSatish Balay /*@C
195e5c89e4eSSatish Balay    PetscStrcpy - Copies a string
196e5c89e4eSSatish Balay 
197e5c89e4eSSatish Balay    Not Collective
198e5c89e4eSSatish Balay 
199e5c89e4eSSatish Balay    Input Parameters:
200e5c89e4eSSatish Balay .  t - pointer to string
201e5c89e4eSSatish Balay 
202e5c89e4eSSatish Balay    Output Parameter:
203e5c89e4eSSatish Balay .  s - the copied string
204e5c89e4eSSatish Balay 
205e5c89e4eSSatish Balay    Level: intermediate
206e5c89e4eSSatish Balay 
2076f013253SBarry Smith    Notes:
208e5c89e4eSSatish Balay      Null string returns a string starting with zero
209e5c89e4eSSatish Balay 
2106f013253SBarry Smith      Not for use in Fortran
2116f013253SBarry Smith 
212e5c89e4eSSatish Balay   Concepts: string copy
213e5c89e4eSSatish Balay 
214e5c89e4eSSatish Balay .seealso: PetscStrncpy(), PetscStrcat(), PetscStrncat()
215e5c89e4eSSatish Balay 
216e5c89e4eSSatish Balay @*/
217acc6cc86SBarry Smith 
2187087cfbeSBarry Smith PetscErrorCode  PetscStrcpy(char s[],const char t[])
219e5c89e4eSSatish Balay {
220e5c89e4eSSatish Balay   PetscFunctionBegin;
22117186662SBarry Smith   if (t && !s) SETERRQ(PETSC_COMM_SELF,PETSC_ERR_ARG_NULL,"Trying to copy string into null pointer");
222e5c89e4eSSatish Balay   if (t) {strcpy(s,t);}
223e5c89e4eSSatish Balay   else if (s) {s[0] = 0;}
224e5c89e4eSSatish Balay   PetscFunctionReturn(0);
225e5c89e4eSSatish Balay }
226e5c89e4eSSatish Balay 
227e5c89e4eSSatish Balay #undef __FUNCT__
228e5c89e4eSSatish Balay #define __FUNCT__ "PetscStrncpy"
229e5c89e4eSSatish Balay /*@C
230e5c89e4eSSatish Balay    PetscStrncpy - Copies a string up to a certain length
231e5c89e4eSSatish Balay 
232e5c89e4eSSatish Balay    Not Collective
233e5c89e4eSSatish Balay 
234e5c89e4eSSatish Balay    Input Parameters:
235e5c89e4eSSatish Balay +  t - pointer to string
236e5c89e4eSSatish Balay -  n - the length to copy
237e5c89e4eSSatish Balay 
238e5c89e4eSSatish Balay    Output Parameter:
239e5c89e4eSSatish Balay .  s - the copied string
240e5c89e4eSSatish Balay 
241e5c89e4eSSatish Balay    Level: intermediate
242e5c89e4eSSatish Balay 
243e5c89e4eSSatish Balay    Note:
244e5c89e4eSSatish Balay      Null string returns a string starting with zero
245e5c89e4eSSatish Balay 
246e5c89e4eSSatish Balay   Concepts: string copy
247e5c89e4eSSatish Balay 
248e5c89e4eSSatish Balay .seealso: PetscStrcpy(), PetscStrcat(), PetscStrncat()
249e5c89e4eSSatish Balay 
250e5c89e4eSSatish Balay @*/
2517087cfbeSBarry Smith PetscErrorCode  PetscStrncpy(char s[],const char t[],size_t n)
252e5c89e4eSSatish Balay {
253e5c89e4eSSatish Balay   PetscFunctionBegin;
25417186662SBarry Smith   if (t && !s) SETERRQ(PETSC_COMM_SELF,PETSC_ERR_ARG_NULL,"Trying to copy string into null pointer");
255e5c89e4eSSatish Balay   if (t) {strncpy(s,t,n);}
256e5c89e4eSSatish Balay   else if (s) {s[0] = 0;}
257e5c89e4eSSatish Balay   PetscFunctionReturn(0);
258e5c89e4eSSatish Balay }
259e5c89e4eSSatish Balay 
260e5c89e4eSSatish Balay #undef __FUNCT__
261e5c89e4eSSatish Balay #define __FUNCT__ "PetscStrcat"
262e5c89e4eSSatish Balay /*@C
263e5c89e4eSSatish Balay    PetscStrcat - Concatenates a string onto a given string
264e5c89e4eSSatish Balay 
265e5c89e4eSSatish Balay    Not Collective
266e5c89e4eSSatish Balay 
267e5c89e4eSSatish Balay    Input Parameters:
268e5e2177aSMatthew Knepley +  s - string to be added to
269e5e2177aSMatthew Knepley -  t - pointer to string to be added to end
270e5c89e4eSSatish Balay 
271e5c89e4eSSatish Balay    Level: intermediate
272e5c89e4eSSatish Balay 
2736f013253SBarry Smith    Notes: Not for use in Fortran
2746f013253SBarry Smith 
275e5c89e4eSSatish Balay   Concepts: string copy
276e5c89e4eSSatish Balay 
277e5c89e4eSSatish Balay .seealso: PetscStrcpy(), PetscStrncpy(), PetscStrncat()
278e5c89e4eSSatish Balay 
279e5c89e4eSSatish Balay @*/
2807087cfbeSBarry Smith PetscErrorCode  PetscStrcat(char s[],const char t[])
281e5c89e4eSSatish Balay {
282e5c89e4eSSatish Balay   PetscFunctionBegin;
2839b754dc9SBarry Smith   if (!t) PetscFunctionReturn(0);
284e5c89e4eSSatish Balay   strcat(s,t);
285e5c89e4eSSatish Balay   PetscFunctionReturn(0);
286e5c89e4eSSatish Balay }
287e5c89e4eSSatish Balay 
288e5c89e4eSSatish Balay #undef __FUNCT__
289e5c89e4eSSatish Balay #define __FUNCT__ "PetscStrncat"
290e5c89e4eSSatish Balay /*@C
291e5c89e4eSSatish Balay    PetscStrncat - Concatenates a string onto a given string, up to a given length
292e5c89e4eSSatish Balay 
293e5c89e4eSSatish Balay    Not Collective
294e5c89e4eSSatish Balay 
295e5c89e4eSSatish Balay    Input Parameters:
296e5c89e4eSSatish Balay +  s - pointer to string to be added to end
297e5c89e4eSSatish Balay .  t - string to be added to
298e5c89e4eSSatish Balay .  n - maximum length to copy
299e5c89e4eSSatish Balay 
300e5c89e4eSSatish Balay    Level: intermediate
301e5c89e4eSSatish Balay 
3026f013253SBarry Smith   Notes:    Not for use in Fortran
3036f013253SBarry Smith 
304e5c89e4eSSatish Balay   Concepts: string copy
305e5c89e4eSSatish Balay 
306e5c89e4eSSatish Balay .seealso: PetscStrcpy(), PetscStrncpy(), PetscStrcat()
307e5c89e4eSSatish Balay 
308e5c89e4eSSatish Balay @*/
3097087cfbeSBarry Smith PetscErrorCode  PetscStrncat(char s[],const char t[],size_t n)
310e5c89e4eSSatish Balay {
311e5c89e4eSSatish Balay   PetscFunctionBegin;
312e5c89e4eSSatish Balay   strncat(s,t,n);
313e5c89e4eSSatish Balay   PetscFunctionReturn(0);
314e5c89e4eSSatish Balay }
315e5c89e4eSSatish Balay 
316e5c89e4eSSatish Balay #undef __FUNCT__
317e5c89e4eSSatish Balay #define __FUNCT__ "PetscStrcmp"
318e5c89e4eSSatish Balay /*@C
319e5c89e4eSSatish Balay    PetscStrcmp - Compares two strings,
320e5c89e4eSSatish Balay 
321e5c89e4eSSatish Balay    Not Collective
322e5c89e4eSSatish Balay 
323e5c89e4eSSatish Balay    Input Parameters:
324e5c89e4eSSatish Balay +  a - pointer to string first string
325e5c89e4eSSatish Balay -  b - pointer to second string
326e5c89e4eSSatish Balay 
327e5c89e4eSSatish Balay    Output Parameter:
328e5c89e4eSSatish Balay .  flg - if the two strings are equal
329e5c89e4eSSatish Balay 
330e5c89e4eSSatish Balay    Level: intermediate
331e5c89e4eSSatish Balay 
3326f013253SBarry Smith    Notes:    Not for use in Fortran
3336f013253SBarry Smith 
334e5c89e4eSSatish Balay .seealso: PetscStrgrt(), PetscStrncmp(), PetscStrcasecmp()
335e5c89e4eSSatish Balay 
336e5c89e4eSSatish Balay @*/
3377087cfbeSBarry Smith PetscErrorCode  PetscStrcmp(const char a[],const char b[],PetscBool  *flg)
338e5c89e4eSSatish Balay {
339e5c89e4eSSatish Balay   int c;
340e5c89e4eSSatish Balay 
341e5c89e4eSSatish Balay   PetscFunctionBegin;
342e5c89e4eSSatish Balay   if (!a && !b) {
343e5c89e4eSSatish Balay     *flg = PETSC_TRUE;
344e5c89e4eSSatish Balay   } else if (!a || !b) {
345e5c89e4eSSatish Balay     *flg = PETSC_FALSE;
346e5c89e4eSSatish Balay   } else {
347e5c89e4eSSatish Balay     c = strcmp(a,b);
348e5c89e4eSSatish Balay     if (c) *flg = PETSC_FALSE;
349e5c89e4eSSatish Balay     else   *flg = PETSC_TRUE;
350e5c89e4eSSatish Balay   }
351e5c89e4eSSatish Balay   PetscFunctionReturn(0);
352e5c89e4eSSatish Balay }
353e5c89e4eSSatish Balay 
354e5c89e4eSSatish Balay #undef __FUNCT__
355e5c89e4eSSatish Balay #define __FUNCT__ "PetscStrgrt"
356e5c89e4eSSatish Balay /*@C
357e5c89e4eSSatish Balay    PetscStrgrt - If first string is greater than the second
358e5c89e4eSSatish Balay 
359e5c89e4eSSatish Balay    Not Collective
360e5c89e4eSSatish Balay 
361e5c89e4eSSatish Balay    Input Parameters:
362e5c89e4eSSatish Balay +  a - pointer to first string
363e5c89e4eSSatish Balay -  b - pointer to second string
364e5c89e4eSSatish Balay 
365e5c89e4eSSatish Balay    Output Parameter:
366e5c89e4eSSatish Balay .  flg - if the first string is greater
367e5c89e4eSSatish Balay 
368e5c89e4eSSatish Balay    Notes:
369e5c89e4eSSatish Balay     Null arguments are ok, a null string is considered smaller than
370e5c89e4eSSatish Balay     all others
371e5c89e4eSSatish Balay 
3726f013253SBarry Smith    Not for use in Fortran
3736f013253SBarry Smith 
374e5c89e4eSSatish Balay    Level: intermediate
375e5c89e4eSSatish Balay 
376e5c89e4eSSatish Balay .seealso: PetscStrcmp(), PetscStrncmp(), PetscStrcasecmp()
377e5c89e4eSSatish Balay 
378e5c89e4eSSatish Balay @*/
3797087cfbeSBarry Smith PetscErrorCode  PetscStrgrt(const char a[],const char b[],PetscBool  *t)
380e5c89e4eSSatish Balay {
381e5c89e4eSSatish Balay   int c;
382e5c89e4eSSatish Balay 
383e5c89e4eSSatish Balay   PetscFunctionBegin;
384e5c89e4eSSatish Balay   if (!a && !b) {
385e5c89e4eSSatish Balay     *t = PETSC_FALSE;
386e5c89e4eSSatish Balay   } else if (a && !b) {
387e5c89e4eSSatish Balay     *t = PETSC_TRUE;
388e5c89e4eSSatish Balay   } else if (!a && b) {
389e5c89e4eSSatish Balay     *t = PETSC_FALSE;
390e5c89e4eSSatish Balay   } else {
391e5c89e4eSSatish Balay     c = strcmp(a,b);
392e5c89e4eSSatish Balay     if (c > 0) *t = PETSC_TRUE;
393e5c89e4eSSatish Balay     else       *t = PETSC_FALSE;
394e5c89e4eSSatish Balay   }
395e5c89e4eSSatish Balay   PetscFunctionReturn(0);
396e5c89e4eSSatish Balay }
397e5c89e4eSSatish Balay 
398e5c89e4eSSatish Balay #undef __FUNCT__
399e5c89e4eSSatish Balay #define __FUNCT__ "PetscStrcasecmp"
400e5c89e4eSSatish Balay /*@C
401e5c89e4eSSatish Balay    PetscStrcasecmp - Returns true if the two strings are the same
402e5c89e4eSSatish Balay      except possibly for case.
403e5c89e4eSSatish Balay 
404e5c89e4eSSatish Balay    Not Collective
405e5c89e4eSSatish Balay 
406e5c89e4eSSatish Balay    Input Parameters:
407e5c89e4eSSatish Balay +  a - pointer to first string
408e5c89e4eSSatish Balay -  b - pointer to second string
409e5c89e4eSSatish Balay 
410e5c89e4eSSatish Balay    Output Parameter:
411e5c89e4eSSatish Balay .  flg - if the two strings are the same
412e5c89e4eSSatish Balay 
413e5c89e4eSSatish Balay    Notes:
414e5c89e4eSSatish Balay     Null arguments are ok
415e5c89e4eSSatish Balay 
4166f013253SBarry Smith    Not for use in Fortran
4176f013253SBarry Smith 
418e5c89e4eSSatish Balay    Level: intermediate
419e5c89e4eSSatish Balay 
420e5c89e4eSSatish Balay .seealso: PetscStrcmp(), PetscStrncmp(), PetscStrgrt()
421e5c89e4eSSatish Balay 
422e5c89e4eSSatish Balay @*/
4237087cfbeSBarry Smith PetscErrorCode  PetscStrcasecmp(const char a[],const char b[],PetscBool  *t)
424e5c89e4eSSatish Balay {
425e5c89e4eSSatish Balay   int c;
426e5c89e4eSSatish Balay 
427e5c89e4eSSatish Balay   PetscFunctionBegin;
428e5c89e4eSSatish Balay   if (!a && !b) c = 0;
429e5c89e4eSSatish Balay   else if (!a || !b) c = 1;
43032b366c8SSatish Balay #if defined(PETSC_HAVE_STRCASECMP)
43132b366c8SSatish Balay   else c = strcasecmp(a,b);
43232b366c8SSatish Balay #elif defined(PETSC_HAVE_STRICMP)
433e5c89e4eSSatish Balay   else c = stricmp(a,b);
434e5c89e4eSSatish Balay #else
43532b366c8SSatish Balay   else {
43632b366c8SSatish Balay     char *aa,*bb;
43732b366c8SSatish Balay     PetscErrorCode ierr;
43832b366c8SSatish Balay     ierr = PetscStrallocpy(a,&aa);CHKERRQ(ierr);
43932b366c8SSatish Balay     ierr = PetscStrallocpy(b,&bb);CHKERRQ(ierr);
44032b366c8SSatish Balay     ierr = PetscStrtolower(aa);CHKERRQ(ierr);
44132b366c8SSatish Balay     ierr = PetscStrtolower(bb);CHKERRQ(ierr);
44232b366c8SSatish Balay     ierr = PetscStrcmp(aa,bb,t);CHKERRQ(ierr);
443503cfb0cSBarry Smith     ierr = PetscFree(aa);CHKERRQ(ierr);
444503cfb0cSBarry Smith     ierr = PetscFree(bb);CHKERRQ(ierr);
44532b366c8SSatish Balay     PetscFunctionReturn(0);
44632b366c8SSatish Balay   }
447e5c89e4eSSatish Balay #endif
448e5c89e4eSSatish Balay   if (!c) *t = PETSC_TRUE;
449e5c89e4eSSatish Balay   else    *t = PETSC_FALSE;
450e5c89e4eSSatish Balay   PetscFunctionReturn(0);
451e5c89e4eSSatish Balay }
452e5c89e4eSSatish Balay 
45332b366c8SSatish Balay 
45432b366c8SSatish Balay 
455e5c89e4eSSatish Balay #undef __FUNCT__
456e5c89e4eSSatish Balay #define __FUNCT__ "PetscStrncmp"
457e5c89e4eSSatish Balay /*@C
458e5c89e4eSSatish Balay    PetscStrncmp - Compares two strings, up to a certain length
459e5c89e4eSSatish Balay 
460e5c89e4eSSatish Balay    Not Collective
461e5c89e4eSSatish Balay 
462e5c89e4eSSatish Balay    Input Parameters:
463e5c89e4eSSatish Balay +  a - pointer to first string
464e5c89e4eSSatish Balay .  b - pointer to second string
465e5c89e4eSSatish Balay -  n - length to compare up to
466e5c89e4eSSatish Balay 
467e5c89e4eSSatish Balay    Output Parameter:
468e5c89e4eSSatish Balay .  t - if the two strings are equal
469e5c89e4eSSatish Balay 
470e5c89e4eSSatish Balay    Level: intermediate
471e5c89e4eSSatish Balay 
4726f013253SBarry Smith    Notes:    Not for use in Fortran
4736f013253SBarry Smith 
474e5c89e4eSSatish Balay .seealso: PetscStrgrt(), PetscStrcmp(), PetscStrcasecmp()
475e5c89e4eSSatish Balay 
476e5c89e4eSSatish Balay @*/
4777087cfbeSBarry Smith PetscErrorCode  PetscStrncmp(const char a[],const char b[],size_t n,PetscBool  *t)
478e5c89e4eSSatish Balay {
479e5c89e4eSSatish Balay   int c;
480e5c89e4eSSatish Balay 
481e5c89e4eSSatish Balay   PetscFunctionBegin;
482e5c89e4eSSatish Balay   c = strncmp(a,b,n);
483e5c89e4eSSatish Balay   if (!c) *t = PETSC_TRUE;
484e5c89e4eSSatish Balay   else    *t = PETSC_FALSE;
485e5c89e4eSSatish Balay   PetscFunctionReturn(0);
486e5c89e4eSSatish Balay }
487e5c89e4eSSatish Balay 
488e5c89e4eSSatish Balay #undef __FUNCT__
489e5c89e4eSSatish Balay #define __FUNCT__ "PetscStrchr"
490e5c89e4eSSatish Balay /*@C
491e5c89e4eSSatish Balay    PetscStrchr - Locates first occurance of a character in a string
492e5c89e4eSSatish Balay 
493e5c89e4eSSatish Balay    Not Collective
494e5c89e4eSSatish Balay 
495e5c89e4eSSatish Balay    Input Parameters:
496e5c89e4eSSatish Balay +  a - pointer to string
497e5c89e4eSSatish Balay -  b - character
498e5c89e4eSSatish Balay 
499e5c89e4eSSatish Balay    Output Parameter:
500e5c89e4eSSatish Balay .  c - location of occurance, PETSC_NULL if not found
501e5c89e4eSSatish Balay 
502e5c89e4eSSatish Balay    Level: intermediate
503e5c89e4eSSatish Balay 
5046f013253SBarry Smith    Notes:    Not for use in Fortran
5056f013253SBarry Smith 
506e5c89e4eSSatish Balay @*/
5077087cfbeSBarry Smith PetscErrorCode  PetscStrchr(const char a[],char b,char *c[])
508e5c89e4eSSatish Balay {
509e5c89e4eSSatish Balay   PetscFunctionBegin;
510e5c89e4eSSatish Balay   *c = (char *)strchr(a,b);
511e5c89e4eSSatish Balay   PetscFunctionReturn(0);
512e5c89e4eSSatish Balay }
513e5c89e4eSSatish Balay 
514e5c89e4eSSatish Balay #undef __FUNCT__
515e5c89e4eSSatish Balay #define __FUNCT__ "PetscStrrchr"
516e5c89e4eSSatish Balay /*@C
517e5c89e4eSSatish Balay    PetscStrrchr - Locates one location past the last occurance of a character in a string,
518e5c89e4eSSatish Balay       if the character is not found then returns entire string
519e5c89e4eSSatish Balay 
520e5c89e4eSSatish Balay    Not Collective
521e5c89e4eSSatish Balay 
522e5c89e4eSSatish Balay    Input Parameters:
523e5c89e4eSSatish Balay +  a - pointer to string
524e5c89e4eSSatish Balay -  b - character
525e5c89e4eSSatish Balay 
526e5c89e4eSSatish Balay    Output Parameter:
527e5c89e4eSSatish Balay .  tmp - location of occurance, a if not found
528e5c89e4eSSatish Balay 
529e5c89e4eSSatish Balay    Level: intermediate
530e5c89e4eSSatish Balay 
5316f013253SBarry Smith    Notes:    Not for use in Fortran
5326f013253SBarry Smith 
533e5c89e4eSSatish Balay @*/
5347087cfbeSBarry Smith PetscErrorCode  PetscStrrchr(const char a[],char b,char *tmp[])
535e5c89e4eSSatish Balay {
536e5c89e4eSSatish Balay   PetscFunctionBegin;
537e5c89e4eSSatish Balay   *tmp = (char *)strrchr(a,b);
538e5c89e4eSSatish Balay   if (!*tmp) *tmp = (char*)a; else *tmp = *tmp + 1;
539e5c89e4eSSatish Balay   PetscFunctionReturn(0);
540e5c89e4eSSatish Balay }
541e5c89e4eSSatish Balay 
542e5c89e4eSSatish Balay #undef __FUNCT__
543e5c89e4eSSatish Balay #define __FUNCT__ "PetscStrtolower"
544e5c89e4eSSatish Balay /*@C
545e5c89e4eSSatish Balay    PetscStrtolower - Converts string to lower case
546e5c89e4eSSatish Balay 
547e5c89e4eSSatish Balay    Not Collective
548e5c89e4eSSatish Balay 
549e5c89e4eSSatish Balay    Input Parameters:
550e5c89e4eSSatish Balay .  a - pointer to string
551e5c89e4eSSatish Balay 
552e5c89e4eSSatish Balay    Level: intermediate
553e5c89e4eSSatish Balay 
5546f013253SBarry Smith    Notes:    Not for use in Fortran
5556f013253SBarry Smith 
556e5c89e4eSSatish Balay @*/
5577087cfbeSBarry Smith PetscErrorCode  PetscStrtolower(char a[])
558e5c89e4eSSatish Balay {
559e5c89e4eSSatish Balay   PetscFunctionBegin;
560e5c89e4eSSatish Balay   while (*a) {
561e5c89e4eSSatish Balay     if (*a >= 'A' && *a <= 'Z') *a += 'a' - 'A';
562e5c89e4eSSatish Balay     a++;
563e5c89e4eSSatish Balay   }
564e5c89e4eSSatish Balay   PetscFunctionReturn(0);
565e5c89e4eSSatish Balay }
566e5c89e4eSSatish Balay 
5671d1a0024SBarry Smith struct _p_PetscToken {char token;char *array;char *current;};
5681d1a0024SBarry Smith 
5691d1a0024SBarry Smith 
570e5c89e4eSSatish Balay #undef __FUNCT__
571e5c89e4eSSatish Balay #define __FUNCT__ "PetscTokenFind"
572e5c89e4eSSatish Balay /*@C
573e5c89e4eSSatish Balay    PetscTokenFind - Locates next "token" in a string
574e5c89e4eSSatish Balay 
575e5c89e4eSSatish Balay    Not Collective
576e5c89e4eSSatish Balay 
577e5c89e4eSSatish Balay    Input Parameters:
578e5c89e4eSSatish Balay .  a - pointer to token
579e5c89e4eSSatish Balay 
580e5c89e4eSSatish Balay    Output Parameter:
581e5c89e4eSSatish Balay .  result - location of occurance, PETSC_NULL if not found
582e5c89e4eSSatish Balay 
583e5c89e4eSSatish Balay    Notes:
584e5c89e4eSSatish Balay 
585e5c89e4eSSatish Balay      This version is different from the system version in that
586e5c89e4eSSatish Balay   it allows you to pass a read-only string into the function.
587e5c89e4eSSatish Balay 
5884704e885SBarry Smith      This version also treats all characters etc. inside a double quote "
5894704e885SBarry Smith    as a single token.
5904704e885SBarry Smith 
5916f013253SBarry Smith     Not for use in Fortran
5926f013253SBarry Smith 
593e5c89e4eSSatish Balay    Level: intermediate
594e5c89e4eSSatish Balay 
5956f013253SBarry Smith 
596e5c89e4eSSatish Balay .seealso: PetscTokenCreate(), PetscTokenDestroy()
597e5c89e4eSSatish Balay @*/
5987087cfbeSBarry Smith PetscErrorCode  PetscTokenFind(PetscToken a,char *result[])
599e5c89e4eSSatish Balay {
6004704e885SBarry Smith   char *ptr = a->current,token;
601e5c89e4eSSatish Balay 
602e5c89e4eSSatish Balay   PetscFunctionBegin;
603e5c89e4eSSatish Balay   *result = a->current;
6044704e885SBarry Smith   if (ptr && !*ptr) {*result = 0;PetscFunctionReturn(0);}
6054704e885SBarry Smith   token = a->token;
60690fdf44cSMatthew Knepley   if (ptr && (*ptr == '"')) {token = '"';(*result)++;ptr++;}
607e5c89e4eSSatish Balay   while (ptr) {
6084704e885SBarry Smith     if (*ptr == token) {
609e5c89e4eSSatish Balay       *ptr++ = 0;
610e5c89e4eSSatish Balay       while (*ptr == a->token) ptr++;
611e5c89e4eSSatish Balay       a->current = ptr;
612e5c89e4eSSatish Balay       break;
613e5c89e4eSSatish Balay     }
614e5c89e4eSSatish Balay     if (!*ptr) {
615e5c89e4eSSatish Balay       a->current = 0;
616e5c89e4eSSatish Balay       break;
617e5c89e4eSSatish Balay     }
618e5c89e4eSSatish Balay     ptr++;
619e5c89e4eSSatish Balay   }
620e5c89e4eSSatish Balay   PetscFunctionReturn(0);
621e5c89e4eSSatish Balay }
622e5c89e4eSSatish Balay 
623e5c89e4eSSatish Balay #undef __FUNCT__
624e5c89e4eSSatish Balay #define __FUNCT__ "PetscTokenCreate"
625e5c89e4eSSatish Balay /*@C
626e5c89e4eSSatish Balay    PetscTokenCreate - Creates a PetscToken used to find tokens in a string
627e5c89e4eSSatish Balay 
628e5c89e4eSSatish Balay    Not Collective
629e5c89e4eSSatish Balay 
630e5c89e4eSSatish Balay    Input Parameters:
631e5c89e4eSSatish Balay +  string - the string to look in
632e5c89e4eSSatish Balay -  token - the character to look for
633e5c89e4eSSatish Balay 
634e5c89e4eSSatish Balay    Output Parameter:
635e5c89e4eSSatish Balay .  a - pointer to token
636e5c89e4eSSatish Balay 
637e5c89e4eSSatish Balay    Notes:
638e5c89e4eSSatish Balay 
639e5c89e4eSSatish Balay      This version is different from the system version in that
640e5c89e4eSSatish Balay   it allows you to pass a read-only string into the function.
641e5c89e4eSSatish Balay 
6426f013253SBarry Smith     Not for use in Fortran
6436f013253SBarry Smith 
644e5c89e4eSSatish Balay    Level: intermediate
645e5c89e4eSSatish Balay 
646e5c89e4eSSatish Balay .seealso: PetscTokenFind(), PetscTokenDestroy()
647e5c89e4eSSatish Balay @*/
6487087cfbeSBarry Smith PetscErrorCode  PetscTokenCreate(const char a[],const char b,PetscToken *t)
649e5c89e4eSSatish Balay {
650e5c89e4eSSatish Balay   PetscErrorCode ierr;
651e5c89e4eSSatish Balay 
652e5c89e4eSSatish Balay   PetscFunctionBegin;
6531d1a0024SBarry Smith   ierr = PetscNew(struct _p_PetscToken,t);CHKERRQ(ierr);
654e5c89e4eSSatish Balay   ierr = PetscStrallocpy(a,&(*t)->array);CHKERRQ(ierr);
655e5c89e4eSSatish Balay   (*t)->current = (*t)->array;
656e5c89e4eSSatish Balay   (*t)->token   = b;
657e5c89e4eSSatish Balay   PetscFunctionReturn(0);
658e5c89e4eSSatish Balay }
659e5c89e4eSSatish Balay 
660e5c89e4eSSatish Balay #undef __FUNCT__
661e5c89e4eSSatish Balay #define __FUNCT__ "PetscTokenDestroy"
662e5c89e4eSSatish Balay /*@C
663e5c89e4eSSatish Balay    PetscTokenDestroy - Destroys a PetscToken
664e5c89e4eSSatish Balay 
665e5c89e4eSSatish Balay    Not Collective
666e5c89e4eSSatish Balay 
667e5c89e4eSSatish Balay    Input Parameters:
668e5c89e4eSSatish Balay .  a - pointer to token
669e5c89e4eSSatish Balay 
670e5c89e4eSSatish Balay    Level: intermediate
671e5c89e4eSSatish Balay 
6726f013253SBarry Smith    Notes:     Not for use in Fortran
6736f013253SBarry Smith 
674e5c89e4eSSatish Balay .seealso: PetscTokenCreate(), PetscTokenFind()
675e5c89e4eSSatish Balay @*/
6767087cfbeSBarry Smith PetscErrorCode  PetscTokenDestroy(PetscToken a)
677e5c89e4eSSatish Balay {
678e5c89e4eSSatish Balay   PetscErrorCode ierr;
679e5c89e4eSSatish Balay 
680e5c89e4eSSatish Balay   PetscFunctionBegin;
681e5c89e4eSSatish Balay   ierr = PetscFree(a->array);CHKERRQ(ierr);
682e5c89e4eSSatish Balay   ierr = PetscFree(a);CHKERRQ(ierr);
683e5c89e4eSSatish Balay   PetscFunctionReturn(0);
684e5c89e4eSSatish Balay }
685e5c89e4eSSatish Balay 
686e5c89e4eSSatish Balay #undef __FUNCT__
687e5c89e4eSSatish Balay #define __FUNCT__ "PetscStrrstr"
688e5c89e4eSSatish Balay /*@C
689e5c89e4eSSatish Balay    PetscStrrstr - Locates last occurance of string in another string
690e5c89e4eSSatish Balay 
691e5c89e4eSSatish Balay    Not Collective
692e5c89e4eSSatish Balay 
693e5c89e4eSSatish Balay    Input Parameters:
694e5c89e4eSSatish Balay +  a - pointer to string
695e5c89e4eSSatish Balay -  b - string to find
696e5c89e4eSSatish Balay 
697e5c89e4eSSatish Balay    Output Parameter:
698e5c89e4eSSatish Balay .  tmp - location of occurance
699e5c89e4eSSatish Balay 
7006f013253SBarry Smith    Notes:     Not for use in Fortran
7016f013253SBarry Smith 
702e5c89e4eSSatish Balay    Level: intermediate
703e5c89e4eSSatish Balay 
704e5c89e4eSSatish Balay @*/
7057087cfbeSBarry Smith PetscErrorCode  PetscStrrstr(const char a[],const char b[],char *tmp[])
706e5c89e4eSSatish Balay {
707e5c89e4eSSatish Balay   const char *stmp = a, *ltmp = 0;
708e5c89e4eSSatish Balay 
709e5c89e4eSSatish Balay   PetscFunctionBegin;
710e5c89e4eSSatish Balay   while (stmp) {
711e5c89e4eSSatish Balay     stmp = (char *)strstr(stmp,b);
712e5c89e4eSSatish Balay     if (stmp) {ltmp = stmp;stmp++;}
713e5c89e4eSSatish Balay   }
714e5c89e4eSSatish Balay   *tmp = (char *)ltmp;
715e5c89e4eSSatish Balay   PetscFunctionReturn(0);
716e5c89e4eSSatish Balay }
717e5c89e4eSSatish Balay 
718e5c89e4eSSatish Balay #undef __FUNCT__
719e5c89e4eSSatish Balay #define __FUNCT__ "PetscStrstr"
720e5c89e4eSSatish Balay /*@C
721e5c89e4eSSatish Balay    PetscStrstr - Locates first occurance of string in another string
722e5c89e4eSSatish Balay 
723e5c89e4eSSatish Balay    Not Collective
724e5c89e4eSSatish Balay 
725e5c89e4eSSatish Balay    Input Parameters:
726e5c89e4eSSatish Balay +  a - pointer to string
727e5c89e4eSSatish Balay -  b - string to find
728e5c89e4eSSatish Balay 
729e5c89e4eSSatish Balay    Output Parameter:
7308c0f1137SBarry Smith .  tmp - location of occurance, is a PETSC_NULL if the string is not found
731e5c89e4eSSatish Balay 
7326f013253SBarry Smith    Notes: Not for use in Fortran
7336f013253SBarry Smith 
734e5c89e4eSSatish Balay    Level: intermediate
735e5c89e4eSSatish Balay 
736e5c89e4eSSatish Balay @*/
7377087cfbeSBarry Smith PetscErrorCode  PetscStrstr(const char a[],const char b[],char *tmp[])
738e5c89e4eSSatish Balay {
739e5c89e4eSSatish Balay   PetscFunctionBegin;
740e5c89e4eSSatish Balay   *tmp = (char *)strstr(a,b);
741e5c89e4eSSatish Balay   PetscFunctionReturn(0);
742e5c89e4eSSatish Balay }
743e5c89e4eSSatish Balay 
744e5c89e4eSSatish Balay #undef __FUNCT__
745e5c89e4eSSatish Balay #define __FUNCT__ "PetscGetPetscDir"
746e5c89e4eSSatish Balay /*@C
747e5c89e4eSSatish Balay    PetscGetPetscDir - Gets the directory PETSc is installed in
748e5c89e4eSSatish Balay 
749e5c89e4eSSatish Balay    Not Collective
750e5c89e4eSSatish Balay 
751e5c89e4eSSatish Balay    Output Parameter:
752e5c89e4eSSatish Balay .  dir - the directory
753e5c89e4eSSatish Balay 
754e5c89e4eSSatish Balay    Level: developer
755e5c89e4eSSatish Balay 
7566f013253SBarry Smith    Notes: Not for use in Fortran
7576f013253SBarry Smith 
758e5c89e4eSSatish Balay @*/
7597087cfbeSBarry Smith PetscErrorCode  PetscGetPetscDir(const char *dir[])
760e5c89e4eSSatish Balay {
761e5c89e4eSSatish Balay   PetscFunctionBegin;
762e5c89e4eSSatish Balay   *dir = PETSC_DIR;
763e5c89e4eSSatish Balay   PetscFunctionReturn(0);
764e5c89e4eSSatish Balay }
765e5c89e4eSSatish Balay 
766e5c89e4eSSatish Balay #undef __FUNCT__
767e5c89e4eSSatish Balay #define __FUNCT__ "PetscStrreplace"
768e5c89e4eSSatish Balay /*@C
769e5c89e4eSSatish Balay    PetscStrreplace - Replaces substrings in string with other substrings
770e5c89e4eSSatish Balay 
771e5c89e4eSSatish Balay    Not Collective
772e5c89e4eSSatish Balay 
773e5c89e4eSSatish Balay    Input Parameters:
774e5c89e4eSSatish Balay +   comm - MPI_Comm of processors that are processing the string
77571573d7dSBarry Smith .   aa - the string to look in
776d8ccf1fbSBarry Smith .   b - the resulting copy of a with replaced strings (b can be the same as a)
777e5c89e4eSSatish Balay -   len - the length of b
778e5c89e4eSSatish Balay 
779e5c89e4eSSatish Balay    Notes:
780e5c89e4eSSatish Balay       Replaces   ${PETSC_ARCH},${PETSC_DIR},${PETSC_LIB_DIR},${DISPLAY},
781d5649816SBarry Smith       ${HOMEDIRECTORY},${WORKINGDIRECTORY},${USERNAME}, ${HOSTNAME} with appropriate values
782e5c89e4eSSatish Balay       as well as any environmental variables.
783e5c89e4eSSatish Balay 
7846f013253SBarry Smith       PETSC_LIB_DIR uses the environmental variable if it exists. PETSC_ARCH and PETSC_DIR use what
785acc6cc86SBarry Smith       PETSc was built with and do not use environmental variables.
786acc6cc86SBarry Smith 
7876f013253SBarry Smith       Not for use in Fortran
7886f013253SBarry Smith 
789e5c89e4eSSatish Balay    Level: intermediate
790e5c89e4eSSatish Balay 
791e5c89e4eSSatish Balay @*/
7927087cfbeSBarry Smith PetscErrorCode  PetscStrreplace(MPI_Comm comm,const char aa[],char b[],size_t len)
793e5c89e4eSSatish Balay {
794e5c89e4eSSatish Balay   PetscErrorCode ierr;
795e5c89e4eSSatish Balay   int            i = 0;
796e5c89e4eSSatish Balay   size_t         l,l1,l2,l3;
79771573d7dSBarry Smith   char           *work,*par,*epar,env[1024],*tfree,*a = (char*)aa;
798d5649816SBarry Smith   const char     *s[] = {"${PETSC_ARCH}","${PETSC_DIR}","${PETSC_LIB_DIR}","${DISPLAY}","${HOMEDIRECTORY}","${WORKINGDIRECTORY}","${USERNAME}","${HOSTNAME}",0};
799d5649816SBarry Smith   const char     *r[] = {0,0,0,0,0,0,0,0,0};
800ace3abfcSBarry Smith   PetscBool      flag;
801e5c89e4eSSatish Balay 
802e5c89e4eSSatish Balay   PetscFunctionBegin;
803e32f2f54SBarry Smith   if (!a || !b) SETERRQ(PETSC_COMM_SELF,PETSC_ERR_ARG_NULL,"a and b strings must be nonnull");
80471573d7dSBarry Smith   if (aa == b) {
80522982a5fSBarry Smith     ierr    = PetscStrallocpy(aa,(char **)&a);CHKERRQ(ierr);
80671573d7dSBarry Smith   }
807e5c89e4eSSatish Balay   ierr = PetscMalloc(len*sizeof(char*),&work);CHKERRQ(ierr);
808e5c89e4eSSatish Balay 
809e5c89e4eSSatish Balay   /* get values for replaced variables */
810487e5849SBarry Smith   ierr = PetscStrallocpy(PETSC_ARCH,(char**)&r[0]);CHKERRQ(ierr);
811487e5849SBarry Smith   ierr = PetscStrallocpy(PETSC_DIR,(char**)&r[1]);CHKERRQ(ierr);
812487e5849SBarry Smith   ierr = PetscStrallocpy(PETSC_LIB_DIR,(char**)&r[2]);CHKERRQ(ierr);
813487e5849SBarry Smith   ierr = PetscMalloc(256*sizeof(char),&r[3]);CHKERRQ(ierr);
814487e5849SBarry Smith   ierr = PetscMalloc(PETSC_MAX_PATH_LEN*sizeof(char),&r[4]);CHKERRQ(ierr);
815e5c89e4eSSatish Balay   ierr = PetscMalloc(PETSC_MAX_PATH_LEN*sizeof(char),&r[5]);CHKERRQ(ierr);
816487e5849SBarry Smith   ierr = PetscMalloc(256*sizeof(char),&r[6]);CHKERRQ(ierr);
817d5649816SBarry Smith   ierr = PetscMalloc(256*sizeof(char),&r[7]);CHKERRQ(ierr);
818487e5849SBarry Smith   ierr = PetscGetDisplay((char*)r[3],256);CHKERRQ(ierr);
819487e5849SBarry Smith   ierr = PetscGetHomeDirectory((char*)r[4],PETSC_MAX_PATH_LEN);CHKERRQ(ierr);
820487e5849SBarry Smith   ierr = PetscGetWorkingDirectory((char*)r[5],PETSC_MAX_PATH_LEN);CHKERRQ(ierr);
821487e5849SBarry Smith   ierr = PetscGetUserName((char*)r[6],256);CHKERRQ(ierr);
822d5649816SBarry Smith   ierr = PetscGetHostName((char*)r[7],256);CHKERRQ(ierr);
823487e5849SBarry Smith 
824487e5849SBarry Smith   /* replace that are in environment */
825487e5849SBarry Smith   ierr = PetscOptionsGetenv(comm,"PETSC_LIB_DIR",env,1024,&flag);CHKERRQ(ierr);
826487e5849SBarry Smith   if (flag) {
827487e5849SBarry Smith     ierr = PetscStrallocpy(env,(char**)&r[2]);CHKERRQ(ierr);
828487e5849SBarry Smith   }
829e5c89e4eSSatish Balay 
830e5c89e4eSSatish Balay   /* replace the requested strings */
831e5c89e4eSSatish Balay   ierr = PetscStrncpy(b,a,len);CHKERRQ(ierr);
832e5c89e4eSSatish Balay   while (s[i]) {
833e5c89e4eSSatish Balay     ierr = PetscStrlen(s[i],&l);CHKERRQ(ierr);
834e5c89e4eSSatish Balay     ierr = PetscStrstr(b,s[i],&par);CHKERRQ(ierr);
835e5c89e4eSSatish Balay     while (par) {
836e5c89e4eSSatish Balay       *par  =  0;
837e5c89e4eSSatish Balay       par  += l;
838e5c89e4eSSatish Balay 
839e5c89e4eSSatish Balay       ierr = PetscStrlen(b,&l1);CHKERRQ(ierr);
840e5c89e4eSSatish Balay       ierr = PetscStrlen(r[i],&l2);CHKERRQ(ierr);
841e5c89e4eSSatish Balay       ierr = PetscStrlen(par,&l3);CHKERRQ(ierr);
84217186662SBarry Smith       if (l1 + l2 + l3 >= len) SETERRQ(PETSC_COMM_SELF,PETSC_ERR_ARG_SIZ,"b len is not long enough to hold new values");
843e5c89e4eSSatish Balay       ierr  = PetscStrcpy(work,b);CHKERRQ(ierr);
844e5c89e4eSSatish Balay       ierr  = PetscStrcat(work,r[i]);CHKERRQ(ierr);
845e5c89e4eSSatish Balay       ierr  = PetscStrcat(work,par);CHKERRQ(ierr);
846e5c89e4eSSatish Balay       ierr  = PetscStrncpy(b,work,len);CHKERRQ(ierr);
847e5c89e4eSSatish Balay       ierr  = PetscStrstr(b,s[i],&par);CHKERRQ(ierr);
848e5c89e4eSSatish Balay     }
849e5c89e4eSSatish Balay     i++;
850e5c89e4eSSatish Balay   }
851487e5849SBarry Smith   i = 0;
852487e5849SBarry Smith   while (r[i]) {
853e5c89e4eSSatish Balay     tfree = (char*)r[i];
854e5c89e4eSSatish Balay     ierr = PetscFree(tfree);CHKERRQ(ierr);
855487e5849SBarry Smith     i++;
856e5c89e4eSSatish Balay   }
857e5c89e4eSSatish Balay 
858e5c89e4eSSatish Balay   /* look for any other ${xxx} strings to replace from environmental variables */
859e5c89e4eSSatish Balay   ierr = PetscStrstr(b,"${",&par);CHKERRQ(ierr);
860e5c89e4eSSatish Balay   while (par) {
861e5c89e4eSSatish Balay     *par = 0;
862e5c89e4eSSatish Balay     par += 2;
863e5c89e4eSSatish Balay     ierr  = PetscStrcpy(work,b);CHKERRQ(ierr);
864e5c89e4eSSatish Balay     ierr = PetscStrstr(par,"}",&epar);CHKERRQ(ierr);
865e5c89e4eSSatish Balay     *epar = 0;
866e5c89e4eSSatish Balay     epar += 1;
867e5c89e4eSSatish Balay     ierr = PetscOptionsGetenv(comm,par,env,256,&flag);CHKERRQ(ierr);
868e5c89e4eSSatish Balay     if (!flag) {
869e32f2f54SBarry Smith       SETERRQ1(PETSC_COMM_SELF,PETSC_ERR_ARG_WRONG,"Substitution string ${%s} not found as environmental variable",par);
870e5c89e4eSSatish Balay     }
871e5c89e4eSSatish Balay     ierr = PetscStrcat(work,env);CHKERRQ(ierr);
872e5c89e4eSSatish Balay     ierr = PetscStrcat(work,epar);CHKERRQ(ierr);
873e5c89e4eSSatish Balay     ierr = PetscStrcpy(b,work);CHKERRQ(ierr);
874e5c89e4eSSatish Balay     ierr = PetscStrstr(b,"${",&par);CHKERRQ(ierr);
875e5c89e4eSSatish Balay   }
876e5c89e4eSSatish Balay   ierr = PetscFree(work);CHKERRQ(ierr);
87771573d7dSBarry Smith   if (aa == b) {
87871573d7dSBarry Smith     ierr = PetscFree(a);CHKERRQ(ierr);
87971573d7dSBarry Smith   }
880e5c89e4eSSatish Balay   PetscFunctionReturn(0);
881e5c89e4eSSatish Balay }
882e5c89e4eSSatish Balay 
883e5c89e4eSSatish Balay 
884