Admin

name	type	size	perms	modified	actions
[parent directory]
all/	dir	-	0755	2026-08-19 08:37:51
break/	dir	-	0755	2026-08-19 08:37:51
cal/	dir	-	0755	2026-08-19 08:37:51
case/	dir	-	0755	2026-08-19 08:37:51
citer/	dir	-	0755	2026-08-19 08:37:51
coll/	dir	-	0755	2026-08-19 08:37:51
csdet/	dir	-	0755	2026-08-19 08:37:51
date/	dir	-	0755	2026-08-19 08:37:51
datecal/	dir	-	0755	2026-08-19 08:37:51
datefmt/	dir	-	0755	2026-08-19 08:37:51
dtitvfmtsample/	dir	-	0755	2026-08-19 08:37:51
dtptngsample/	dir	-	0755	2026-08-19 08:37:51
layout/	dir	-	0755	2026-08-19 08:37:51
legacy/	dir	-	0755	2026-08-19 08:37:51
msgfmt/	dir	-	0755	2026-08-19 08:37:51
numfmt/	dir	-	0755	2026-08-19 08:37:51
plurfmtsample/	dir	-	0755	2026-08-19 08:37:51
props/	dir	-	0755	2026-08-19 08:37:51
strsrch/	dir	-	0755	2026-08-19 08:37:51
translit/	dir	-	0755	2026-08-19 08:37:51
uciter8/	dir	-	0755	2026-08-19 08:37:51
ucnv/	dir	-	0755	2026-08-19 08:37:51
udata/	dir	-	0755	2026-08-19 08:37:51
ufortune/	dir	-	0755	2026-08-19 08:37:51
ugrep/	dir	-	0755	2026-08-19 08:37:51
uresb/	dir	-	0755	2026-08-19 08:37:51
ustring/	dir	-	0755	2026-08-19 08:37:51
defs.mk	file	1,184 B	0644	2023-12-11 22:27:41	edit
Makefile	file	3,100 B	0644	2025-07-08 00:00:00	edit
Makefile.in	file	3,112 B	0644	2023-12-11 22:27:41	edit
readme.txt	file	3,180 B	0644	2023-12-11 22:27:41	edit
rules.mk	file	1,294 B	0644	2023-12-11 22:27:41	edit

editing: readme.txt

## Copyright (C) 2016 and later: Unicode, Inc. and others.
## License & terms of use: http://www.unicode.org/copyright.html
##
## Copyright (c) 2002-2010, International Business Machines Corporation 
## and others. All Rights Reserved.

This directory contains sample code using ICU4C routines. Below is a
short description of the contents of this directory.

break   - demonstrates how to use BreakIterators in C and C++.

cal     - prints out a calendar.

case    - demonstrates how to do Unicode case conversion in C and C++.

coll    - shows how collation compares strings

csdet   -  demonstrates using ICU's CharSet Detection API

date    - prints out the current date, localized.

datecal - demonstrates how a calendar object provides information
    
datefmt - an exercise using the date formatting API

dtitvfmtsample - shows how date interval format uses predefined skeletons

dtptngsample - uses DateTimePatternGenerator to create customized date/time pattern
       
layout   - demonstrates the ICU LayoutEngine (obsolete)

legacy   - demonstrates using two versions of ICU in one application (obsolete)

msgfmt   - demonstrates the use of the Message Format

numfmt   - demonstrates the use of the number format

plurfmtsample - uses PluralFormat and Messageformat to get Plural Form
    
props    - demonstrates the use of Unicode properties

strsrch - demonstrates how to search for patterns in Unicode text using the usearch interface.

translit - demonstrates the use of ICU transliteration

uciter8 - demonstrates how to leniently read 8-bit Unicode text.

ucnv     - demonstrates the use of ICU codepage conversion

udata    - demonstrates the use of ICU low level data routines (reader/writer in 'all' MSVC solution)

ufortune - demonstrates packaging and use of resources in an application

ugrep    - demonstrates ICU Regular Expressions.

uresb    - demonstrates building and loading resource bundles

ustring  - demonstrates ICU string manipulation functions

==
* Where can I find more sample code?

- The "uconv" utility is a full-featured command line application.
   It is normally built with ICU, and is located in icu/source/extra/uconv

- The "icu-demos" contains other applications and libraries not
   included with ICU.  You can check it out from https://github.com/unicode-org/icu-demos
   using github clone. See the README file for additional information.

==
* How do I build the samples?

- See the Readme in each subdirectory

To build all samples at once:

Windows MSVC:   
            - build ICU
	    - open 'all' project file in 'all' subdirectory
            - build project
            - sample executables will be located in /x86/Debug folders of each sample subdirectory

Unix:   - build and install (make install) ICU
            - be sure 'icu-config' is accessible from the PATH
            - type 'make all-samples' from this directory 
               (other targets:  clean-samples, check-samples)
      Note: 'make all-samples' won't work correctly in out of source builds.

Note that legacy and layout are obsolete samples that may not compile or run without
            adjustments to their makefiles.

cancel