S60 Open C
Standard C Library/Wide Character Functions

Standard C Library/Wide Character Functions

Table of Contents

Wide Character Functions

 


Wide Character Functions

Arithmetic Functions

Functions

Description

wcstod Converts ASCII string to floating point number
wcstol Converts a string to a long integer
wcstoul Converts a string to an unsigned long integer

Character Classification

Functions Description
wctype Wide character classification
towctrans Wide-character transliteration
towlower Converts a wide character to lowercase
towupper Converts a wide character to uppercase
wctrans Wide character translation mapping

Character Set Conversion Functions

Functions Description
mblen, mbrlen Determines number of bytes in next multibyte character
mbstowcs, mbsrtowcs Converts a multibyte string to a wide character string
mbtowc, mbrtowc Converts a multibyte sequence to a wide character
wcstombs, wcsrtombs Converts a wide character string to a multibyte string
wctomb, wcrtomb Converts a wide character to a multibyte sequence
btowc Converts a single byte to wide character
mbsinit Tests for initial shift state
wctob Tries to represent a wide character as a single byte
mbsnrtowcs Converts a multibyte string to a wide character string
wcsnrtombs Converts a wide character string to a multibyte string

Collation Functions

Functions

Description

wcscoll Wide-character string comparison using collating information
wcsxfrm Wide-character string transformation
wcsicoll Wide-character string comparison using collating information.
wcsncoll Wide-character string comparison using collating information.
wcsnicoll Wide-character string comparison using collating information.

Copying and Concatenation

Function

Description

wmemcpy Copies an array of wide-characters
wmemmove Copies an array of wide-characters
wmemset Fills an array of wide-characters with a constant wide character
wcscat, wcsncat Concatenates two wide-character strings
wcscpy, wcsncpy Copies a wide character string
wcpcpy Copies a wide character string, returning a pointer to its end
wcpncpy Copies a fixed-size string of wide characters, returning a pointer to its end
wcsdup Duplicates a wide-character string
wcstok Splits wide-character string into tokens
wcslcat Appends a copy of the wide-character string .
wcslcpy Copies the wide-character string

Directory Handling

Functions Description
wseekdir Directory operations
wtelldir Directory operations
scandir Scans a directory
wopendir Opens a directory with wide-character name
wclosedir Closes the directory stream
wreaddir Reads a directory with wide-character name
wremove Deletes a wide character name and possibly the file it refers.
wrewinddir Resets the position of the directory stream

Error Messages

Functions Description
wperror System error messages
wcserror System error messages

File/Streams Handling

Function

Description

fgetwc Read a wide character from a FILE stream
getwc Read a wide character from a FILE stream
getwchar Read a wide character from standard input
fwide Sets and determines the orientation of a FILE stream
wchdir Changes working directory
wchmod Changes permissions of a file
wfopen Streams open function
wopen Creates a file or device
wgetcwd Gets current working directory
wmkdir Creates a directory
wrealpath Returns the canonicalized absolute pathname
wrename Renames a file
wrmdir Deletes a directory
wstat Gets wide-character file status
wsystem Executes a shell command
wunlink Deletes a name and possibly the file it refers.
wcreat Creates a file or device
getws Reads a wide character string from stdin.
wprintf Writes output to stdout

Operations on File Descriptors

Functions Desription
wsetlocale Sets the current locale

Parsing of Numbers

Functions Description
wcstoimax, wcstoumax Converts a wide-character string to an integer
wcstof, wcstold Converts a wide-character string to a double-precision number
wcstoll Converts a wide-character string to a long integer
wcstoull Converts a wide-character string to an unsigned long
wcstoq, wcstouq Convert a wide-character string to a long integer

Pipes

Functions Description
wpopen Opens a process by creating a pipe and invoking the shell.

Pseudo Random Numbers

Functions Description
random Random number generator
srandom Random number generator
setstate Routine for changing generators
initstate Routine for changing generators

Search Functions

Function

Description

wcschr Searches a wide character in a wide-character string
wcscspn Searches a wide-character string for any of a set of wide characters
wcspbrk Searches a wide-character string for any of a set of wide characters
wcsrchr Searches a wide character in a wide-character string
wcsspn Advances in a wide-character string, skipping any of a set of wide characters
wcsstr Locates a substring in a wide-character string
wcswcs Finds a wide substring
wcwidth Determines columns needed for a wide character
wmemchr Searches a wide character in a wide-character array
wfindfirst Provides information about the first instance of a file name that matches the file specified in the filespec argument.
wfindnext Finds the next name that matches the file specified in the filespec argument.
findclose Closes the specified search handle and releases the associated resources.

Searching and Sorting Functions

Functions Description
alphasort Sorts an array alphabetically.

String Functions

Function

Description

wcslen Determines the length of a wide-character string
wcsnlen Determines the length of a fixed-size wide-character string
wcslwr Converts the wide-character string to lowercase wide-character string.
wcsnset Sets first n characters of the wide-character string to the specified wide-char.
wcsrev Reverts the wide-character string.
wcsset Sets all the characters of the wide-character string to the specified wide-char.
wcsupr Converts the wide-character string to uppercase wide-character string.

String/Array Comparison

Function

Description

wcscmp Compares two wide-character strings
wcsncmp Compares two fixed-size wide-character strings
wmemcmp Compares two arrays of wide-characters
wcscasecmp Compares two wide-character strings, ignoring case
wcsncasecmp Compares two fixed-size wide-character strings, ignoring case
wcsicpm Compares two wide-character strings, by converting them into lowercase.
wcsnicmp Compares two wide-character strings, by converting them into lowercase.

System Calls

Functions Description
waccess Checks user's permissions for a file.

Temporary File Functions

Functions Description
wtmpnam Generates temporary file name.

Time Functionalities

Functions Description
wasctime Transforms date and time to a wide char string.
wctime Transforms date and time to a wide char string.
wstrdate Gets the system date in wide-character format.
wstrtime Gets the system time in wide-character format.

Give feedback of this article


©Nokia 2007

Back to top


This material, including documentation and any related computer programs, is protected by copyright controlled by Nokia. All rights are reserved. Copying, including reproducing, storing, adapting or translating, any or all of this material requires the prior written consent of Nokia. This material also contains confidential information, which may not be disclosed to others without the prior written consent of Nokia.

Nokia is a registered trademark of Nokia Corporation. S60 and logo is a trademark of Nokia Corporation. Java and all Java-based marks are trademarks or registered trademarks of Sun Microsystems, Inc. Other company and product names mentioned herein may be trademarks or tradenames of their respective owners.