3950d49c4f
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@52790 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
124 lines
3.7 KiB
C
124 lines
3.7 KiB
C
/////////////////////////////////////////////////////////////////////////////
|
|
// Name: wxcrt.h
|
|
// Purpose: interface of global functions
|
|
// Author: wxWidgets team
|
|
// RCS-ID: $Id$
|
|
// Licence: wxWindows license
|
|
/////////////////////////////////////////////////////////////////////////////
|
|
|
|
/** @ingroup group_funcmacro_string */
|
|
//@{
|
|
|
|
/**
|
|
@returns @true if the pointer is either @NULL or points to an empty string,
|
|
@false otherwise.
|
|
|
|
@header{wx/wxcrt.h}
|
|
*/
|
|
bool wxIsEmpty(const char* p);
|
|
|
|
/**
|
|
This is a safe version of standard function @e strlen(): it does exactly
|
|
the same thing (i.e. returns the length of the string) except that it
|
|
returns 0 if @a p is the @NULL pointer.
|
|
|
|
@header{wx/wxcrt.h}
|
|
*/
|
|
size_t wxStrlen(const char* p);
|
|
|
|
/**
|
|
This function complements the standard C function @e stricmp() which
|
|
performs case-insensitive comparison.
|
|
|
|
@returns A negative value, 0, or positive value if @a p1 is less than,
|
|
equal to or greater than @a p2. The comparison is case-sensitive.
|
|
|
|
@header{wx/wxcrt.h}
|
|
*/
|
|
int wxStrcmp(const char* p1, const char* p2);
|
|
|
|
/**
|
|
This function complements the standard C function @e strcmp() which performs
|
|
case-sensitive comparison.
|
|
|
|
@returns A negative value, 0, or positive value if @a p1 is less than,
|
|
equal to or greater than @e p2. The comparison is case-insensitive.
|
|
|
|
@header{wx/wxcrt.h}
|
|
*/
|
|
int wxStricmp(const char* p1, const char* p2);
|
|
|
|
/**
|
|
@deprecated Use wxString instead.
|
|
|
|
This macro is defined as:
|
|
|
|
@code
|
|
#define wxStringEq(s1, s2) (s1 && s2 && (strcmp(s1, s2) == 0))
|
|
@endcode
|
|
|
|
@header{wx/wxcrt.h}
|
|
*/
|
|
bool wxStringEq(const wxString& s1, const wxString& s2);
|
|
|
|
/**
|
|
@deprecated Use wxString::Find() instead.
|
|
|
|
Returns @true if the substring @a s1 is found within @a s2, ignoring case
|
|
if @a exact is @false. If @a subString is @false, no substring matching is
|
|
done.
|
|
|
|
@header{wx/wxcrt.h}
|
|
*/
|
|
bool wxStringMatch(const wxString& s1, const wxString& s2,
|
|
bool subString = true, bool exact = false);
|
|
|
|
/**
|
|
This is a convenience function wrapping wxStringTokenizer which simply
|
|
returns all tokens found in the given @a string in an array.
|
|
|
|
Please see wxStringTokenizer::wxStringTokenizer() for a description of the
|
|
other parameters.
|
|
|
|
@header{wx/wxcrt.h}
|
|
*/
|
|
wxArrayString wxStringTokenize(const wxString& string,
|
|
const wxString& delims = wxDEFAULT_DELIMITERS,
|
|
wxStringTokenizerMode mode = wxTOKEN_DEFAULT);
|
|
|
|
/**
|
|
This function replaces the dangerous standard function @e sprintf() and is
|
|
like @e snprintf() available on some platforms. The only difference with
|
|
@e sprintf() is that an additional argument - buffer size - is taken and
|
|
the buffer is never overflowed.
|
|
|
|
Returns the number of characters copied to the buffer or -1 if there is not
|
|
enough space.
|
|
|
|
@see wxVsnprintf(), wxString::Printf()
|
|
|
|
@header{wx/wxcrt.h}
|
|
*/
|
|
int wxSnprintf(wxChar* buf, size_t len, const wxChar* format, ...);
|
|
|
|
/**
|
|
The same as wxSnprintf() but takes a @c va_list argument instead of an
|
|
arbitrary number of parameters.
|
|
|
|
@note If @c wxUSE_PRINTF_POS_PARAMS is set to 1, then this function
|
|
supports positional arguments (see wxString::Printf() for more
|
|
information). However other functions of the same family (wxPrintf(),
|
|
wxSprintf(), wxFprintf(), wxVfprintf(), wxVfprintf(), wxVprintf(),
|
|
wxVsprintf()) currently do not to support positional parameters even
|
|
when @c wxUSE_PRINTF_POS_PARAMS is 1.
|
|
|
|
@see wxSnprintf(), wxString::PrintfV()
|
|
|
|
@header{wx/wxcrt.h}
|
|
*/
|
|
int wxVsnprintf(wxChar* buf, size_t len,
|
|
const wxChar* format, va_list argPtr);
|
|
|
|
//@}
|
|
|