Win32 API 日本語リファレンス
ホームGlobalization › CURRENCYFMTW

CURRENCYFMTW

構造体
サイズx64: 48 バイト / x86: 32 バイト

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

フィールド

フィールドサイズx64x86説明
NumDigitsDWORD4+0+0小数部の桁数です。この数値は LOCALE_ICURRDIGITS と等価です。
LeadingZeroDWORD4+4+4小数フィールドで先頭に 0 を使用するかどうかを示す値です。この値は LOCALE_ILZERO と等価です。
GroupingDWORD4+8+8

lpDecimalSep で指定された小数点区切り記号の左側にある、数字の各グループの桁数です。最上位の桁は、小数点区切り記号の直前にある最下位グループの桁数を示します。以降の各桁は、直前のグループのさらに左側にある次のグループの桁数を示します。最後に指定された値が 0 でない場合、残りのグループは最後のグループを繰り返します。このメンバーの代表的な設定例は次のとおりです: 123456789.00 のように区切る場合は 0、123,456,789.00 のように区切る場合は 3、12,34,56,789.00 のように区切る場合は 32 です。

代表的な設定以外の値も使用できますが、それらはコントロール パネルの地域と言語の設定には表示されません。そのような設定は極めてまれであり、予期しない結果になる可能性があります。
lpDecimalSepLPWSTR8/4+16+12null 終端の小数点区切り記号文字列へのポインターです。
lpThousandSepLPWSTR8/4+24+16null 終端の 3 桁区切り記号文字列へのポインターです。
NegativeOrderDWORD4+32+20負の通貨の書式モードです。このモードは LOCALE_INEGCURR と等価です。
PositiveOrderDWORD4+36+24正の通貨の書式モードです。このモードは LOCALE_ICURRENCY と等価です。
lpCurrencySymbolLPWSTR8/4+40+28null 終端の通貨記号文字列へのポインターです。

公式ドキュメント

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

解説(Remarks)

メモ

winnls.h ヘッダーは CURRENCYFMT をエイリアスとして定義しており、UNICODE プリプロセッサ定数の定義に応じて、この関数の ANSI 版と Unicode 版が自動的に選択されます。エンコーディング中立のエイリアスと、エンコーディング中立でないコードを混在させると不一致が生じ、コンパイル エラーや実行時エラーの原因となる可能性があります。詳細については、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>

// CURRENCYFMTW  (x64 48 / x86 32 バイト)
typedef struct CURRENCYFMTW {
    DWORD NumDigits;
    DWORD LeadingZero;
    DWORD Grouping;
    LPWSTR lpDecimalSep;
    LPWSTR lpThousandSep;
    DWORD NegativeOrder;
    DWORD PositiveOrder;
    LPWSTR lpCurrencySymbol;
} CURRENCYFMTW;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct CURRENCYFMTW
{
    public uint NumDigits;
    public uint LeadingZero;
    public uint Grouping;
    public IntPtr lpDecimalSep;
    public IntPtr lpThousandSep;
    public uint NegativeOrder;
    public uint PositiveOrder;
    public IntPtr lpCurrencySymbol;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure CURRENCYFMTW
    Public NumDigits As UInteger
    Public LeadingZero As UInteger
    Public Grouping As UInteger
    Public lpDecimalSep As IntPtr
    Public lpThousandSep As IntPtr
    Public NegativeOrder As UInteger
    Public PositiveOrder As UInteger
    Public lpCurrencySymbol As IntPtr
End Structure
import ctypes
from ctypes import wintypes

class CURRENCYFMTW(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),
        ("PositiveOrder", wintypes.DWORD),
        ("lpCurrencySymbol", ctypes.c_void_p),
    ]
#[repr(C)]
pub struct CURRENCYFMTW {
    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,
    pub PositiveOrder: u32,
    pub lpCurrencySymbol: *mut core::ffi::c_void,
}
import "golang.org/x/sys/windows"

type CURRENCYFMTW struct {
	NumDigits uint32
	LeadingZero uint32
	Grouping uint32
	lpDecimalSep uintptr
	lpThousandSep uintptr
	NegativeOrder uint32
	PositiveOrder uint32
	lpCurrencySymbol uintptr
}
type
  CURRENCYFMTW = record
    NumDigits: DWORD;
    LeadingZero: DWORD;
    Grouping: DWORD;
    lpDecimalSep: Pointer;
    lpThousandSep: Pointer;
    NegativeOrder: DWORD;
    PositiveOrder: DWORD;
    lpCurrencySymbol: Pointer;
  end;
const CURRENCYFMTW = extern struct {
    NumDigits: u32,
    LeadingZero: u32,
    Grouping: u32,
    lpDecimalSep: ?*anyopaque,
    lpThousandSep: ?*anyopaque,
    NegativeOrder: u32,
    PositiveOrder: u32,
    lpCurrencySymbol: ?*anyopaque,
};
type
  CURRENCYFMTW {.bycopy.} = object
    NumDigits: uint32
    LeadingZero: uint32
    Grouping: uint32
    lpDecimalSep: pointer
    lpThousandSep: pointer
    NegativeOrder: uint32
    PositiveOrder: uint32
    lpCurrencySymbol: pointer
struct CURRENCYFMTW
{
    uint NumDigits;
    uint LeadingZero;
    uint Grouping;
    void* lpDecimalSep;
    void* lpThousandSep;
    uint NegativeOrder;
    uint PositiveOrder;
    void* lpCurrencySymbol;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; CURRENCYFMTW サイズ: 32 バイト(x86)
dim st, 8    ; 4byte整数×8(構造体サイズ 32 / 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 も可)
; PositiveOrder : DWORD (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; lpCurrencySymbol : LPWSTR (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; CURRENCYFMTW サイズ: 48 バイト(x64)
dim st, 12    ; 4byte整数×12(構造体サイズ 48 / 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 も可)
; PositiveOrder : DWORD (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; lpCurrencySymbol : LPWSTR (+40, 8byte)  qpoke st,40,値 / qpeek(st,40)  ※IronHSPのみ。3.7/3.8は lpoke st,40,下位 : lpoke st,44,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global CURRENCYFMTW
    #field int NumDigits
    #field int LeadingZero
    #field int Grouping
    #field intptr lpDecimalSep
    #field intptr lpThousandSep
    #field int NegativeOrder
    #field int PositiveOrder
    #field intptr lpCurrencySymbol
#endstruct

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