text: /* /////////////////////////////////////////////////////////////////////////
   * File:        libpath/util/api.h
   *
   * Purpose:     Main include for libpath library's Parsing API .
   *
   * Created:     9th November 2012
   * Updated:     20th November 2016
   *
   * Home:        http://synesis.com.au/software/
   *
   * Copyright (c) 2012-2016, Matthew Wilson and Synesis Software
   * All rights reserved.
   *
   * Redistribution and use in source and binary forms, with or without
   * modification, are permitted provided that the following conditions are
   * met:
   *
   * - Redistributions of source code must retain the above copyright notice,
   *   this list of conditions and the following disclaimer.
   * - Redistributions in binary form must reproduce the above copyright
   *   notice, this list of conditions and the following disclaimer in the
   *   documentation and/or other materials provided with the distribution.
   * - Neither the name(s) of Matthew Wilson and Synesis Software nor the
   *   names of any contributors may be used to endorse or promote products
   *   derived from this software without specific prior written permission.
   *
   * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
   * IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
   * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
   * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
   * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
   * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
   * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
   * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
   * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
   * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
   * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
   *
   * ////////////////////////////////////////////////////////////////////// */
  
  
  #ifndef SYNSOFT_LIBPATH_INCL_libpath_util_H_api
  #define SYNSOFT_LIBPATH_INCL_libpath_util_H_api
  
  /* /////////////////////////////////////////////////////////////////////////
   * includes - 1
   */
  
  #include <libpath/util/types.h>
  #include <libpath/common/macros.h>
  #include <libpath/common/version.h>
  
  /* /////////////////////////////////////////////////////////////////////////
   * API functions
   */
  
  /** 
   *
   * \pre NULL != slices
   */
  LIBPATH_API
  libpath_Util_AllocateSliceArray(
      size_t                  numSlices
  ,   libpath_StringSlice_t** slices
  );
  
  LIBPATH_CALL(void)
  libpath_Util_FreeSliceArray(
      libpath_StringSlice_t*  slices
  );
  
  
  LIBPATH_CALL(libpath_StringSlice_t)
  libpath_Util_SliceFromCStyleString(
      libpath_char_t const*   css
  );
  
  LIBPATH_CALL(libpath_StringSlice_t)
  libpath_Util_SliceFromStringPtrAndLen(
      libpath_char_t const*   ptr
  ,   size_t                  len
  );
  
  /* /////////////////////////////////////////////////////////////////////////
   * includes - 2
   */
  
  #ifdef __cplusplus
  
  #endif /* __cplusplus */
  
  /* ////////////////////////////////////////////////////////////////////// */
  
  #endif /* !SYNSOFT_LIBPATH_INCL_libpath_util_H_api */
  
  /* ///////////////////////////// end of file //////////////////////////// */
  