Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
INSTR(3)		      MBK UTILITY FUNCTIONS			INSTR(3)

NAME
     instr - find an occurrence of a string in a string, starting at a specified
     character.

SYNOPSIS
     #include "mut.h"
     char *instr(s, find, from)
     char *s, *find, from;

PARAMETERS
     s			 Pointer to the string to be searched for the pattern

     find		 Pointer to the string to be found, the pattern

     from		 Character to be searched backwards before searching for
			 the pattern

DESCRIPTION
     instr  searches  the  first  occurrence of the string find in the string s,
     starting its search at the last occurrence of the	from  character  in  the
     string s.

     If  either  s  or	find  is  NULL,  the  function returns NULL.  If from is
     (char)0, the pattern is searched from the beginning of s.
     This quite exotic behaviour is useful to search the occurrence of a name in
     a string resulting from a flatten, when only a terminal object name  is  to
     be taken into account.

RETURN VALUES
     instr return NULL either if the pattern find is not present in the searched
     string  s, or if one at least of these two string are NULL.  If the pattern
     is found, a value different from NULL is returned.

EXAMPLE
     #include "mut.h"
     /* check for the pattern 'ck' anywhere in the string */
     #define contains_ck(name)instr(name, "ck", ' ')
     /* check for the pattern 'ck' in the signal name, not instance ones */
     #define isclock(ptsig) instr(getsigname(ptsig), "ck", SEPAR)

SEE ALSO
     mbk(1), isvdd(3), isvss(3).

ASIM/LIP6			 October 1, 1997			INSTR(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=instr&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help