*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->IRIX man pages -> strxfrm (3c)              
Title
Content
Arch
Section
 

Contents


strxfrm(3C)							   strxfrm(3C)


NAME    [Toc]    [Back]

     strxfrm - string transformation

SYNOPSIS    [Toc]    [Back]

     #include <string.h>

     size_t strxfrm (char *s1, const char *s2, size_t n);

DESCRIPTION    [Toc]    [Back]

     strxfrm transforms	the string s2 and places the resulting string into the
     array s1.	The transformation is such that	if strcmp is applied to	two
     transformed strings, it returns a value greater than, equal to, or	less
     than zero,	corresponding to the result of the strcoll function applied to
     the same two original strings.  The transformation	is based on the
     program's locale for category LC_COLLATE [see setlocale(3C)].

     No	more than n characters will be placed into the resulting array pointed
     to	by s1, including the terminating null character. If n is 0, then s1 is
     permitted to be a null pointer. If	copying	takes place between objects
     that overlap, the behavior	is undefined.

     strxfrm returns the length	of the transformed string (not including the
     terminating null character).  If the value	returned is n or more, the
     contents of the array s1 are indeterminate.

EXAMPLE    [Toc]    [Back]

     The value of the following	expression is the size of the array needed to
     hold the transformation of	the string pointed to by s.

	  1 + strxfrm(NULL, s, 0);

FILES    [Toc]    [Back]

     /usr/lib/locale/locale<b>/LC_COLLATE
			      LC_COLLATE database for locale.

SEE ALSO    [Toc]    [Back]

      
      
     colltbl(1M), setlocale(3C), strcoll(3C), string(3C), environ(5).

DIAGNOSTICS    [Toc]    [Back]

     On	failure, strxfrm returns (size_t) -1.


									PPPPaaaaggggeeee 1111
[ Back ]
 Similar pages
Name OS Title
wstring IRIX wchar_t string operations and type transformation
wcstring IRIX wchar_t string operations and type transformation
fold_string_w Tru64 maps one wide-character string to another, performing the specified Unicode character transformation
glulookat IRIX define a viewing transformation
utf8 FreeBSD UTF-8, a transformation format of ISO 10646
gluLookAt Tru64 define a viewing transformation
loadmatrix IRIX loads a transformation matrix
lookat IRIX defines a viewing transformation
getmatrix IRIX returns a copy of a transformation matrix
multmatrix IRIX premultiplies the current transformation matrix
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service