NUMBERFMTW

構造体

サイズx64: 40 バイト / x86: 24 バイト

サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。

フィールド

フィールド	型	サイズ	x64	x86	説明
NumDigits	DWORD	4	+0	+0	小数部の桁数。この値は、値 LOCALE_IDIGITS で指定されるロケール情報と同等です。
LeadingZero	DWORD	4	+4	+4	小数部のフィールドで先行ゼロを使用するかどうかを示す値。この値は、値 LOCALE_ILZERO で指定されるロケール情報と同等です。
Grouping	DWORD	4	+8	+8	lpDecimalSep で指定される小数点記号の左側にある、数値の各グループの桁数。0 から 9 までの値および 32 が有効です。最上位のグループ化桁は、小数点記号のすぐ左にある最下位グループの桁数を示します。以降の各グループ化桁は、直前のグループの左側にある次のグループの桁数を示します。指定された最後の値が 0 でない場合、残りのグループは最後のグループを繰り返します。このメンバーの設定の代表的な例は次のとおりです。123456789.00 のように桁をグループ化する場合は 0、123,456,789.00 のように桁をグループ化する場合は 3、12,34,56,789.00 のように桁をグループ化する場合は 32 です。 Note 代表的な設定以外の設定も使用できますが、それらはコントロールパネルの地域と言語のオプションの部分には表示されません。そのような設定は極めてまれであり、予期しない結果になる可能性があります。
lpDecimalSep	LPWSTR	8/4	+16	+12	null で終わる小数点記号の文字列へのポインター。
lpThousandSep	LPWSTR	8/4	+24	+16	null で終わる桁区切り記号の文字列へのポインター。
NegativeOrder	DWORD	4	+32	+20	負数モード。このモードは、値 LOCALE_INEGNUMBER で指定されるロケール情報と同等です。

公式ドキュメント

数値文字列の書式を定義する情報を格納します。GetNumberFormat 関数は、この情報を使用して、指定されたロケール向けに数値文字列をカスタマイズします。

解説(Remarks)

メモ

winnls.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI 版または Unicode 版を自動的に選択するエイリアスとして NUMBERFMT を定義します。エンコード中立のエイリアスの使用と、エンコード中立でないコードを混在させると、不一致が生じ、コンパイルエラーまたは実行時エラーの原因になることがあります。詳細については、「Conventions for Function Prototypes」を参照してください。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

#include <windows.h>

// NUMBERFMTW  (x64 40 / x86 24 バイト)
typedef struct NUMBERFMTW {
    DWORD NumDigits;
    DWORD LeadingZero;
    DWORD Grouping;
    LPWSTR lpDecimalSep;
    LPWSTR lpThousandSep;
    DWORD NegativeOrder;
} NUMBERFMTW;

using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct NUMBERFMTW
{
    public uint NumDigits;
    public uint LeadingZero;
    public uint Grouping;
    public IntPtr lpDecimalSep;
    public IntPtr lpThousandSep;
    public uint NegativeOrder;
}

Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure NUMBERFMTW
    Public NumDigits As UInteger
    Public LeadingZero As UInteger
    Public Grouping As UInteger
    Public lpDecimalSep As IntPtr
    Public lpThousandSep As IntPtr
    Public NegativeOrder As UInteger
End Structure

import ctypes
from ctypes import wintypes

class NUMBERFMTW(ctypes.Structure):
    _fields_ = [
        ("NumDigits", wintypes.DWORD),
        ("LeadingZero", wintypes.DWORD),
        ("Grouping", wintypes.DWORD),
        ("lpDecimalSep", ctypes.c_void_p),
        ("lpThousandSep", ctypes.c_void_p),
        ("NegativeOrder", wintypes.DWORD),
    ]

#[repr(C)]
pub struct NUMBERFMTW {
    pub NumDigits: u32,
    pub LeadingZero: u32,
    pub Grouping: u32,
    pub lpDecimalSep: *mut core::ffi::c_void,
    pub lpThousandSep: *mut core::ffi::c_void,
    pub NegativeOrder: u32,
}

import "golang.org/x/sys/windows"

type NUMBERFMTW struct {
	NumDigits uint32
	LeadingZero uint32
	Grouping uint32
	lpDecimalSep uintptr
	lpThousandSep uintptr
	NegativeOrder uint32
}

type
  NUMBERFMTW = record
    NumDigits: DWORD;
    LeadingZero: DWORD;
    Grouping: DWORD;
    lpDecimalSep: Pointer;
    lpThousandSep: Pointer;
    NegativeOrder: DWORD;
  end;

const NUMBERFMTW = extern struct {
    NumDigits: u32,
    LeadingZero: u32,
    Grouping: u32,
    lpDecimalSep: ?*anyopaque,
    lpThousandSep: ?*anyopaque,
    NegativeOrder: u32,
};

type
  NUMBERFMTW {.bycopy.} = object
    NumDigits: uint32
    LeadingZero: uint32
    Grouping: uint32
    lpDecimalSep: pointer
    lpThousandSep: pointer
    NegativeOrder: uint32

struct NUMBERFMTW
{
    uint NumDigits;
    uint LeadingZero;
    uint Grouping;
    void* lpDecimalSep;
    void* lpThousandSep;
    uint NegativeOrder;
}

HSP用定義

HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; NUMBERFMTW サイズ: 24 バイト(x86)
dim st, 6    ; 4byte整数×6(構造体サイズ 24 / 4 切り上げ)
; NumDigits : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; LeadingZero : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; Grouping : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; lpDecimalSep : LPWSTR (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; lpThousandSep : LPWSTR (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; NegativeOrder : DWORD (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; NUMBERFMTW サイズ: 40 バイト(x64)
dim st, 10    ; 4byte整数×10(構造体サイズ 40 / 4 切り上げ)
; NumDigits : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; LeadingZero : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; Grouping : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; lpDecimalSep : LPWSTR (+16, 8byte)  qpoke st,16,値 / qpeek(st,16)  ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; lpThousandSep : LPWSTR (+24, 8byte)  qpoke st,24,値 / qpeek(st,24)  ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; NegativeOrder : DWORD (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。

; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global NUMBERFMTW
    #field int NumDigits
    #field int LeadingZero
    #field int Grouping
    #field intptr lpDecimalSep
    #field intptr lpThousandSep
    #field int NegativeOrder
#endstruct

stdim st, NUMBERFMTW        ; NSTRUCT 変数を確保
st->NumDigits = 100
mes "NumDigits=" + st->NumDigits