root/intl/doc/normalizer_api.php

DEFINITIONS

1. normalize
2. isNormalized
3. normalizer_normalize
4. normalizer_is_normalized

<?php

#############################################################################
# Object-oriented API
#############################################################################

/**
 * Normalizer class.
 *
 * Normalizer provides access to Unicode normalization of strings. This class consists
 * only of static methods. The iterator interface to normalizer is rarely used, so is
 * not provided here.
 *
 * Example:
 * <code>
 *
 * </code>
 *
 * @see http://www.icu-project.org/apiref/icu4c/unorm_8h.html
 * @see http://www.icu-project.org/apiref/icu4c/classNormalizer.html
 *
 */
class Normalizer {
#############################################################################
# Common constants.
#############################################################################

        /**
         * Valid normalization form values.
         *
         * @see Normalizer::normalize()
         * @see Normalizer::isNormalize()
         * @see normalizer_normalize()
         * @see normalizer_is_normalized()
        */
        const NONE    = 1;
        /** Canonical decomposition. */
        const NFD = 2;
        const FORM_D  = NFD;
        /** Compatibility decomposition. */
        const NFKD = 3;
        const FORM_KD = NFKD;
        /** Canonical decomposition followed by canonical composition. */
        const NFC = 4;
        const FORM_C  = NFC;
        /** Compatibility decomposition followed by canonical composition. */
        const NFKC =5;
        const FORM_KC = NFKC;


        /**
         * Normalizes the input provided and returns the normalized string
         * @param   string     $input    The input string to normalize
         * @param   [int]      $form     One of the normalization forms
         * @return  string               The normalized string or null if an error occurred.
        */
        public static function normalize($input, $form = Normalizer::FORM_C) {}

        /**
         * Checks if the provided string is already in the specified normalization form.
         * @param  string    $input    The input string to normalize
         * @param  [int]     $form     One of the normalization forms
         * @return boolean             True if normalized, false otherwise or if there is an error
        */
        public static function isNormalized($input, $form = Normalizer::FORM_C) {}

}

#############################################################################
# Procedural API
#############################################################################

        /**
         * Normalizes the input provided and returns the normalized string
         * @param  string    $input    The input string to normalize
         * @param  [int]     $form     One of the normalization forms
         * @return string              The normalized string or null if an error occurred.
        */
        function normalizer_normalize($input, $form = Normalizer::FORM_C) {}

        /**
         * Checks if the provided string is already in the specified normalization form.
         * @param  string    $input    The input string to normalize
         * @param  [int]     $form     One of the normalization forms
         * @return boolean             True if normalized, false otherwise or if there an error
        */
        function normalizer_is_normalized($input, $form = Normalizer::FORM_C) {}


?>