CPINFO
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| MaxCharSize | DWORD | 4 | +0 | +0 | コード ページにおける 1 文字の最大長 (バイト単位)。この長さは、シングルバイト文字セット (SBCS) の場合は 1、ダブルバイト文字セット (DBCS) の場合は 2、それ以外の種類の文字セットの場合は 2 より大きい値になります。ISCII や ISO-2022-xx コード ページの使用といった他の要因があるため、この関数はこのサイズによって SBCS や DBCS を他の文字セットと区別することはできません。 |
| DefaultChar | BYTE | 2 | +4 | +4 | 文字列を特定のコード ページに変換するときに使用される既定の文字。明示的な既定の文字が指定されていない場合、この文字が WideCharToMultiByte 関数によって使用されます。既定値は通常、そのコード ページの "?" 文字です。 |
| LeadByte | BYTE | 12 | +6 | +6 | 先行バイトの範囲を格納する固定長の配列で、先行バイトの範囲の数は可変です。コード ページに先行バイトがない場合、配列のすべての要素は NULL に設定されます。コード ページに先行バイトがある場合、配列は各範囲の開始値と終了値を指定します。範囲は両端の値を含み、1 つのコード ページに対する範囲の最大数は 5 です。配列は各範囲を記述するために 2 バイトを使用し、最後の範囲の後には終端として 2 つのヌル バイトが置かれます。 メモ 一部のコード ページは、先行バイトと他のエンコード方式の組み合わせを使用します。このメンバーは通常、何らかの形で先行バイトを使用するコード ページの一部についてのみ設定されます。詳細については、「解説」セクションを参照してください。
|
公式ドキュメント
コード ページに関する情報を格納します。この構造体は GetCPInfo 関数によって使用されます。
解説(Remarks)
先行バイトは、256 文字を超える文字を扱える DBCS コード ページに固有のものです。先行バイトとは、DBCS における 2 バイト文字の最初のバイトです。各 DBCS コード ページでは、先行バイトは特定のバイト値の範囲を占めます。この範囲はコード ページごとに異なります。
先行バイトの情報は、ほとんどのコード ページではあまり役に立たず、UTF-8 や GB18030 など多くのマルチバイト エンコードでは提供すらされません。MultiByteToWideChar 関数や WideCharToMultiByte 関数の動作を予測するためにこの情報を使用することは推奨されません。先行バイトに続くバイトが想定どおりでない場合、これらの関数は既定の文字を使用したり、その他の既定の動作を行ったりすることがあります。
GetCPInfoEx 関数で使用される CPINFOEX は、この構造体の拡張版を提供します。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// CPINFO (x64 20 / x86 20 バイト)
typedef struct CPINFO {
DWORD MaxCharSize;
BYTE DefaultChar[2];
BYTE LeadByte[12];
} CPINFO;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct CPINFO
{
public uint MaxCharSize;
[MarshalAs(UnmanagedType.ByValArray, SizeConst = 2)] public byte[] DefaultChar;
[MarshalAs(UnmanagedType.ByValArray, SizeConst = 12)] public byte[] LeadByte;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure CPINFO
Public MaxCharSize As UInteger
<MarshalAs(UnmanagedType.ByValArray, SizeConst:=2)> Public DefaultChar() As Byte
<MarshalAs(UnmanagedType.ByValArray, SizeConst:=12)> Public LeadByte() As Byte
End Structureimport ctypes
from ctypes import wintypes
class CPINFO(ctypes.Structure):
_fields_ = [
("MaxCharSize", wintypes.DWORD),
("DefaultChar", ctypes.c_ubyte * 2),
("LeadByte", ctypes.c_ubyte * 12),
]#[repr(C)]
pub struct CPINFO {
pub MaxCharSize: u32,
pub DefaultChar: [u8; 2],
pub LeadByte: [u8; 12],
}import "golang.org/x/sys/windows"
type CPINFO struct {
MaxCharSize uint32
DefaultChar [2]byte
LeadByte [12]byte
}type
CPINFO = record
MaxCharSize: DWORD;
DefaultChar: array[0..1] of Byte;
LeadByte: array[0..11] of Byte;
end;const CPINFO = extern struct {
MaxCharSize: u32,
DefaultChar: [2]u8,
LeadByte: [12]u8,
};type
CPINFO {.bycopy.} = object
MaxCharSize: uint32
DefaultChar: array[2, uint8]
LeadByte: array[12, uint8]struct CPINFO
{
uint MaxCharSize;
ubyte[2] DefaultChar;
ubyte[12] LeadByte;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; CPINFO サイズ: 20 バイト(x64)
dim st, 5 ; 4byte整数×5(構造体サイズ 20 / 4 切り上げ)
; MaxCharSize : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; DefaultChar : BYTE (+4, 2byte) varptr(st)+4 を基点に操作(2byte:入れ子/配列)
; LeadByte : BYTE (+6, 12byte) varptr(st)+6 を基点に操作(12byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global CPINFO
#field int MaxCharSize
#field byte DefaultChar 2
#field byte LeadByte 12
#endstruct
stdim st, CPINFO ; NSTRUCT 変数を確保
st->MaxCharSize = 100
mes "MaxCharSize=" + st->MaxCharSize