ansistring.html

Vxworks API操作系统和驱动程序设计API。压缩的HTML文件

</blockquote><h4>RETURNS</h4><blockquote><p>
A pointer to <i>s1</i>.
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./ansiString.html#top">ansiString</a></b>

<hr>
<a name="strpbrk"></a>
<p align=right>
<a href="rtnIndex.htm"><i>OS Libraries :  Routines</i></a></p>

</blockquote><h1>strpbrk(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>strpbrk(&nbsp;)</strong> - find the first occurrence in a string of a character from a given set (ANSI)</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>char * strpbrk
    (
    const char * s1,          /* string to search */
    const char * s2           /* set of characters to look for in <i>s1</i> */
    )
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine locates the first occurrence in string <i>s1</i> of any character
from string <i>s2</i>.
<p>
</blockquote><h4>INCLUDE FILES</h4><blockquote><p>
<b>string.h</b>
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
<p>
A pointer to the character found in <i>s1</i>, or
NULL if no character from <i>s2</i> occurs in <i>s1</i>.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./ansiString.html#top">ansiString</a></b>, <b><a href="./ansiString.html#strcspn">strcspn</a>(&nbsp;)</b>

<hr>
<a name="strrchr"></a>
<p align=right>
<a href="rtnIndex.htm"><i>OS Libraries :  Routines</i></a></p>

</blockquote><h1>strrchr(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>strrchr(&nbsp;)</strong> - find the last occurrence of a character in a string (ANSI)</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>char * strrchr
    (
    const char * s,           /* string to search */
    int          c            /* character to look for */
    )
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine locates the last occurrence of <i>c</i> in the string pointed
to by <i>s</i>.  The terminating null is considered to be part of the string.
<p>
</blockquote><h4>INCLUDE FILES</h4><blockquote><p>
<b>string.h</b>
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
<p>
A pointer to the last occurrence of the character, or
NULL if the character is not found.
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./ansiString.html#top">ansiString</a></b>

<hr>
<a name="strspn"></a>
<p align=right>
<a href="rtnIndex.htm"><i>OS Libraries :  Routines</i></a></p>

</blockquote><h1>strspn(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>strspn(&nbsp;)</strong> - return the string length up to the first character not in a given set (ANSI)</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>size_t strspn
    (
    const char * s,           /* string to search */
    const char * sep          /* set of characters to look for in <i>s</i> */
    )
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine computes the length of the maximum initial segment of
string <i>s</i> that consists entirely of characters from the string <i>sep</i>.
<p>
</blockquote><h4>INCLUDE FILES</h4><blockquote><p>
<b>string.h</b>
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
<p>
The length of the string segment.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./ansiString.html#top">ansiString</a></b>, <b><a href="./ansiString.html#strcspn">strcspn</a>(&nbsp;)</b>

<hr>
<a name="strstr"></a>
<p align=right>
<a href="rtnIndex.htm"><i>OS Libraries :  Routines</i></a></p>

</blockquote><h1>strstr(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>strstr(&nbsp;)</strong> - find the first occurrence of a substring in a string (ANSI)</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>char * strstr
    (
    const char * s,           /* string to search */
    const char * find         /* substring to look for */
    )
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine locates the first occurrence in string <i>s</i>
of the sequence of characters (excluding the terminating null character)
in the string <i>find</i>.
<p>
</blockquote><h4>INCLUDE FILES</h4><blockquote><p>
<b>string.h</b>
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
<p>
A pointer to the located substring, or <i>s</i> if <i>find</i> points to a
zero-length string, or NULL if the string is not found.
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./ansiString.html#top">ansiString</a></b>

<hr>
<a name="strtok"></a>
<p align=right>
<a href="rtnIndex.htm"><i>OS Libraries :  Routines</i></a></p>

</blockquote><h1>strtok(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>strtok(&nbsp;)</strong> - break down a string into tokens (ANSI)</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>char * strtok
    (
    char *       string,      /* string */
    const char * separator    /* separator indicator */
    )
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
A sequence of calls to this routine breaks the string <i>string</i> into a
sequence of tokens, each of which is delimited by a character from the
string <i>separator</i>.  The first call in the sequence has <i>string</i> as its
first argument, and is followed by calls with a null pointer as their
first argument.  The separator string may be different from call to call.
<p>
The first call in the sequence searches <i>string</i> for the first character
that is not contained in the current separator string.  If the character
is not found, there are no tokens in <i>string</i> and <b><a href="./ansiString.html#strtok">strtok</a>(&nbsp;)</b> returns a
null pointer.  If the character is found, it is the start of the first
token.
<p>
<b><a href="./ansiString.html#strtok">strtok</a>(&nbsp;)</b> then searches from there for a character that is contained in the
current separator string.  If the character is not found, the current
token expands to the end of the string pointed to by <i>string</i>, and
subsequent searches for a token will return a null pointer.  If the
character is found, it is overwritten by a null character, which
terminates the current token.  <b><a href="./ansiString.html#strtok">strtok</a>(&nbsp;)</b> saves a pointer to the following
character, from which the next search for a token will start.
(Note that because the separator character is overwritten by a null
character, the input string is modified as a result of this call.)
<p>
Each subsequent call, with a null pointer as the value of the first
argument, starts searching from the saved pointer and behaves as
described above.
<p>
The implementation behaves as if <b><a href="./ansiString.html#strtok">strtok</a>(&nbsp;)</b> is called by no library functions.
<p>
</blockquote><h4>REENTRANCY</h4><blockquote><p>
This routine is not reentrant; the reentrant form is <b><a href="./ansiString.html#strtok_r">strtok_r</a>(&nbsp;)</b>.
<p>
</blockquote><h4>INCLUDE FILES</h4><blockquote><p>
<b>string.h</b>
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
A pointer to the first character of a token, or a NULL pointer if there is
no token.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./ansiString.html#top">ansiString</a></b>, <b><a href="./ansiString.html#strtok_r">strtok_r</a>(&nbsp;)</b>

<hr>
<a name="strtok_r"></a>
<p align=right>
<a href="rtnIndex.htm"><i>OS Libraries :  Routines</i></a></p>

</blockquote><h1>strtok_r(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>strtok_r(&nbsp;)</strong> - break down a string into tokens (reentrant) (POSIX)</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>char * strtok_r
    (
    char *       string,      /* string to break into tokens */
    const char * separators,  /* the separators */
    char * *     ppLast       /* pointer to serve as string index */
    )
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine considers the null-terminated string <i>string</i> as a sequence
of zero or more text tokens separated by spans of one or more characters
from the separator string <i>separators</i>.  The argument <i>ppLast</i> points to a
user-provided pointer which in turn points to the position within <i>string</i>
at which scanning should begin.
<p>
In the first call to this routine, <i>string</i> points to a null-terminated
string; <i>separators</i> points to a null-terminated string of separator
characters; and <i>ppLast</i> points to a NULL pointer.  The function returns a
pointer to the first character of the first token, writes a null character
into <i>string</i> immediately following the returned token, and updates the
pointer to which <i>ppLast</i> points so that it points to the first character
following the null written into <i>string</i>.  (Note that because the
separator character is overwritten by a null character, the input string
is modified as a result of this call.)
<p>
In subsequent calls <i>string</i> must be a NULL pointer and <i>ppLast</i> must
be unchanged so that subsequent calls will move through the string <i>string</i>,
returning successive tokens until no tokens remain.  The separator
string <i>separators</i> may be different from call to call.  When no token
remains in <i>string</i>, a NULL pointer is returned.
<p>
</blockquote><h4>INCLUDE FILES</h4><blockquote><p>
<b>string.h</b>
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
A pointer to the first character of a token,
or a NULL pointer if there is no token.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./ansiString.html#top">ansiString</a></b>, <b><a href="./ansiString.html#strtok">strtok</a>(&nbsp;)</b>

<hr>
<a name="strxfrm"></a>
<p align=right>
<a href="rtnIndex.htm"><i>OS Libraries :  Routines</i></a></p>

</blockquote><h1>strxfrm(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>strxfrm(&nbsp;)</strong> - transform up to <i>n</i> characters of <i>s2</i> into <i>s1</i> (ANSI)</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>size_t strxfrm
    (
    char *       s1,          /* string out */
    const char * s2,          /* string in */
    size_t       n            /* size of buffer */
    )
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine transforms string <i>s2</i> and places the resulting string in <i>s1</i>.
The transformation is such that if <b><a href="./ansiString.html#strcmp">strcmp</a>(&nbsp;)</b> is applied to two transformed
strings, it returns a value greater than, equal to, or less than zero,
corresponding to the result of the <b><a href="./ansiString.html#strcoll">strcoll</a>(&nbsp;)</b> function applied to the same
two original strings.  No more than <i>n</i> characters are placed into the
resulting <i>s1</i>, including the terminating null character.  If <i>n</i> is zero,
<i>s1</i> is permitted to be a NULL pointer.  If copying takes place between
objects that overlap, the behavior is undefined.
<p>
</blockquote><h4>INCLUDE FILES</h4><blockquote><p>
<b>string.h</b>
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
<p>
The length of the transformed string, not including the terminating null
character.  If the value is <i>n</i> or more, the contents of <i>s1</i> are
indeterminate.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./ansiString.html#top">ansiString</a></b>, <b><a href="./ansiString.html#strcmp">strcmp</a>(&nbsp;)</b>, <b><a href="./ansiString.html#strcoll">strcoll</a>(&nbsp;)</b>

</body>
</html>