string.c File Reference

#include <string.h>
#include <wchar.h>
#include "windows.h"
#include "winerror.h"
#include "hstring.h"
#include "wine/debug.h"

Include dependency graph for string.c:

Go to the source code of this file.

Classes
struct	hstring_header
struct	hstring_private

Macros
#define	HSTRING_REFERENCE_FLAG   1

Functions
	WINE_DEFAULT_DEBUG_CHANNEL (winstring)
	C_ASSERT (sizeof(struct hstring_header)<=sizeof(HSTRING_HEADER))
static struct hstring_private *	impl_from_HSTRING (HSTRING string)
static struct hstring_private *	impl_from_HSTRING_HEADER (HSTRING_HEADER *header)
static struct hstring_private *	impl_from_HSTRING_BUFFER (HSTRING_BUFFER buffer)
static BOOL	alloc_string (UINT32 len, HSTRING *out)
HRESULT WINAPI	WindowsCreateString (LPCWSTR ptr, UINT32 len, HSTRING *out)
HRESULT WINAPI	WindowsCreateStringReference (LPCWSTR ptr, UINT32 len, HSTRING_HEADER *header, HSTRING *out)
HRESULT WINAPI	WindowsDeleteString (HSTRING str)
HRESULT WINAPI	WindowsDuplicateString (HSTRING str, HSTRING *out)
HRESULT WINAPI	WindowsPreallocateStringBuffer (UINT32 len, WCHAR **outptr, HSTRING_BUFFER *out)
HRESULT WINAPI	WindowsDeleteStringBuffer (HSTRING_BUFFER buf)
HRESULT WINAPI	WindowsPromoteStringBuffer (HSTRING_BUFFER buf, HSTRING *out)
UINT32 WINAPI	WindowsGetStringLen (HSTRING str)
LPCWSTR WINAPI	WindowsGetStringRawBuffer (HSTRING str, UINT32 *len)
HRESULT WINAPI	WindowsStringHasEmbeddedNull (HSTRING str, BOOL *out)
HRESULT WINAPI	WindowsSubstring (HSTRING str, UINT32 start, HSTRING *out)
HRESULT WINAPI	WindowsSubstringWithSpecifiedLength (HSTRING str, UINT32 start, UINT32 len, HSTRING *out)
HRESULT WINAPI	WindowsConcatString (HSTRING str1, HSTRING str2, HSTRING *out)
BOOL WINAPI	WindowsIsStringEmpty (HSTRING str)
HRESULT WINAPI	WindowsCompareStringOrdinal (HSTRING str1, HSTRING str2, INT32 *res)
HRESULT WINAPI	WindowsTrimStringStart (HSTRING str1, HSTRING str2, HSTRING *out)
HRESULT WINAPI	WindowsTrimStringEnd (HSTRING str1, HSTRING str2, HSTRING *out)

Variables
static const WCHAR	empty [1]

Macro Definition Documentation

HSTRING_REFERENCE_FLAG

#define HSTRING_REFERENCE_FLAG   1

Definition at line 29 of file string.c.

Function Documentation

alloc_string()

static BOOL alloc_string ( UINT32  len, HSTRING *  out  )

static

Definition at line 66 of file string.c.

{
    struct hstring_private *priv;
    priv = malloc(offsetof(struct hstring_private, buffer[len+1]));
    if (!priv)
        return FALSE;
 
    priv->header.flags = 0;
    priv->header.length = len;
    priv->header.str = priv->buffer;
 
    priv->refcount = 1;
    priv->buffer[len] = '\0';
 
    *out = (HSTRING)priv;
    return TRUE;
}

Referenced by WindowsConcatString(), WindowsCreateString(), and WindowsPreallocateStringBuffer().

C_ASSERT()

C_ASSERT

(

sizeof(struct hstring_header)<=sizeof(HSTRING_HEADER)

)

impl_from_HSTRING()

static struct hstring_private * impl_from_HSTRING ( HSTRING  string )

inlinestatic

Definition at line 51 of file string.c.

{
    return (struct hstring_private *)string;
}

Referenced by WindowsCompareStringOrdinal(), WindowsConcatString(), WindowsCreateString(), WindowsDeleteString(), WindowsDuplicateString(), WindowsGetStringLen(), WindowsGetStringRawBuffer(), WindowsIsStringEmpty(), WindowsPreallocateStringBuffer(), WindowsStringHasEmbeddedNull(), WindowsSubstring(), WindowsSubstringWithSpecifiedLength(), WindowsTrimStringEnd(), and WindowsTrimStringStart().

impl_from_HSTRING_BUFFER()

static struct hstring_private * impl_from_HSTRING_BUFFER ( HSTRING_BUFFER  buffer )

inlinestatic

Definition at line 61 of file string.c.

{
    return CONTAINING_RECORD(buffer, struct hstring_private, buffer);
}

Referenced by WindowsDeleteStringBuffer(), and WindowsPromoteStringBuffer().

impl_from_HSTRING_HEADER()

static struct hstring_private * impl_from_HSTRING_HEADER ( HSTRING_HEADER *  header )

inlinestatic

Definition at line 56 of file string.c.

{
    return CONTAINING_RECORD(header, struct hstring_private, header);
}

Referenced by WindowsCreateStringReference().

WindowsCompareStringOrdinal()

HRESULT WINAPI WindowsCompareStringOrdinal	(	HSTRING	str1,
		HSTRING	str2,
		INT32 *	res
	)

Definition at line 400 of file string.c.

{
    struct hstring_private *priv1 = impl_from_HSTRING(str1);
    struct hstring_private *priv2 = impl_from_HSTRING(str2);
    const WCHAR *buf1 = empty, *buf2 = empty;
    UINT32 len1 = 0, len2 = 0;
 
    TRACE("(%p, %p, %p)\n", str1, str2, res);
 
    if (res == NULL)
        return E_INVALIDARG;
    if (str1 == str2)
    {
        *res = 0;
        return S_OK;
    }
    if (str1)
    {
        buf1 = priv1->header.str;
        len1 = priv1->header.length;
    }
    if (str2)
    {
        buf2 = priv2->header.str;
        len2 = priv2->header.length;
    }
    *res = CompareStringOrdinal(buf1, len1, buf2, len2, FALSE) - CSTR_EQUAL;
    return S_OK;
}

Referenced by test_compare().

WindowsConcatString()

HRESULT WINAPI WindowsConcatString	(	HSTRING	str1,
		HSTRING	str2,
		HSTRING *	out
	)

Definition at line 356 of file string.c.

{
    struct hstring_private *priv1 = impl_from_HSTRING(str1);
    struct hstring_private *priv2 = impl_from_HSTRING(str2);
    struct hstring_private *priv;
 
    TRACE("(%p, %p, %p)\n", str1, str2, out);
 
    if (out == NULL)
        return E_INVALIDARG;
    if (str1 == NULL)
        return WindowsDuplicateString(str2, out);
    if (str2 == NULL)
        return WindowsDuplicateString(str1, out);
    if (!priv1->header.length && !priv2->header.length)
    {
        *out = NULL;
        return S_OK;
    }
    if (!alloc_string(priv1->header.length + priv2->header.length, out))
        return E_OUTOFMEMORY;
    priv = impl_from_HSTRING(*out);
    memcpy(priv->buffer, priv1->header.str, priv1->header.length * sizeof(*priv1->buffer));
    memcpy(priv->buffer + priv1->header.length, priv2->header.str, priv2->header.length * sizeof(*priv2->buffer));
    return S_OK;
}

Referenced by test_concat().

WindowsCreateString()

HRESULT WINAPI WindowsCreateString	(	LPCWSTR	ptr,
		UINT32	len,
		HSTRING *	out
	)

Definition at line 87 of file string.c.

{
    struct hstring_private *priv;
 
    TRACE("(%s, %u, %p)\n", debugstr_wn(ptr, len), len, out);
 
    if (out == NULL)
        return E_INVALIDARG;
    if (len == 0)
    {
        *out = NULL;
        return S_OK;
    }
    if (ptr == NULL)
        return E_POINTER;
    if (!alloc_string(len, out))
        return E_OUTOFMEMORY;
    priv = impl_from_HSTRING(*out);
    memcpy(priv->buffer, ptr, len * sizeof(*priv->buffer));
    return S_OK;
}

Referenced by mta_init_implicit_thread(), test_access(), test_ActivationFactories(), test_compare(), test_concat(), test_create_delete(), test_duplicate(), test_hstring_struct(), test_implicit_mta(), test_substring(), test_trim(), WindowsDuplicateString(), WindowsSubstring(), WindowsSubstringWithSpecifiedLength(), WindowsTrimStringEnd(), and WindowsTrimStringStart().

WindowsCreateStringReference()

HRESULT WINAPI WindowsCreateStringReference	(	LPCWSTR	ptr,
		UINT32	len,
		HSTRING_HEADER *	header,
		HSTRING *	out
	)

Definition at line 113 of file string.c.

{
    struct hstring_private *priv = impl_from_HSTRING_HEADER(header);
 
    TRACE("(%s, %u, %p, %p)\n", debugstr_wn(ptr, len), len, header, out);
 
    if (out == NULL || header == NULL)
        return E_INVALIDARG;
    if (ptr != NULL && ptr[len] != '\0')
        return E_INVALIDARG;
    if (len == 0)
    {
        *out = NULL;
        return S_OK;
    }
    if (ptr == NULL)
        return E_POINTER;
 
    priv->header.str = ptr;
    priv->header.length = len;
    priv->header.flags = HSTRING_REFERENCE_FLAG;
 
    *out = (HSTRING)priv;
    return S_OK;
}

Referenced by test_access(), test_compare(), test_concat(), test_create_delete(), test_duplicate(), test_hstring_struct(), test_substring(), and test_trim().

WindowsDeleteString()

HRESULT WINAPI WindowsDeleteString

(

HSTRING

str

)

Definition at line 143 of file string.c.

{
    struct hstring_private *priv = impl_from_HSTRING(str);
 
    TRACE("(%p)\n", str);
 
    if (str == NULL)
        return S_OK;
    if (priv->header.flags & HSTRING_REFERENCE_FLAG)
        return S_OK;
    if (InterlockedDecrement(&priv->refcount) == 0)
        free(priv);
    return S_OK;
}

Referenced by mta_init_implicit_thread(), test_access(), test_ActivationFactories(), test_compare(), test_concat(), test_create_delete(), test_duplicate(), test_hstring_struct(), test_implicit_mta(), test_string_buffer(), test_substring(), test_trim(), and WindowsDeleteStringBuffer().

WindowsDeleteStringBuffer()

HRESULT WINAPI WindowsDeleteStringBuffer

(

HSTRING_BUFFER

buf

)

Definition at line 212 of file string.c.

{
    struct hstring_private *priv = NULL;
 
    TRACE("(%p)\n", buf);
 
    if(buf)
        priv = impl_from_HSTRING_BUFFER(buf);
 
    return WindowsDeleteString((HSTRING)priv);
}

Referenced by test_string_buffer().

WindowsDuplicateString()

HRESULT WINAPI WindowsDuplicateString	(	HSTRING	str,
		HSTRING *	out
	)

Definition at line 161 of file string.c.

{
    struct hstring_private *priv = impl_from_HSTRING(str);
 
    TRACE("(%p, %p)\n", str, out);
 
    if (out == NULL)
        return E_INVALIDARG;
    if (str == NULL)
    {
        *out = NULL;
        return S_OK;
    }
    if (priv->header.flags & HSTRING_REFERENCE_FLAG)
        return WindowsCreateString(priv->header.str, priv->header.length, out);
    InterlockedIncrement(&priv->refcount);
    *out = str;
    return S_OK;
}

Referenced by test_duplicate(), test_hstring_struct(), WindowsConcatString(), WindowsTrimStringEnd(), and WindowsTrimStringStart().

WindowsGetStringLen()

UINT32 WINAPI WindowsGetStringLen

(

HSTRING

str

)

Definition at line 249 of file string.c.

{
    struct hstring_private *priv = impl_from_HSTRING(str);
 
    TRACE("(%p)\n", str);
 
    if (str == NULL)
        return 0;
    return priv->header.length;
}

Referenced by _check_string(), WindowsSubstring(), and WindowsSubstringWithSpecifiedLength().

WindowsGetStringRawBuffer()

LPCWSTR WINAPI WindowsGetStringRawBuffer	(	HSTRING	str,
		UINT32 *	len
	)

Definition at line 263 of file string.c.

{
    struct hstring_private *priv = impl_from_HSTRING(str);
 
    TRACE("(%p, %p)\n", str, len);
 
    if (str == NULL)
    {
        if (len)
            *len = 0;
        return empty;
    }
    if (len)
        *len = priv->header.length;
    return priv->header.str;
}

Referenced by _check_string(), DllGetActivationFactory(), and RoGetActivationFactory().

WindowsIsStringEmpty()

BOOL WINAPI WindowsIsStringEmpty

(

HSTRING

str

)

Definition at line 386 of file string.c.

{
    struct hstring_private *priv = impl_from_HSTRING(str);
 
    TRACE("(%p)\n", str);
 
    if (str == NULL)
        return TRUE;
    return priv->header.length == 0;
}

Referenced by _check_string().

WindowsPreallocateStringBuffer()

HRESULT WINAPI WindowsPreallocateStringBuffer	(	UINT32	len,
		WCHAR **	outptr,
		HSTRING_BUFFER *	out
	)

Definition at line 184 of file string.c.

{
    struct hstring_private *priv;
    HSTRING str;
 
    TRACE("(%u, %p, %p)\n", len, outptr, out);
 
    if (outptr == NULL || out == NULL)
        return E_POINTER;
    if (len == 0)
    {
        *outptr = (LPWSTR)empty;
        *out = NULL;
        return S_OK;
    }
 
    if (!alloc_string(len, &str))
        return E_OUTOFMEMORY;
    priv = impl_from_HSTRING(str);
    *outptr = priv->buffer;
    *out = (HSTRING_BUFFER)&priv->buffer;
    return S_OK;
}

Referenced by test_string_buffer().

WindowsPromoteStringBuffer()

HRESULT WINAPI WindowsPromoteStringBuffer	(	HSTRING_BUFFER	buf,
		HSTRING *	out
	)

Definition at line 227 of file string.c.

{
    struct hstring_private *priv = impl_from_HSTRING_BUFFER(buf);
 
    TRACE("(%p, %p)\n", buf, out);
 
    if (out == NULL)
        return E_POINTER;
    if (buf == NULL)
    {
        *out = NULL;
        return S_OK;
    }
    if (priv->buffer[priv->header.length] != 0 || priv->header.flags & HSTRING_REFERENCE_FLAG || priv->refcount != 1)
        return E_INVALIDARG;
    *out = (HSTRING)priv;
    return S_OK;
}

Referenced by test_string_buffer().

WindowsStringHasEmbeddedNull()

HRESULT WINAPI WindowsStringHasEmbeddedNull	(	HSTRING	str,
		BOOL *	out
	)

Definition at line 283 of file string.c.

{
    UINT32 i;
    struct hstring_private *priv = impl_from_HSTRING(str);
 
    TRACE("(%p, %p)\n", str, out);
 
    if (out == NULL)
        return E_INVALIDARG;
    if (str == NULL)
    {
        *out = FALSE;
        return S_OK;
    }
    for (i = 0; i < priv->header.length; i++)
    {
        if (priv->header.str[i] == '\0')
        {
            *out = TRUE;
            return S_OK;
        }
    }
    *out = FALSE;
    return S_OK;
}

Referenced by _check_string().

WindowsSubstring()

HRESULT WINAPI WindowsSubstring	(	HSTRING	str,
		UINT32	start,
		HSTRING *	out
	)

Definition at line 312 of file string.c.

{
    struct hstring_private *priv = impl_from_HSTRING(str);
    UINT32 len = WindowsGetStringLen(str);
 
    TRACE("(%p, %u, %p)\n", str, start, out);
 
    if (out == NULL)
        return E_INVALIDARG;
    if (start > len)
        return E_BOUNDS;
    if (start == len)
    {
        *out = NULL;
        return S_OK;
    }
    return WindowsCreateString(&priv->header.str[start], len - start, out);
}

Referenced by test_substring().

WindowsSubstringWithSpecifiedLength()

HRESULT WINAPI WindowsSubstringWithSpecifiedLength	(	HSTRING	str,
		UINT32	start,
		UINT32	len,
		HSTRING *	out
	)

Definition at line 334 of file string.c.

{
    struct hstring_private *priv = impl_from_HSTRING(str);
 
    TRACE("(%p, %u, %u, %p)\n", str, start, len, out);
 
    if (out == NULL)
        return E_INVALIDARG;
    if (start + len < start ||
        start + len > WindowsGetStringLen(str))
        return E_BOUNDS;
    if (len == 0)
    {
        *out = NULL;
        return S_OK;
    }
    return WindowsCreateString(&priv->header.str[start], len, out);
}

Referenced by test_substring().

WindowsTrimStringEnd()

HRESULT WINAPI WindowsTrimStringEnd	(	HSTRING	str1,
		HSTRING	str2,
		HSTRING *	out
	)

Definition at line 460 of file string.c.

{
    struct hstring_private *priv1 = impl_from_HSTRING(str1);
    struct hstring_private *priv2 = impl_from_HSTRING(str2);
    UINT32 len;
 
    TRACE("(%p, %p, %p)\n", str1, str2, out);
 
    if (!out || !str2 || !priv2->header.length)
        return E_INVALIDARG;
    if (!str1)
    {
        *out = NULL;
        return S_OK;
    }
    for (len = priv1->header.length; len > 0; len--)
    {
        if (!wmemchr(priv2->header.str, priv1->header.str[len - 1], priv2->header.length))
            break;
    }
    return (len < priv1->header.length) ? WindowsCreateString(priv1->header.str, len, out) :
                                   WindowsDuplicateString(str1, out);
}

Referenced by test_trim().

WindowsTrimStringStart()

HRESULT WINAPI WindowsTrimStringStart	(	HSTRING	str1,
		HSTRING	str2,
		HSTRING *	out
	)

Definition at line 433 of file string.c.

{
    struct hstring_private *priv1 = impl_from_HSTRING(str1);
    struct hstring_private *priv2 = impl_from_HSTRING(str2);
    UINT32 start;
 
    TRACE("(%p, %p, %p)\n", str1, str2, out);
 
    if (!out || !str2 || !priv2->header.length)
        return E_INVALIDARG;
    if (!str1)
    {
        *out = NULL;
        return S_OK;
    }
    for (start = 0; start < priv1->header.length; start++)
    {
        if (!wmemchr(priv2->header.str, priv1->header.str[start], priv2->header.length))
            break;
    }
    return start ? WindowsCreateString(&priv1->header.str[start], priv1->header.length - start, out) :
                   WindowsDuplicateString(str1, out);
}

Referenced by test_trim().

WINE_DEFAULT_DEBUG_CHANNEL()

WINE_DEFAULT_DEBUG_CHANNEL

(

winstring

)

Variable Documentation

empty

const WCHAR empty[1]

static

Definition at line 47 of file string.c.

Referenced by _check_string(), _create_option_elem(), _Slist_sort(), _test_open(), _test_server_open(), _wcstoi64_l(), _wcstoui64_l(), AppendFullPathURL(), list< _Tp, >::back(), BinaryToBase64W(), XMLStorage::XMLNode::Children::clear(), clear_lfn_slots(), create_command(), CRYPT_IsEmptyName(), delete_tree(), delete_tree_(), dictionary_put_Key(), do_reg_operation(), do_splits(), StringTest::find(), list< _Tp, >::front(), get_patch_product_codes(), get_regdata(), get_tasks_root_folder(), HTMLImageElementFactory_value(), _Rb_tree< _Key, _Compare, _Value, _KeyOfValue, _Traits, >::insert_unique(), InternetOpenRequest_test(), JSGlobal_parseInt(), lfn_remove(), TMapLoader::Load(), LoadWinTypeFromCHM(), MSI_GetProductInfo(), nfs41_client_state_revoked(), parse_culture(), parse_probing(), parse_startup(), parse_supported_runtime(), list< _Tp, >::pop_back(), list< _Tp, >::pop_front(), proxtrans(), pSetupStringTableStringFromId(), recvrequest(), REGION_CropRegion(), ReOpenFile(), reset(), run_service(), s_remote_FormatRecord(), s_remote_GetProperty(), s_remote_GetSourcePath(), s_remote_GetTargetPath(), s_remote_SummaryInfoGetProperty(), s_remote_ViewGetError(), select_style(), set_default_templates(), SHLWAPI_InvokeByIID(), SQLWritePrivateProfileStringW(), list< _Tp, >::swap(), StringTest::template_expression(), StringTest::template_wexpression(), test_assign(), test_construction(), test_copyassignment(), test_copyconstructor(), test_CopyFolder(), test_CopyStgMedium(), test_CPoint(), test_create_delete_svc(), test_create_device_list_ex(), test_CreateAssemblyNameObject(), test_CRect(), test_CryptCATOpen(), test_CSize(), test_DnsNameCompare_A(), test_DxDiag_SoundDevices(), test_DxDiag_SystemInfo(), test_empty_headers_param(), test_find_file(), test_fromguid(), test_GetAddrInfoW(), test_GetLongPathNameW(), test_GetVolumePathNamesForVolumeNameW(), test_HlinkGetSetStringReference(), test_InstallAssembly(), test_IsDomainLegalCookieDomainW(), test_IWinHttpRequest(), test_mbsspn(), test_mbsspnp(), test_menu_iteminfo(), test_misc(), test_NetFwAuthorizedApplication(), test_PdhValidatePathExW(), test_PdhValidatePathW(), test_PropVariantCompareEx(), test_QueryAssemblyInfo(), test_request_parameter_defaults(), test_sequence(), test_SQLGetPrivateProfileStringW(), test_Startup(), test_string_pointers(), test_stringtable(), test_Win32_Service(), test_WinHttpAddHeaders(), CProgressDialog::update_dialog(), update_title(), VARIANT_BstrReplaceDecimal(), Widget_array(), Widget_mystruct(), Widget_rect(), WindowsCompareStringOrdinal(), WindowsGetStringRawBuffer(), WindowsPreallocateStringBuffer(), wnet_use_connection(), xmldoc_createElement(), and xmlParse3986Segment().