ホーム › Devices.Display › EngUnicodeToMultiByteN
EngUnicodeToMultiByteN
関数Unicode文字列をマルチバイト文字列へ変換する。
シグネチャ
// GDI32.dll
#include <windows.h>
void EngUnicodeToMultiByteN(
LPSTR MultiByteString,
DWORD MaxBytesInMultiByteString,
DWORD* BytesInMultiByteString, // optional
LPWSTR UnicodeString,
DWORD BytesInUnicodeString
);パラメーター
| 名前 | 型 | 方向 | 説明 |
|---|---|---|---|
| MultiByteString | LPSTR | out | 変換結果のマルチバイト文字列を受け取るバッファ(LPSTR)へのポインター。 |
| MaxBytesInMultiByteString | DWORD | in | MultiByteString バッファの最大バイト数。 |
| BytesInMultiByteString | DWORD* | outoptional | 実際に書き込まれたバイト数を受け取るDWORD*。NULL可。 |
| UnicodeString | LPWSTR | in | 変換元のUnicode文字列へのポインター。 |
| BytesInUnicodeString | DWORD | in | 変換元Unicode文字列のバイト数。 |
戻り値の型: void
各言語での呼び出し定義
// GDI32.dll
#include <windows.h>
void EngUnicodeToMultiByteN(
LPSTR MultiByteString,
DWORD MaxBytesInMultiByteString,
DWORD* BytesInMultiByteString, // optional
LPWSTR UnicodeString,
DWORD BytesInUnicodeString
);[DllImport("GDI32.dll", ExactSpelling = true)]
static extern void EngUnicodeToMultiByteN(
[MarshalAs(UnmanagedType.LPStr)] System.Text.StringBuilder MultiByteString, // LPSTR out
uint MaxBytesInMultiByteString, // DWORD
IntPtr BytesInMultiByteString, // DWORD* optional, out
[MarshalAs(UnmanagedType.LPWStr)] string UnicodeString, // LPWSTR
uint BytesInUnicodeString // DWORD
);<DllImport("GDI32.dll", ExactSpelling:=True)>
Public Shared Sub EngUnicodeToMultiByteN(
<MarshalAs(UnmanagedType.LPStr)> MultiByteString As System.Text.StringBuilder, ' LPSTR out
MaxBytesInMultiByteString As UInteger, ' DWORD
BytesInMultiByteString As IntPtr, ' DWORD* optional, out
<MarshalAs(UnmanagedType.LPWStr)> UnicodeString As String, ' LPWSTR
BytesInUnicodeString As UInteger ' DWORD
)
End Sub' MultiByteString : LPSTR out
' MaxBytesInMultiByteString : DWORD
' BytesInMultiByteString : DWORD* optional, out
' UnicodeString : LPWSTR
' BytesInUnicodeString : DWORD
Declare PtrSafe Sub EngUnicodeToMultiByteN Lib "gdi32" ( _
ByVal MultiByteString As String, _
ByVal MaxBytesInMultiByteString As Long, _
ByVal BytesInMultiByteString As LongPtr, _
ByVal UnicodeString As LongPtr, _
ByVal BytesInUnicodeString As Long)
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。import ctypes
from ctypes import wintypes
EngUnicodeToMultiByteN = ctypes.windll.gdi32.EngUnicodeToMultiByteN
EngUnicodeToMultiByteN.restype = None
EngUnicodeToMultiByteN.argtypes = [
wintypes.LPSTR, # MultiByteString : LPSTR out
wintypes.DWORD, # MaxBytesInMultiByteString : DWORD
ctypes.POINTER(wintypes.DWORD), # BytesInMultiByteString : DWORD* optional, out
wintypes.LPCWSTR, # UnicodeString : LPWSTR
wintypes.DWORD, # BytesInUnicodeString : DWORD
]require 'fiddle'
require 'fiddle/import'
lib = Fiddle.dlopen('GDI32.dll')
EngUnicodeToMultiByteN = Fiddle::Function.new(
lib['EngUnicodeToMultiByteN'],
[
Fiddle::TYPE_VOIDP, # MultiByteString : LPSTR out
-Fiddle::TYPE_INT, # MaxBytesInMultiByteString : DWORD
Fiddle::TYPE_VOIDP, # BytesInMultiByteString : DWORD* optional, out
Fiddle::TYPE_VOIDP, # UnicodeString : LPWSTR
-Fiddle::TYPE_INT, # BytesInUnicodeString : DWORD
],
Fiddle::TYPE_VOID)#[link(name = "gdi32")]
extern "system" {
fn EngUnicodeToMultiByteN(
MultiByteString: *mut u8, // LPSTR out
MaxBytesInMultiByteString: u32, // DWORD
BytesInMultiByteString: *mut u32, // DWORD* optional, out
UnicodeString: *mut u16, // LPWSTR
BytesInUnicodeString: u32 // DWORD
);
}
// crates: windows-sys provides ready-made bindings for this API.$sig = @"
[DllImport("GDI32.dll")]
public static extern void EngUnicodeToMultiByteN([MarshalAs(UnmanagedType.LPStr)] System.Text.StringBuilder MultiByteString, uint MaxBytesInMultiByteString, IntPtr BytesInMultiByteString, [MarshalAs(UnmanagedType.LPWStr)] string UnicodeString, uint BytesInUnicodeString);
"@
$api = Add-Type -MemberDefinition $sig -Name 'GDI32_EngUnicodeToMultiByteN' -Namespace Win32 -PassThru
# $api::EngUnicodeToMultiByteN(MultiByteString, MaxBytesInMultiByteString, BytesInMultiByteString, UnicodeString, BytesInUnicodeString)#uselib "GDI32.dll"
#func global EngUnicodeToMultiByteN "EngUnicodeToMultiByteN" sptr, sptr, sptr, sptr, sptr
; EngUnicodeToMultiByteN varptr(MultiByteString), MaxBytesInMultiByteString, varptr(BytesInMultiByteString), UnicodeString, BytesInUnicodeString
; MultiByteString : LPSTR out -> "sptr"
; MaxBytesInMultiByteString : DWORD -> "sptr"
; BytesInMultiByteString : DWORD* optional, out -> "sptr"
; UnicodeString : LPWSTR -> "sptr"
; BytesInUnicodeString : DWORD -> "sptr"出力引数:
#uselib "GDI32.dll" #func global EngUnicodeToMultiByteN "EngUnicodeToMultiByteN" var, int, var, wstr, int ; EngUnicodeToMultiByteN MultiByteString, MaxBytesInMultiByteString, BytesInMultiByteString, UnicodeString, BytesInUnicodeString ; MultiByteString : LPSTR out -> "var" ; MaxBytesInMultiByteString : DWORD -> "int" ; BytesInMultiByteString : DWORD* optional, out -> "var" ; UnicodeString : LPWSTR -> "wstr" ; BytesInUnicodeString : DWORD -> "int" ; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "GDI32.dll" #func global EngUnicodeToMultiByteN "EngUnicodeToMultiByteN" sptr, int, sptr, wstr, int ; EngUnicodeToMultiByteN varptr(MultiByteString), MaxBytesInMultiByteString, varptr(BytesInMultiByteString), UnicodeString, BytesInUnicodeString ; MultiByteString : LPSTR out -> "sptr" ; MaxBytesInMultiByteString : DWORD -> "int" ; BytesInMultiByteString : DWORD* optional, out -> "sptr" ; UnicodeString : LPWSTR -> "wstr" ; BytesInUnicodeString : DWORD -> "int" ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
出力引数:
; void EngUnicodeToMultiByteN(LPSTR MultiByteString, DWORD MaxBytesInMultiByteString, DWORD* BytesInMultiByteString, LPWSTR UnicodeString, DWORD BytesInUnicodeString) #uselib "GDI32.dll" #func global EngUnicodeToMultiByteN "EngUnicodeToMultiByteN" var, int, var, wstr, int ; EngUnicodeToMultiByteN MultiByteString, MaxBytesInMultiByteString, BytesInMultiByteString, UnicodeString, BytesInUnicodeString ; MultiByteString : LPSTR out -> "var" ; MaxBytesInMultiByteString : DWORD -> "int" ; BytesInMultiByteString : DWORD* optional, out -> "var" ; UnicodeString : LPWSTR -> "wstr" ; BytesInUnicodeString : DWORD -> "int" ; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。; void EngUnicodeToMultiByteN(LPSTR MultiByteString, DWORD MaxBytesInMultiByteString, DWORD* BytesInMultiByteString, LPWSTR UnicodeString, DWORD BytesInUnicodeString) #uselib "GDI32.dll" #func global EngUnicodeToMultiByteN "EngUnicodeToMultiByteN" intptr, int, intptr, wstr, int ; EngUnicodeToMultiByteN varptr(MultiByteString), MaxBytesInMultiByteString, varptr(BytesInMultiByteString), UnicodeString, BytesInUnicodeString ; MultiByteString : LPSTR out -> "intptr" ; MaxBytesInMultiByteString : DWORD -> "int" ; BytesInMultiByteString : DWORD* optional, out -> "intptr" ; UnicodeString : LPWSTR -> "wstr" ; BytesInUnicodeString : DWORD -> "int" ; ※出力/バッファ引数はポインタ方式(token=intptr / 呼び出しは varptr(変数))。
import (
"golang.org/x/sys/windows"
"unsafe"
)
var (
gdi32 = windows.NewLazySystemDLL("GDI32.dll")
procEngUnicodeToMultiByteN = gdi32.NewProc("EngUnicodeToMultiByteN")
)
// MultiByteString (LPSTR out), MaxBytesInMultiByteString (DWORD), BytesInMultiByteString (DWORD* optional, out), UnicodeString (LPWSTR), BytesInUnicodeString (DWORD)
r1, _, err := procEngUnicodeToMultiByteN.Call(
uintptr(MultiByteString),
uintptr(MaxBytesInMultiByteString),
uintptr(BytesInMultiByteString),
uintptr(unsafe.Pointer(windows.StringToUTF16Ptr(UnicodeString))),
uintptr(BytesInUnicodeString),
)
_ = err // syscall.Errno (valid when the call sets last-error)
_ = r1 // voidprocedure EngUnicodeToMultiByteN(
MultiByteString: PAnsiChar; // LPSTR out
MaxBytesInMultiByteString: DWORD; // DWORD
BytesInMultiByteString: Pointer; // DWORD* optional, out
UnicodeString: PWideChar; // LPWSTR
BytesInUnicodeString: DWORD // DWORD
); stdcall;
external 'GDI32.dll' name 'EngUnicodeToMultiByteN';result := DllCall("GDI32\EngUnicodeToMultiByteN"
, "Ptr", MultiByteString ; LPSTR out
, "UInt", MaxBytesInMultiByteString ; DWORD
, "Ptr", BytesInMultiByteString ; DWORD* optional, out
, "WStr", UnicodeString ; LPWSTR
, "UInt", BytesInUnicodeString ; DWORD
, "Int") ; return: void●EngUnicodeToMultiByteN(MultiByteString, MaxBytesInMultiByteString, BytesInMultiByteString, UnicodeString, BytesInUnicodeString) = DLL("GDI32.dll", "int EngUnicodeToMultiByteN(char*, dword, void*, char*, dword)")
# 呼び出し: EngUnicodeToMultiByteN(MultiByteString, MaxBytesInMultiByteString, BytesInMultiByteString, UnicodeString, BytesInUnicodeString)
# MultiByteString : LPSTR out -> "char*"
# MaxBytesInMultiByteString : DWORD -> "dword"
# BytesInMultiByteString : DWORD* optional, out -> "void*"
# UnicodeString : LPWSTR -> "char*"
# BytesInUnicodeString : DWORD -> "dword"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。const std = @import("std");
extern "gdi32" fn EngUnicodeToMultiByteN(
MultiByteString: [*c]u8, // LPSTR out
MaxBytesInMultiByteString: u32, // DWORD
BytesInMultiByteString: [*c]u32, // DWORD* optional, out
UnicodeString: [*c]const u16, // LPWSTR
BytesInUnicodeString: u32 // DWORD
) callconv(std.os.windows.WINAPI) void;proc EngUnicodeToMultiByteN(
MultiByteString: ptr char, # LPSTR out
MaxBytesInMultiByteString: uint32, # DWORD
BytesInMultiByteString: ptr uint32, # DWORD* optional, out
UnicodeString: WideCString, # LPWSTR
BytesInUnicodeString: uint32 # DWORD
) {.importc: "EngUnicodeToMultiByteN", stdcall, dynlib: "GDI32.dll".}pragma(lib, "gdi32");
extern(Windows)
void EngUnicodeToMultiByteN(
char* MultiByteString, // LPSTR out
uint MaxBytesInMultiByteString, // DWORD
uint* BytesInMultiByteString, // DWORD* optional, out
const(wchar)* UnicodeString, // LPWSTR
uint BytesInUnicodeString // DWORD
);ccall((:EngUnicodeToMultiByteN, "GDI32.dll"), stdcall, Cvoid,
(Ptr{UInt8}, UInt32, Ptr{UInt32}, Cwstring, UInt32),
MultiByteString, MaxBytesInMultiByteString, BytesInMultiByteString, UnicodeString, BytesInUnicodeString)
# MultiByteString : LPSTR out -> Ptr{UInt8}
# MaxBytesInMultiByteString : DWORD -> UInt32
# BytesInMultiByteString : DWORD* optional, out -> Ptr{UInt32}
# UnicodeString : LPWSTR -> Cwstring
# BytesInUnicodeString : DWORD -> UInt32
# stdcall は 32bit のみ意味を持つ(x64 では無視)。local ffi = require("ffi")
ffi.cdef[[
void EngUnicodeToMultiByteN(
char* MultiByteString,
uint32_t MaxBytesInMultiByteString,
uint32_t* BytesInMultiByteString,
const uint16_t* UnicodeString,
uint32_t BytesInUnicodeString);
]]
local gdi32 = ffi.load("gdi32")
-- gdi32.EngUnicodeToMultiByteN(MultiByteString, MaxBytesInMultiByteString, BytesInMultiByteString, UnicodeString, BytesInUnicodeString)
-- MultiByteString : LPSTR out
-- MaxBytesInMultiByteString : DWORD
-- BytesInMultiByteString : DWORD* optional, out
-- UnicodeString : LPWSTR
-- BytesInUnicodeString : DWORD
-- 構造体/GUIDへのポインタは cdef が通るよう void* で表記(実型は各引数コメント参照)。値渡し構造体・enum は対応する typedef を cdef に追加すること。const koffi = require('koffi');
const lib = koffi.load('GDI32.dll');
const EngUnicodeToMultiByteN = lib.func('__stdcall', 'EngUnicodeToMultiByteN', 'void', ['char *', 'uint32_t', 'uint32_t *', 'str16', 'uint32_t']);
// EngUnicodeToMultiByteN(MultiByteString, MaxBytesInMultiByteString, BytesInMultiByteString, UnicodeString, BytesInUnicodeString)
// MultiByteString : LPSTR out -> 'char *'
// MaxBytesInMultiByteString : DWORD -> 'uint32_t'
// BytesInMultiByteString : DWORD* optional, out -> 'uint32_t *'
// UnicodeString : LPWSTR -> 'str16'
// BytesInUnicodeString : DWORD -> 'uint32_t'
// 出力ポインタは koffi.out(...) で包む。構造体は koffi.struct で定義。const lib = Deno.dlopen("GDI32.dll", {
EngUnicodeToMultiByteN: { parameters: ["buffer", "u32", "pointer", "buffer", "u32"], result: "void" },
});
// lib.symbols.EngUnicodeToMultiByteN(MultiByteString, MaxBytesInMultiByteString, BytesInMultiByteString, UnicodeString, BytesInUnicodeString)
// MultiByteString : LPSTR out -> "buffer"
// MaxBytesInMultiByteString : DWORD -> "u32"
// BytesInMultiByteString : DWORD* optional, out -> "pointer"
// UnicodeString : LPWSTR -> "buffer"
// BytesInUnicodeString : DWORD -> "u32"
// 文字列引数は "buffer"(NUL 終端のバイト列を Uint8Array で渡す)。
// 値渡し構造体は { struct: [ ...field types... ] } を使用。<?php
$ffi = FFI::cdef(<<<C
void EngUnicodeToMultiByteN(
char* MultiByteString,
uint32_t MaxBytesInMultiByteString,
uint32_t* BytesInMultiByteString,
const uint16_t* UnicodeString,
uint32_t BytesInUnicodeString);
C, "GDI32.dll");
// $ffi->EngUnicodeToMultiByteN(MultiByteString, MaxBytesInMultiByteString, BytesInMultiByteString, UnicodeString, BytesInUnicodeString);
// MultiByteString : LPSTR out
// MaxBytesInMultiByteString : DWORD
// BytesInMultiByteString : DWORD* optional, out
// UnicodeString : LPWSTR
// BytesInUnicodeString : DWORD
// 構造体/GUIDへのポインタは cdef が通るよう void* で表記(実型は各引数コメント参照)。値渡し構造体・enum は対応する typedef を cdef に追加すること。
// WINAPI(stdcall): x64 では呼出規約が統一されるため問題なし。x86 では __stdcall 対応のラッパが必要な場合あり。import com.sun.jna.*;
import com.sun.jna.ptr.*;
import com.sun.jna.win32.StdCallLibrary;
import com.sun.jna.win32.W32APIOptions;
public interface Gdi32 extends StdCallLibrary {
Gdi32 INSTANCE = Native.load("gdi32", Gdi32.class);
void EngUnicodeToMultiByteN(
byte[] MultiByteString, // LPSTR out
int MaxBytesInMultiByteString, // DWORD
IntByReference BytesInMultiByteString, // DWORD* optional, out
WString UnicodeString, // LPWSTR
int BytesInUnicodeString // DWORD
);
}@[Link("gdi32")]
lib LibGDI32
fun EngUnicodeToMultiByteN = EngUnicodeToMultiByteN(
MultiByteString : UInt8*, # LPSTR out
MaxBytesInMultiByteString : UInt32, # DWORD
BytesInMultiByteString : UInt32*, # DWORD* optional, out
UnicodeString : UInt16*, # LPWSTR
BytesInUnicodeString : UInt32 # DWORD
) : Void
end
# 構造体/GUID/enum は lib 内に対応する型定義が必要。
# 呼出規約: x64 は規約統一のため OK。x86(32bit)は WINAPI=stdcall だが Crystal の fun に stdcall 付与構文がなく非対応。import 'dart:ffi';
import 'package:ffi/ffi.dart';
typedef EngUnicodeToMultiByteNNative = Void Function(Pointer<Utf8>, Uint32, Pointer<Uint32>, Pointer<Utf16>, Uint32);
typedef EngUnicodeToMultiByteNDart = void Function(Pointer<Utf8>, int, Pointer<Uint32>, Pointer<Utf16>, int);
final EngUnicodeToMultiByteN = DynamicLibrary.open('GDI32.dll')
.lookupFunction<EngUnicodeToMultiByteNNative, EngUnicodeToMultiByteNDart>('EngUnicodeToMultiByteN');
// MultiByteString : LPSTR out -> Pointer<Utf8>
// MaxBytesInMultiByteString : DWORD -> Uint32
// BytesInMultiByteString : DWORD* optional, out -> Pointer<Uint32>
// UnicodeString : LPWSTR -> Pointer<Utf16>
// BytesInUnicodeString : DWORD -> Uint32
// 文字列は package:ffi の "...".toNativeUtf16()/toNativeUtf8() で変換。{$mode objfpc}{$H+}
procedure EngUnicodeToMultiByteN(
MultiByteString: PAnsiChar; // LPSTR out
MaxBytesInMultiByteString: DWORD; // DWORD
BytesInMultiByteString: Pointer; // DWORD* optional, out
UnicodeString: PWideChar; // LPWSTR
BytesInUnicodeString: DWORD // DWORD
); stdcall;
external 'GDI32.dll' name 'EngUnicodeToMultiByteN';import Foreign
import Foreign.C.Types
import Foreign.C.String
foreign import stdcall safe "EngUnicodeToMultiByteN"
c_EngUnicodeToMultiByteN :: CString -> Word32 -> Ptr Word32 -> CWString -> Word32 -> IO ()
-- MultiByteString : LPSTR out -> CString
-- MaxBytesInMultiByteString : DWORD -> Word32
-- BytesInMultiByteString : DWORD* optional, out -> Ptr Word32
-- UnicodeString : LPWSTR -> CWString
-- BytesInUnicodeString : DWORD -> Word32
-- 要 GHC(Windows)。stdcall は x64 では ccall として扱われる。ブロックする API は safe 呼び出し推奨。open Ctypes
open Foreign
let engunicodetomultibyten =
foreign "EngUnicodeToMultiByteN"
(string @-> uint32_t @-> (ptr uint32_t) @-> (ptr uint16_t) @-> uint32_t @-> returning void)
(* MultiByteString : LPSTR out -> string *)
(* MaxBytesInMultiByteString : DWORD -> uint32_t *)
(* BytesInMultiByteString : DWORD* optional, out -> (ptr uint32_t) *)
(* UnicodeString : LPWSTR -> (ptr uint16_t) *)
(* BytesInUnicodeString : DWORD -> uint32_t *)
(* foreign は cdecl 前提。x64 Windows では WINAPI と一致。構造体は ctypes structure を定義のこと。 *)(cffi:define-foreign-library gdi32 (t "GDI32.dll"))
(cffi:use-foreign-library gdi32)
(cffi:defcfun ("EngUnicodeToMultiByteN" eng-unicode-to-multi-byte-n :convention :stdcall) :void
(multi-byte-string :pointer) ; LPSTR out
(max-bytes-in-multi-byte-string :uint32) ; DWORD
(bytes-in-multi-byte-string :pointer) ; DWORD* optional, out
(unicode-string (:string :encoding :utf-16le)) ; LPWSTR
(bytes-in-unicode-string :uint32)) ; DWORD
; isize/usize(INT_PTR/SIZE_T)は x64 前提で :int64/:uint64。x86 では :int32/:uint32。use Win32::API;
my $EngUnicodeToMultiByteN = Win32::API::More->new('GDI32',
'void EngUnicodeToMultiByteN(LPSTR MultiByteString, DWORD MaxBytesInMultiByteString, LPVOID BytesInMultiByteString, LPCWSTR UnicodeString, DWORD BytesInUnicodeString)');
# my $ret = $EngUnicodeToMultiByteN->Call($MultiByteString, $MaxBytesInMultiByteString, $BytesInMultiByteString, $UnicodeString, $BytesInUnicodeString);
# MultiByteString : LPSTR out -> LPSTR
# MaxBytesInMultiByteString : DWORD -> DWORD
# BytesInMultiByteString : DWORD* optional, out -> LPVOID
# UnicodeString : LPWSTR -> LPCWSTR
# BytesInUnicodeString : DWORD -> DWORD
# 値渡し構造体は pack() した文字列、または Win32::API::Struct を使用。