AS_Layer.String_Encoding (Acrobat)

	Typedef
	ASHostEncoding (Macintosh, Windows) An integer specifying the host encoding for text. On Mac OS, it is a script code. On Windows, it is a CHARSET id. In UNIX, Acrobat currently only supports English, so the only valid ASHostEncoding is 0 (Roman). See ASScript.
	ASHostEncoding (UNIX) An integer specifying the host encoding for text. On Mac OS, it is a script code. On Windows, it is a CHARSET id. In UNIX, Acrobat currently only supports English, so the only valid ASHostEncoding is 0 (Roman). See ASScript.

	Enumeration
	`ASScript` An enumeration of writing scripts. Not all of these scripts are supported on all platforms.

	Method
	ASInt32 ASHostMBLen(ASHostEncoding encoding, ASUns8 byte) Determines whether the given byte is a lead byte of a multi-byte character, and how many tail bytes follow.
	ASBool ASIsValidUTF8(const ASUns8* cIn, ASCount cInLen) Tests whether the bytes in the string conform to the Unicode UTF-8 encoding form. The method does not test whether the string is NULL-terminated.
	ASScript ASScriptFromHostEncoding(ASHostEncoding osScript) Converts from a host encoding type to an ASScript value. On Windows, the host encoding is a CHARSET id. On Mac OS, the host encoding is a script code.
	ASHostEncoding ASScriptToHostEncoding(ASScript asScript) Converts from an ASScript code to a host encoding type. On Windows, the host encoding is a CHARSET id. On Mac OS, the host encoding is a script code.

Product availability: Acrobat, Reader, PDFL

Platform availability: Macintosh, Windows

Syntax

typedef ASInt32 ASHostEncoding;

An integer specifying the host encoding for text. On Mac OS, it is a script code. On Windows, it is a CHARSET id. In UNIX, Acrobat currently only supports English, so the only valid ASHostEncoding is 0 (Roman). See ASScript.

File: ASExpT.h

Line: 3872

Product availability: Acrobat, Reader, PDFL

Platform availability: UNIX

Syntax

typedef struct _t_ASHostEncoding* ASHostEncoding;

An integer specifying the host encoding for text. On Mac OS, it is a script code. On Windows, it is a CHARSET id. In UNIX, Acrobat currently only supports English, so the only valid ASHostEncoding is 0 (Roman). See ASScript.

File: ASExpT.h

Line: 3870

Product availability: All

Platform availability: All

Syntax

enum ASScript {

  kASRomanScript,


 


  kASJapaneseScript,


 


  kASTraditionalChineseScript,


 


  kASKoreanScript,


 


  kASArabicScript,


 


  kASHebrewScript,


 


  kASGreekScript,


 


  kASCyrillicScript,


 


  kASRightLeftScript,


 


  kASDevanagariScript,


 


  kASGurmukhiScript,


 


  kASGujaratiScript,


 


  kASOriyaScript,


 


  kASBengaliScript,


 


  kASTamilScript,


 


  kASTeluguScript,


 


  kASKannadaScript,


 


  kASMalayalamScript,


 


  kASSinhaleseScript,


 


  kASBurmeseScript,


 


  kASKhmerScript,


 


  kASThaiScript,


 


  kASLaotianScript,


 


  kASGeorgianScript,


 


  kASArmenianScript,


 


  kASSimplifiedChineseScript,


 


  kASTibetanScript,


 


  kASMongolianScript,


 


  kASGeezScript,


 


  kASEastEuropeanRomanScript,


 


  kASVietnameseScript,


 


  kASExtendedArabicScript,


 


  kASEUnicodeScript,


 


  kASDontKnowScript = -1

}

File: ASExpT.h

Line: 3902

Elements

	kASRomanScript	Roman.

	kASJapaneseScript	Japanese.

	kASTraditionalChineseScript	Traditional Chinese.

	kASKoreanScript	Korean.

	kASArabicScript	Arabic.

	kASHebrewScript	Hebrew.

	kASGreekScript	Greek.

	kASCyrillicScript	Cyrillic.

	kASRightLeftScript	RightLeft.

	kASDevanagariScript	Devanagari.

	kASGurmukhiScript	Gurmukhi.

	kASGujaratiScript	Gujarati.

	kASOriyaScript	Oriya.

	kASBengaliScript	Bengali.

	kASTamilScript	Tamil.

	kASTeluguScript	Telugu.

	kASKannadaScript	Kannada.

	kASMalayalamScript	Malayalam.

	kASSinhaleseScript	Sinhalese.

	kASBurmeseScript	Burmese.

	kASKhmerScript	Khmer

	kASThaiScript	Thai

	kASLaotianScript	Laotian.

	kASGeorgianScript	Georgian.

	kASArmenianScript	Armenian.

	kASSimplifiedChineseScript	Simplified Chinese.

	kASTibetanScript	Tibetan.

	kASMongolianScript	Mongolian.

	kASGeezScript	Ge'ez.

	kASEastEuropeanRomanScript	East European Roman.

	kASVietnameseScript	Vietnamese.

	kASExtendedArabicScript	Extended Arabic.

	kASEUnicodeScript	Unicode.

	kASDontKnowScript	Unknown.

Product availability: All

Platform availability: All

Syntax





ASInt32 ASHostMBLen(ASHostEncoding encoding, ASUns8 byte)

Determines whether the given byte is a lead byte of a multi-byte character, and how many tail bytes follow.

When parsing a string in a host encoding, you must keep in mind that the string could be in a variable length multi-byte encoding. In such an encoding (for example, Shift-JIS) the number of bytes required to represent a character varies on a character-by-character basis. To parse such a string you must start at the beginning and, for each byte, determine whether that byte represents a character or is the first byte of a multi-byte character. If the byte is a lead byte for a multi-byte character, you must also compute how many bytes will follow the lead byte to make up the entire character. Currently the API provides a call (PDHostMBLen()) that performs these computations, but only if the encoding in question is the operating system encoding (as returned by PDGetHostEncoding()). ASHostMBLen() allows you to determine this for any byte in any host encoding.

Parameters

	`encoding` —	The host encoding type.

	`byte` —	The first byte of a multi-byte character.

Returns

The number of additional bytes required to form the character. For example, if the encoding is a double-byte encoding, the return value will be 1 for a two-byte character and 0 for a one-byte character. For Roman encodings, the return value will always be 0.

Acrobat API Reference	All Layers \| All Objects \| Index \| Samples \| Frames No Frames
String_Encoding	Typedefs \| Enumerations \| Methods

	kASRomanScript,

	kASJapaneseScript,

	kASTraditionalChineseScript,

	kASKoreanScript,

	kASArabicScript,

	kASHebrewScript,

	kASGreekScript,

	kASCyrillicScript,

	kASRightLeftScript,

	kASDevanagariScript,

	kASGurmukhiScript,

	kASGujaratiScript,

	kASOriyaScript,

	kASBengaliScript,

	kASTamilScript,

	kASTeluguScript,

	kASKannadaScript,

	kASMalayalamScript,

	kASSinhaleseScript,

	kASBurmeseScript,

	kASKhmerScript,

	kASThaiScript,

	kASLaotianScript,

	kASGeorgianScript,

	kASArmenianScript,

	kASSimplifiedChineseScript,

	kASTibetanScript,

	kASMongolianScript,

	kASGeezScript,

	kASEastEuropeanRomanScript,

	kASVietnameseScript,

	kASExtendedArabicScript,

	kASEUnicodeScript,

	kASDontKnowScript = -1

	`cIn` —	The string.

	`cInLen` —	The length of the string in bytes, not including the `NULL` byte at the end.

Layer	AS_Layer
Object	String_Encoding