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

FreeBSD Manual Pages

  
 
  

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

NAME
       instr - find an occurrence of a string in a string, starting at a spec-
       ified 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 pat-
			   tern

       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.0>

home | help