reg.c File Reference

#include <stdio.h>
#include "reg.h"
#include <wine/debug.h>

Include dependency graph for reg.c:

Go to the source code of this file.

Enumerations
enum	operations {   REG_ADD, REG_COPY, REG_DELETE, REG_EXPORT,   REG_IMPORT, REG_QUERY, REG_INVALID }

Functions
	WINE_DEFAULT_DEBUG_CHANNEL (reg)
void	output_writeconsole (const WCHAR *str, DWORD wlen)
static void	output_formatstring (const WCHAR *fmt, va_list va_args)
void WINAPIV	output_message (unsigned int id,...)
void WINAPIV	output_string (const WCHAR *fmt,...)
BOOL	ask_confirm (unsigned int msgid, WCHAR *reg_info)
static BOOL	path_rootname_cmp (const WCHAR *input_path, const WCHAR *rootkey_name)
HKEY	path_get_rootkey (const WCHAR *path)
static BOOL	sane_path (const WCHAR *key)
WCHAR *	build_subkey_path (WCHAR *path, DWORD path_len, WCHAR *subkey_name, DWORD subkey_len)
WCHAR *	get_long_key (HKEY root, WCHAR *path)
BOOL	parse_registry_key (const WCHAR *key, HKEY *root, WCHAR **path)
BOOL	is_char (const WCHAR s, const WCHAR c)
BOOL	is_switch (const WCHAR *s, const WCHAR c)
static BOOL	is_help_switch (const WCHAR *s)
static enum operations	get_operation (const WCHAR *str, int *op_help)
int __cdecl	wmain (int argc, WCHAR *argvW[])

Variables
struct {
HKEY   key
const WCHAR *   short_name
const WCHAR *   long_name
}	root_rels []
const struct reg_type_rels	type_rels []

Enumeration Type Documentation

operations

enum operations

Enumerator
REG_ADD
REG_COPY
REG_DELETE
REG_EXPORT
REG_IMPORT
REG_QUERY
REG_INVALID

Definition at line 285 of file reg.c.

                {
    REG_ADD,
    REG_COPY,
    REG_DELETE,
    REG_EXPORT,
    REG_IMPORT,
    REG_QUERY,
    REG_INVALID
};

Function Documentation

ask_confirm()

BOOL ask_confirm	(	unsigned int	msgid,
		WCHAR *	reg_info
	)

Definition at line 127 of file reg.c.

{
    HMODULE hmod;
    WCHAR Ybuffer[4];
    WCHAR Nbuffer[4];
    WCHAR defval[32];
    WCHAR answer[MAX_PATH];
    WCHAR *str;
    DWORD count;

    hmod = GetModuleHandleW(NULL);
    LoadStringW(hmod, STRING_YES, Ybuffer, ARRAY_SIZE(Ybuffer));
    LoadStringW(hmod, STRING_NO,  Nbuffer, ARRAY_SIZE(Nbuffer));
    LoadStringW(hmod, STRING_DEFAULT_VALUE, defval, ARRAY_SIZE(defval));

    str = (reg_info && *reg_info) ? reg_info : defval;

    while (1)
    {
        output_message(msgid, str);
        output_message(STRING_YESNO);
        ReadConsoleW(GetStdHandle(STD_INPUT_HANDLE), answer, ARRAY_SIZE(answer), &count, NULL);
        answer[0] = towupper(answer[0]);
        if (answer[0] == Ybuffer[0])
            return TRUE;
        if (answer[0] == Nbuffer[0])
            return FALSE;
    }
}

Referenced by get_file_handle(), run_add(), and run_delete().

build_subkey_path()

WCHAR* build_subkey_path	(	WCHAR *	path,
		DWORD	path_len,
		WCHAR *	subkey_name,
		DWORD	subkey_len
	)

Definition at line 198 of file reg.c.

{
    WCHAR *subkey_path;

    subkey_path = malloc((path_len + subkey_len + 2) * sizeof(WCHAR));
    swprintf(subkey_path, L"%s\\%s", path, subkey_name);

    return subkey_path;
}

Referenced by export_registry_data(), query_all(), and query_value().

get_long_key()

WCHAR* get_long_key	(	HKEY	root,
		WCHAR *	path
	)

Definition at line 208 of file reg.c.

{
    int i, len;
    WCHAR *long_key;

    for (i = 0; i < ARRAY_SIZE(root_rels); i++)
    {
        if (root == root_rels[i].key)
            break;
    }

    len = lstrlenW(root_rels[i].long_name);

    if (!path)
    {
        long_key = malloc((len + 1) * sizeof(WCHAR));
        lstrcpyW(long_key, root_rels[i].long_name);
        return long_key;
    }

    len += lstrlenW(path) + 1; /* add one for the concatenating backslash */
    long_key = malloc((len + 1) * sizeof(WCHAR));
    swprintf(long_key, L"%s\\%s", root_rels[i].long_name, path);
    return long_key;
}

Referenced by reg_delete(), reg_export(), and reg_query().

get_operation()

static enum operations get_operation ( const WCHAR *  str, int *  op_help  )

static

Definition at line 295 of file reg.c.

{
    struct op_info { const WCHAR *op; int id; int help_id; };

    static const struct op_info op_array[] =
    {
        { L"add",     REG_ADD,     STRING_ADD_USAGE },
        { L"copy",    REG_COPY,    STRING_COPY_USAGE },
        { L"delete",  REG_DELETE,  STRING_DELETE_USAGE },
        { L"export",  REG_EXPORT,  STRING_EXPORT_USAGE },
        { L"import",  REG_IMPORT,  STRING_IMPORT_USAGE },
        { L"query",   REG_QUERY,   STRING_QUERY_USAGE },
        { NULL,    -1,          0 }
    };

    const struct op_info *ptr;

    for (ptr = op_array; ptr->op; ptr++)
    {
        if (!lstrcmpiW(str, ptr->op))
        {
            *op_help = ptr->help_id;
            return ptr->id;
        }
    }

    return REG_INVALID;
}

Referenced by wmain().

is_char()

BOOL is_char	(	const WCHAR	s,
		const WCHAR	c
	)

Definition at line 267 of file reg.c.

{
    return (s == c || s == towupper(c));
}

Referenced by is_switch(), and reg_export().

is_help_switch()

static BOOL is_help_switch ( const WCHAR *  s )

static

Definition at line 280 of file reg.c.

{
    return (is_switch(s, '?') || is_switch(s, 'h'));
}

Referenced by wmain().

is_switch()

BOOL is_switch	(	const WCHAR *	s,
		const WCHAR	c
	)

Definition at line 272 of file reg.c.

{
    if (lstrlenW(s) > 2)
        return FALSE;

    return ((s[0] == '/' || s[0] == '-') && is_char(s[1], c));
}

Referenced by is_help_switch().

output_formatstring()

static void output_formatstring ( const WCHAR *  fmt, va_list  va_args  )

static

Definition at line 76 of file reg.c.

{
    WCHAR *str;
    DWORD len;

    len = FormatMessageW(FORMAT_MESSAGE_FROM_STRING|FORMAT_MESSAGE_ALLOCATE_BUFFER,
                         fmt, 0, 0, (WCHAR *)&str, 0, &va_args);
    if (len == 0 && GetLastError() != NO_ERROR)
    {
        WINE_FIXME("Could not format string: le=%u, fmt=%s\n", GetLastError(), wine_dbgstr_w(fmt));
        return;
    }
    output_writeconsole(str, len);
    LocalFree(str);
}

Referenced by output_message(), and output_string().

output_message()

void WINAPIV output_message	(	unsigned int	id,
			...
	)

Definition at line 92 of file reg.c.

{
    WCHAR *fmt = NULL;
    int len;
    va_list va_args;

    if (!(len = LoadStringW(GetModuleHandleW(NULL), id, (WCHAR *)&fmt, 0)))
    {
        WINE_FIXME("LoadString failed with %d\n", GetLastError());
        return;
    }

    len++;
    fmt = malloc(len * sizeof(WCHAR));
    if (!fmt) return;

    LoadStringW(GetModuleHandleW(NULL), id, fmt, len);

    va_start(va_args, id);
    output_formatstring(fmt, va_args);
    va_end(va_args);

    free(fmt);
}

Referenced by ask_confirm(), ask_overwrite_value(), export_key(), get_file_handle(), get_regdata(), key_name_state(), open_export_key(), output_error(), parse_registry_key(), parse_win31_line_state(), query_value(), reg_add(), reg_copy(), reg_delete(), reg_export(), reg_import(), reg_query(), REGPROC_unescape_string(), run_add(), run_delete(), run_query(), sane_path(), unescape_string(), unknown_data_state(), and wmain().

output_string()

void WINAPIV output_string	(	const WCHAR *	fmt,
			...
	)

Definition at line 117 of file reg.c.

{
    va_list va_args;

    va_start(va_args, fmt);
    output_formatstring(fmt, va_args);
    va_end(va_args);
}

Referenced by output_value(), query_all(), query_value(), and run_query().

output_writeconsole()

void output_writeconsole	(	const WCHAR *	str,
		DWORD	wlen
	)

Definition at line 53 of file reg.c.

{
    DWORD count, ret;

    ret = WriteConsoleW(GetStdHandle(STD_OUTPUT_HANDLE), str, wlen, &count, NULL);
    if (!ret)
    {
        DWORD len;
        char  *msgA;

        /* On Windows WriteConsoleW() fails if the output is redirected. So fall
         * back to WriteFile(), assuming the console encoding is still the right
         * one in that case.
         */
        len = WideCharToMultiByte(GetConsoleOutputCP(), 0, str, wlen, NULL, 0, NULL, NULL);
        msgA = malloc(len);

        WideCharToMultiByte(GetConsoleOutputCP(), 0, str, wlen, msgA, len, NULL, NULL);
        WriteFile(GetStdHandle(STD_OUTPUT_HANDLE), msgA, len, &count, FALSE);
        free(msgA);
    }
}

Referenced by get_file_handle(), and output_formatstring().

parse_registry_key()

BOOL parse_registry_key	(	const WCHAR *	key,
		HKEY *	root,
		WCHAR **	path
	)

Definition at line 234 of file reg.c.

{
    WCHAR *p;

    if (!sane_path(key))
        return FALSE;

    *root = path_get_rootkey(key);
    if (!*root)
    {
        output_message(STRING_INVALID_SYSTEM_KEY);
        return FALSE;
    }

    *path = wcschr(key, '\\');

    if (!*path)
        return TRUE;

    (*path)++;

    if (!**path)
    {
        output_message(STRING_INVALID_SYSTEM_KEY);
        return FALSE;
    }

    p = *path + lstrlenW(*path) - 1;
    if (*p == '\\') *p = 0;

    return TRUE;
}

Referenced by reg_add(), reg_copy(), reg_delete(), reg_export(), and reg_query().

path_get_rootkey()

HKEY path_get_rootkey

(

const WCHAR *

path

)

Definition at line 165 of file reg.c.

{
    DWORD i;

    for (i = 0; i < ARRAY_SIZE(root_rels); i++)
    {
        if (path_rootname_cmp(path, root_rels[i].short_name) ||
            path_rootname_cmp(path, root_rels[i].long_name))
            return root_rels[i].key;
    }

    return NULL;
}

Referenced by parse_key_name(), and parse_registry_key().

path_rootname_cmp()

static BOOL path_rootname_cmp ( const WCHAR *  input_path, const WCHAR *  rootkey_name  )

inlinestatic

Definition at line 157 of file reg.c.

{
    DWORD length = lstrlenW(rootkey_name);

    return (!_wcsnicmp(input_path, rootkey_name, length) &&
            (input_path[length] == 0 || input_path[length] == '\\'));
}

Referenced by path_get_rootkey().

sane_path()

static BOOL sane_path ( const WCHAR *  key )

static

Definition at line 179 of file reg.c.

{
    unsigned int i = lstrlenW(key);

    if (i < 3 || (key[i - 1] == '\\' && key[i - 2] == '\\'))
    {
        output_message(STRING_INVALID_KEY);
        return FALSE;
    }

    if (key[0] == '\\' && key[1] == '\\' && key[2] != '\\')
    {
        output_message(STRING_NO_REMOTE);
        return FALSE;
    }

    return TRUE;
}

Referenced by parse_registry_key().

WINE_DEFAULT_DEBUG_CHANNEL()

WINE_DEFAULT_DEBUG_CHANNEL

(

reg

)

wmain()

int __cdecl wmain	(	int	argc,
		WCHAR *	argvW[]
	)

Definition at line 324 of file reg.c.

{
    int op, op_help;

    if (argc == 1)
    {
        output_message(STRING_INVALID_SYNTAX);
        output_message(STRING_REG_HELP);
        return 1;
    }

    if (is_help_switch(argvW[1]))
    {
        output_message(STRING_USAGE);
        return 0;
    }

    op = get_operation(argvW[1], &op_help);

    if (op == REG_INVALID)
    {
        output_message(STRING_INVALID_OPTION, argvW[1]);
        output_message(STRING_REG_HELP);
        return 1;
    }
    else if (argc == 2) /* Valid operation, no arguments supplied */
        goto invalid;

    if (is_help_switch(argvW[2]))
    {
        if (argc > 3) goto invalid;

        output_message(op_help);
        output_message(STRING_REG_VIEW_USAGE);
        return 0;
    }

    if (op == REG_ADD)
        return reg_add(argc, argvW);

    if (op == REG_COPY)
        return reg_copy(argc, argvW);

    if (op == REG_DELETE)
        return reg_delete(argc, argvW);

    if (op == REG_EXPORT)
        return reg_export(argc, argvW);

    if (op == REG_IMPORT)
        return reg_import(argc, argvW);

    return reg_query(argc, argvW);

invalid:
    output_message(STRING_INVALID_SYNTAX);
    output_message(STRING_FUNC_HELP, _wcsupr(argvW[1]));
    return 1;
}

Variable Documentation

key

static HANDLE PIO_APC_ROUTINE void PIO_STATUS_BLOCK const void ULONG PLARGE_INTEGER PULONG key

Definition at line 28 of file reg.c.

Referenced by ___w64_mingwthr_add_key_dtor(), FxRegKey::__drv_maxIRQL(), ATL::CRegKey::_DoDeleteKeyTree(), _test_key_exists(), _test_key_not_exists(), _TIFFFindFieldByName(), ACTION_RegisterMIMEInfo(), add_param(), add_userkey(), AddDisplayDevice(), AddDlg_OnCommand(), afm_parse_kern_data(), afm_parse_kern_pairs(), afm_parse_track_kern(), afm_parser_next_key(), afm_parser_parse(), afm_parser_skip_section(), apply_image_attributes(), arbfp_blit_type_compare(), bsearch(), btrfs_read_sys_chunk_array(), cache_container_set_size(), CategoryMgr_FindClosestCategory(), CDecodeEnvelopedMsg_CrtlDecrypt(), CDecodeSignedMsg_VerifySignatureWithKey(), CertGetPublicKeyLength(), check_dirid(), cleanup_eventlog(), COM_OpenKeyForCLSID(), COMCAT_ICatInformation_GetCategoryDesc(), COMCAT_ICatInformation_IsClassOfCategories(), COMCAT_RegisterClassCategories(), compare_function_decl_rb(), compare_function_rb(), compare_hlsl_types_rb(), CountUniqueItems_Aux(), create_diff_row_query(), create_key_string(), create_monodata(), create_new_eventlog(), create_server(), CRYPT_CreateKeyProv(), CRYPT_ExportPublicKeyInfoEx(), CRYPT_GetFuncFromReg(), CRYPT_ImportKeyTrans(), CRYPT_ImportSystemRootCertsToReg(), CRYPT_LoadSIPFunc(), CRYPT_RegOpenStore(), CRYPT_RegWriteToReg(), CRYPT_VerifySignature(), CRYPTDLG_CheckOnlineCRL(), CryptGetDefaultOIDDllList(), CryptRegisterDefaultOIDFunction(), CryptSIPRetrieveSubjectGuid(), CryptUnregisterDefaultOIDFunction(), d3dcompiler_shader_reflection_type_compare(), d3drm_animation2_AddPositionKey(), d3drm_animation2_AddRotateKey(), d3drm_animation2_AddScaleKey(), d3drm_animation2_DeleteKey(), d3drm_animation2_GetKeys(), DECLARE_INTERFACE_(), deformat_component(), deformat_environment(), deformat_file(), DEVENUM_ICreateDevEnum_CreateClassEnumerator(), dictInsertBefore(), DllRegisterServer(), dump_child_(), EDIT_CheckCombo(), ensure_useragent(), env_absent(), env_present(), export_all(), export_is_key_exportable(), export_key(), export_registry_key(), IconCache::extract(), fetch_machine_product(), CFontInfo::File(), font_absent(), font_present(), ft_hash_str_insert(), ft_hash_str_lookup(), FTP_Connect(), get_cert_mgr_usages(), get_default_proxy_reg_value(), get_install_root(), hhp_pair::get_key(), get_key_state(), get_key_value(), get_mono_path_from_registry(), get_reg_dword(), get_shell_icon_size(), GetInstalledVersion_WowUser(), GetScanCode(), glsl_program_key_compare(), hash_bucket(), hash_insert(), HashFindFreeKeyBlock(), HashInsert(), hhp_pair::hhp_pair(), I_CryptReadTrustedPublisherDWORDValueFromRegistry(), ICInfo(), ICInstall(), ICRemove(), inf_value_parse(), init_driver(), InitLogs(), InputProcessorProfiles_EnableLanguageProfile(), InputProcessorProfiles_EnableLanguageProfileByDefault(), InputProcessorProfiles_IsEnabledLanguageProfile(), install_inf_file(), INTERNET_LoadProxySettings(), INTERNET_SaveProxySettings(), iocp_async_closesocket(), iocp_async_read(), iocp_async_read_closesocket(), iocp_async_read_thread(), iocp_async_read_thread_closesocket(), is_key_empty(), ITERATE_InstallService(), ITERATE_RemoveIniValuesOnInstall(), ITERATE_RemoveIniValuesOnUninstall(), ITERATE_WriteIniValues(), ITERATE_WriteRegistryValues(), load_sys_chunks(), MMDevEnum_GetDefaultAudioEndpoint(), MMDevice_Create(), MMDevPropStore_OpenPropKey(), MSI_EnumComponentQualifiers(), msi_publish_install_properties(), msi_validate_product_id(), NdrDllRegisterProxy(), notif_thread_proc(), ok_keys_(), okChildInt_(), okChildIntBroken_(), okChildPath_(), okChildString_(), ole_server(), open_export_key(), pa_absent(), pa_present(), param_rb_compare(), pf_absent(), pf_present(), pp_absent(), pp_present(), ppc_absent(), ppc_present(), process_hook_section(), ProcessKeys(), PROFILE_DeleteAllKeys(), PROFILE_DeleteKey(), PROFILE_Find(), PROFILE_Free(), PROFILE_GetSection(), PROFILE_Load(), PROFILE_Save(), pub_absent(), pub_present(), rci_absent(), rci_present(), rdssl_sign_ok(), CFontCache::Read(), read_oid_info(), register_codepages(), register_interfaces(), register_key_defvalueA(), register_key_defvalueW(), register_verb(), RegisterTypeLib(), rei_absent(), rei_present(), resolve_keypath(), RestoreTypedURLs(), rmi_absent(), rmi_present(), rp_absent(), rp_present(), rpi_absent(), rpi_present(), ru_absent(), ru_present(), save_cert_mgr_usages(), search_ini(), SECUR32_initializeProviders(), set_ldids(), ATL::CSimpleMap< CStringW, CStringW >::SetAtIndex(), ATL::CRegKey::SetKeyValue(), Settings_GetOutputPath(), Settings_GetShouldWriteDump(), SETUPDI_CreateDevKey(), SETUPDI_OpenDevKey(), SETUPDI_OpenDrvKey(), SetupDiCreateDeviceInterfaceRegKeyA(), SetupDiCreateDevRegKeyA(), SetupDiCreateDevRegKeyW(), SetupDiOpenClassRegKeyExW(), SetupDiOpenDevRegKey(), ATL::CRegKey::SetValue(), SHGetObjectCompatFlags(), SHGetShellKey(), si_compar(), sparse_array_add(), sqliteKeywordCode(), sr_absent(), sr_present(), START_TEST(), sti_compar(), TABLE_set_int(), TABLE_set_string(), test__lfind_s(), test_Add(), test_animation(), test_autocreation(), test_comparemode(), test_completion(), test_completion_port(), test_device_interface_key(), test_dik_codes(), test_Exists(), test_findOIDInfo(), test_get_profiles_dir(), test_hash_value(), test_header(), test_IACLCustomMRU_Continue(), test_IACLCustomMRU_TypedURLs(), test_ICInfo(), test_IEnumVARIANT(), test_import_hmac(), test_install_from(), test_interfaces(), test_internet_features(), test_Item(), test_Keys(), test_ldap_parse_sort_control(), test_long_value_name(), test_NonExistentPath(), test_notify(), test_NtCreateKey(), test_NtOpenKey(), test_NtQueryKey(), test_NtQueryValueKey(), test_NtSetValueKey(), test_null_provider(), test_perflib_key(), test_publish_components(), test_readTrustedPublisherDWORD(), test_redirection(), test_reg_delete_key(), test_register_device_iface(), test_register_font(), test_registerDefaultOIDFunction(), test_registerOIDInfo(), test_registry(), test_registry_property_a(), test_registry_property_w(), test_RegNotifyChangeKeyValue(), test_RegOpenCurrentUser(), test_RegPolicyFlags(), test_Remove(), test_save(), test_self_registration(), test_SHGetFolderPathA(), test_SHRegCloseUSKey(), test_signed_msg_encoding(), test_signed_msg_update(), test_sioAddressListChange(), test_symlinks(), test_synchronous_WSAIoctl(), testAcquireCertPrivateKey(), testAcquireSecurityContext(), testCreateSelfSignCert(), testExportPublicKey(), testGetPublicKeyLength(), testImportPublicKey(), Tests_Insert_And_Delete(), testSignCert(), TIFFFindField(), TLB_register_interface(), TOOLBAR_Save(), TransformView_delete_row(), TransformView_insert_row(), TransformView_set_row(), TreeNodeMake(), tt_face_get_kerning(), TuiEditBox(), TuiMessageBoxCritical(), UpdateKeyStateFromMsg(), urlcache_hash_entry_create(), usp10_compare_script_range(), VARIANT_GetNamedFormat(), verify_mru_(), wine_get_sortkey(), wined3d_ffp_frag_program_key_compare(), wined3d_ffp_vertex_program_key_compare(), WinHttpGetDefaultProxyConfiguration(), WinHttpSetDefaultProxyConfiguration(), WintrustGetRegPolicyFlags(), WintrustSetRegPolicyFlags(), write_superblocks(), wrv_absent(), wrv_present(), xmlDictExists(), xmlDictGrow(), xmlDictLookup(), xmlDictQLookup(), xmlHashAddEntry3(), xmlHashGrow(), xmlHashLookup3(), xmlHashQLookup3(), xmlHashRemoveEntry3(), xmlHashUpdateEntry3(), and xsltAddKey().

long_name

const WCHAR* long_name

Definition at line 30 of file reg.c.

Referenced by get_long_key(), lfn_check_orphaned(), lfn_get(), and path_get_rootkey().

root_rels

const { ... } root_rels[]

Initial value:

=
{
    {HKEY_LOCAL_MACHINE,  L"HKLM", L"HKEY_LOCAL_MACHINE"},
    {HKEY_CURRENT_USER,   L"HKCU", L"HKEY_CURRENT_USER"},
    {HKEY_CLASSES_ROOT,   L"HKCR", L"HKEY_CLASSES_ROOT"},
    {HKEY_USERS,          L"HKU",  L"HKEY_USERS"},
    {HKEY_CURRENT_CONFIG, L"HKCC", L"HKEY_CURRENT_CONFIG"},
}

Referenced by get_long_key(), and path_get_rootkey().

short_name

const WCHAR* short_name

Definition at line 29 of file reg.c.

Referenced by dup_relocated_dir(), get_graft(), insert_file_entry(), lfn_fix_checksum(), lfn_get(), path_get_rootkey(), and test_NtQueryDirectoryFile().

type_rels

const struct reg_type_rels type_rels[]

Initial value:

=
{
    {REG_NONE,                L"REG_NONE"},
    {REG_SZ,                  L"REG_SZ"},
    {REG_EXPAND_SZ,           L"REG_EXPAND_SZ"},
    {REG_BINARY,              L"REG_BINARY"},
    {REG_DWORD,               L"REG_DWORD"},
    {REG_DWORD_LITTLE_ENDIAN, L"REG_DWORD_LITTLE_ENDIAN"},
    {REG_DWORD_BIG_ENDIAN,    L"REG_DWORD_BIG_ENDIAN"},
    {REG_MULTI_SZ,            L"REG_MULTI_SZ"},
}

Definition at line 41 of file reg.c.

Referenced by reg_type_to_wchar(), and wchar_get_type().