Symbian
Symbian Developer Library

SYMBIAN OS V9.4

Feedback

[Index] [Previous] [Next]

#include <STRING.H>
Link against: estlib.lib

__need_size_t

__need_size_t

Description

[Top]


NULL

NULL 0L

Description

[Top]


memchr(const void *,int,size_t)

IMPORT_C void* memchr(const void *, int, size_t);

Description

Search buffer for a character. Searches the first num bytes of memory block pointed by src_void for character c.

Parameters

const void *

Pointer to buffer.

int

Key character to look for.

size_tsize_t

Number of characters to check from buffer.

[Top]


memcmp(const void *,const void *,size_t)

IMPORT_C int memcmp(const void *, const void *, size_t);

Description

Parameters

const void *

const void *

size_tsize_t

Return value

int

[Top]


memcpy(void *,const void *,size_t)

IMPORT_C void* memcpy(void *dst, const void *src, size_t);

Description

Parameters

void *dst

const void *src

size_tsize_t

[Top]


_e32memcpy(void *,const void *,size_t)

IMPORT_C void* _e32memcpy(void *dst, const void *src, size_t);

Description

Parameters

void *dst

const void *src

size_tsize_t

[Top]


memmove(void *,const void *,size_t)

IMPORT_C void* memmove(void *, const void *, size_t);

Description

Parameters

void *

const void *

size_tsize_t

[Top]


memset(void *,int,size_t)

IMPORT_C void* memset(void *, int, size_t);

Description

Parameters

void *

int

size_tsize_t

[Top]


strcat(char *,const char *)

IMPORT_C char* strcat(char *, const char *);

Description

Append string. Appends s2 string to s1 string. The terminating null character in s1 is overwritten by the first character of s2. The resulting string includes a null-character at end.

Parameters

char *

Pointer to a null-terminated string with enough space allocated to contain both s2 and s1.

const char *

Null-terminated string to append.

Return value

char *

s1.

[Top]


wcscat(wchar_t *,const wchar_t *)

IMPORT_C wchar_t* wcscat(wchar_t *, const wchar_t *);

Description

Append a copy of the wide-character string pointed to by s2

Parameters

wchar_twchar_t *

wide-character

const wchar_twchar_t *

wide-character

Return value

wchar_twchar_t *

s1

[Top]


strchr(const char *,int)

IMPORT_C char* strchr(const char *, int);

Description

Find character in string. Returns the first occurrence of i in string. The null-terminating character is included as part of the string and can also be searched.

Parameters

const char *

Null-terminated string scanned in the search.

int

Character to be found.

Return value

char *

a pointer to the first occurrence of i in string is returned. otherwise NULL is returned.

[Top]


strcmp(const char *,const char *)

IMPORT_C int strcmp(const char *, const char *);

Description

Compare two strings. Compares string1 to s1 character by character. This function starts comparing the first character of each string. If they are equal to each other continues with the following pair until the characters differ or until end of string is reached.

Parameters

const char *

Null-terminated string to compare.

const char *

Null-terminated string to compare.

Return value

int

a value indicating the lexicographical relation between the strings

[Top]


wcscmp(const wchar_t *,const wchar_t *)

IMPORT_C int wcscmp(const wchar_t *, const wchar_t *);

Description

Compare the wide-character string pointed to by s1 to the wide-character string pointed to by s2.

Parameters

const wchar_twchar_t *

const wchar_twchar_t *

Return value

int

an integer greater than, equal to, or less than zero, if the wide-character string pointed to by s1 is greater than, equal to, or less than the wide-character string pointed to by s2.

[Top]


strcoll(const char *,const char *)

IMPORT_C int strcoll(const char *, const char *);

Description

Compares a to b character by character according to the character table set by current locale. This function starts comparing the first character of each string. If they are equal to each other continues with the following pair until the characters differ or until end of string is reached.

Parameters

const char *

Null-terminated string to compare.

const char *

Null-terminated string to compare.

Return value

int

a value indicating the lexicographical relation between the strings

[Top]


strcpy(char *,const char *)

IMPORT_C char* strcpy(char *, const char *);

Description

Copy string. Copies the content pointed by src to dest stopping after the terminating null-character is copied. dest should have enough memory space allocated to contain src string.

Parameters

char *

Destination string. Should be enough long to contain s2.

const char *

Null-terminated string to copy.

Return value

char *

des is returned

[Top]


wcscpy(wchar_t *,const wchar_t *)

IMPORT_C wchar_t* wcscpy(wchar_t *, const wchar_t *);

Description

Copy the wide-character string pointed to by s2 (including the terminating null wide-character code) into the array pointed to by s1.

Parameters

wchar_twchar_t *

wide-character string

const wchar_twchar_t *

wide-character string

Return value

wchar_twchar_t *

s1

[Top]


strcspn(const char *,const char *)

IMPORT_C size_t strcspn(const char *, const char *);

Description

Search string for occurrence of character set. Scans s1 character by character, returning the number of characters read until the first occurrence of any character included in s2. The search includes terminating null-characters, so the function will return the length of s1 if none of the characters included in s2 is in s1.

Parameters

const char *

Null-terminated string to be scanned.

const char *

Null-terminated string containing the character set to search for.

Return value

size_tsize_t

the position in s1 of the first occurence of a component character of s2.

[Top]


strerror(int)

IMPORT_C char* strerror(int);

Description

Get pointer to error message string. Returns a pointer to a string with the error message corresponding to the errnum error number. The returned pointer points to a statically allocated string. Further calls to this function will overwrite its content.

Parameters

int

Error number.

Return value

char *

[Top]


strlen(const char *)

IMPORT_C size_t strlen(const char *);

Description

Parameters

const char *

Return value

size_tsize_t

[Top]


wcslen(const wchar_t *)

IMPORT_C size_t wcslen(const wchar_t *);

Description

Parameters

const wchar_twchar_t *

Return value

size_tsize_t

[Top]


strncat(char *,const char *,size_t)

IMPORT_C char* strncat(char *, const char *, size_t);

Description

Append substring to string. Appends num characters of src string to dest string. If the terminating null-character appears in src string before num character have been appended, the function appends the null-character to dest and ends. The terminating null character in dest is overwritten by the first character of src. The resulting string includes a null-character at end.

Parameters

char *

Pointer to a null-terminated string with enough space allocated to contain src plus num characters.

const char *

Null-terminated string containing characters to be appended.

size_tsize_t

Number of characters to be appended from src to dest.

Return value

char *

s1 is returned

[Top]


strncmp(const char *,const char *,size_t)

IMPORT_C int strncmp(const char *, const char *, size_t);

Description

Compare some characters of two strings. Compares the first num characters of string1 to the first num characters of string2. The comparison is performed character by character. If a character that is not equal in both strings is found the function ends and returns a value that determines which of them was greater.

Parameters

const char *

Null-terminated string to compare

const char *

Null-terminated string to compare.

size_tsize_t

Maximum number of characters to compare.

Return value

int

a value indicating the lexicographical relation between the strings.

[Top]


strncpy(char *,const char *,size_t)

IMPORT_C char* strncpy(char *, const char *, size_t);

Description

Copy characters from one string to another. Copies the first num characters of src to dest. No null-character is implicitly appended to dest after copying process. So dest may not be null-terminated if no null-caracters are copied from src. If num is greater than the length of src, dest is padded with zeros until num.

Parameters

char *

Destination string. Space allocated should be at least num characters long.

const char *

Null-terminated string.

size_tsize_t

Number of characters to be copied.

Return value

char *

dst is returned.

[Top]


strpbrk(const char *,const char *)

IMPORT_C char* strpbrk(const char *, const char *);

Description

Scan string for specified characters. Scans string1 character by character, returning a pointer to the first character that matches with any of the characters in string2. The search does not includes the terminating null-characters.

Parameters

const char *

Null-terminated string to be scanned.

const char *

Null-terminated string containing the character set to search for.

Return value

char *

A pointer to the first appearance in string1 of a character specified in s2. If none of the characters specified in s2 exists in s1, a NULL pointer is returned.

[Top]


strrchr(const char *,int)

IMPORT_C char* strrchr(const char *, int);

Description

Find last occurrence of character in string. Returns the last occurrence of c in string. The null-terminating character is included as part of the string and can also be searched.

Parameters

const char *

Null-terminated string scanned in the search.

int

Character to be found.

Return value

char *

If character is found, a pointer to the last occurrence of c in string is returned. If not, NULL is returned.

[Top]


strspn(const char *,const char *)

IMPORT_C size_t strspn(const char *, const char *);

Description

Get length of substring composed of given characters. Scans s1 character by character, returning the number of characters read before the first character not included in s2 is found. The search does not include terminating null-characters.

Parameters

const char *

Null-terminated string to be scanned.

const char *

Null-terminated string containing character set.

Return value

size_tsize_t

the length of the initial substring of s1 that is only composed of characters included in s2.

[Top]


strstr(const char *,const char *)

IMPORT_C char* strstr(const char *, const char *);

Description

Find substring. Scans string1 for the first occurrence of string2. The search does not include terminating null-characters.

Parameters

const char *

Null-terminated string to search.

const char *

Null-terminated string containing the substring to search for.

Return value

char *

A pointer to the first occurrence of lookfor in searchee. If lookfor is not found in searchee the function returns NULL.

[Top]


strxfrm(char *,const char *,size_t)

IMPORT_C size_t strxfrm(char *, const char *, size_t);

Description

Transform string using locale settings. Copies the first num characters of src to dest performing the apropiate transformations for the current locale settings if needed. No null-character is implicitly appended to dest after copying process. So dest may not be null-terminated if no null-caracters are copied from src. If num is greater than the length of src, dest is padded with zeros until num. The behavor of this function is the same as strncpy but performing locale character transformations.

Parameters

char *

Destination string. Space allocated should be at least num characters long.

const char *

Null-terminated string containing string to be transformed.

size_tsize_t

Number of characters to be transformed and stored in dest.

Return value

size_tsize_t

The length of the transformed string without the null-character terminator.

[Top]


strtok(char *,const char *)

IMPORT_C char* strtok(char *, const char *);

Description

Parameters

char *

const char *

Return value

char *

[Top]


strtok_r(char *,const char *,char **)

IMPORT_C char* strtok_r(char *, const char *, char **);

Description

Parameters

char *

const char *

char **

Return value

char *

[Top]


strcasecmp(const char *,const char *)

IMPORT_C int strcasecmp(const char *, const char *);

Description

Compares the null-terminated strings left and right and returns an integer greater than,equal to, or less than zero (0), accordingly as left is lexicographically greater than,equal to, or less than right after translation of each corresponding character to lowercase.

Parameters

const char *

The first string to compare.

const char *

The second string to compare.

Return value

int

an integer greater than, equal to, or less than zero (0), accordingly as the string left is greater than, equal to, or less than the string right.

[Top]


strdup(const char *)

IMPORT_C char* strdup(const char *);

Description

Function shall return a pointer to a new string, which is a duplicate of the string pointed to by str.

Parameters

const char *

string

Return value

char *

a pointer to a new string

[Top]


wcsdup(const wchar_t *)

IMPORT_C wchar_t* wcsdup(const wchar_t *);

Description

Parameters

const wchar_twchar_t *

Return value

wchar_twchar_t *

[Top]


strncasecmp(const char *,const char *,size_t)

IMPORT_C int strncasecmp(const char *, const char *, size_t);

Description

Parameters

const char *

const char *

size_tsize_t

Return value

int

[Top]


rindex(const char *,int)

IMPORT_C char* rindex(const char *, int);

Description

Parameters

const char *

int

Return value

char *

[Top]


index(const char *,int)

IMPORT_C char* index(const char *, int);

Description

Parameters

const char *

int

Return value

char *