P4CHARSET

Description

Character set used for translation of unicode files.

Usage Notes

Used by Client?

Used by Server?

Command-Line Alternative

Can be set in P4CONFIG file?

Yes

No

p4 -C charset cmd

Yes

Value if not Explicitly Set

Operating System

Value

All

None. If the Perforce service is operating in unicode mode and P4CHARSET is unset, Perforce applications return an error message.

Notes

If the server is set to Unicode-mode, the client sets P4CHARSET to auto and examines the client's environment to determine the character set to use in converting files of type unicode. Thus, the only time you need to set P4CHARSET to a specific type is if the client's choice of charset results in a faulty conversion or if you have other special needs. For example, the application that uses the checked out files expects a specific character set.

P4CHARSET only affects files of type unicode and utf16; non-unicode files are never translated.

For Perforce services operating in the default (non-Unicode mode), P4CHARSET must be left unset (or set to none) on user workstations. If P4CHARSET is set, but the service is not operating in internationalized mode, the service returns the following error message:

Unicode clients require a unicode enabled server.

For Perforce services operating in Unicode mode, P4CHARSET must either be set to auto or be set to some value (other than none) on user machines. If P4CHARSET is unset, but the service is operating in Unicode mode, Perforce applications return the following error message:

Unicode server permits only unicode enabled clients.

For more about Unicode mode, including settings of P4CHARSET for various UTF-8, UTF-16, and UTF-32 character sets, with and without byte-order marks, see the Internationalization Notes:

http://www.perforce.com/perforce/r15.1/user/i18nnotes.txt

For a complete list of valid P4CHARSET values, issue the command p4 help charset.