/var/lib/jenkins/workspace/firefox-scan-build/mfbt/lz4/lz4hc.c

Bug Summary

File:	var/lib/jenkins/workspace/firefox-scan-build/mfbt/lz4/lz4hc.c
Warning:	line 1182, column 9 Null pointer passed as 1st argument to memory copy function
Annotated Source Code

Press '?' to see keyboard shortcuts
Show analyzer invocation
clang -cc1 -cc1 -triple x86_64-pc-linux-gnu -analyze -disable-free -clear-ast-before-backend -disable-llvm-verifier -discard-value-names -main-file-name lz4hc.c -analyzer-checker=core -analyzer-checker=apiModeling -analyzer-checker=unix -analyzer-checker=deadcode -analyzer-checker=security.insecureAPI.UncheckedReturn -analyzer-checker=security.insecureAPI.getpw -analyzer-checker=security.insecureAPI.gets -analyzer-checker=security.insecureAPI.mktemp -analyzer-checker=security.insecureAPI.mkstemp -analyzer-checker=security.insecureAPI.vfork -analyzer-checker=nullability.NullPassedToNonnull -analyzer-checker=nullability.NullReturnedFromNonnull -analyzer-output plist -w -setup-static-analyzer -analyzer-config-compatibility-mode=true -mrelocation-model pic -pic-level 2 -fhalf-no-semantic-interposition -mframe-pointer=all -relaxed-aliasing -ffp-contract=off -fno-rounding-math -mconstructor-aliases -funwind-tables=2 -target-cpu x86-64 -tune-cpu generic -debugger-tuning=gdb -fdebug-compilation-dir=/var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/mfbt -fcoverage-compilation-dir=/var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/mfbt -resource-dir /usr/lib/llvm-18/lib/clang/18 -include /var/lib/jenkins/workspace/firefox-scan-build/config/gcc_hidden.h -include /var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/mozilla-config.h -I /var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/dist/system_wrappers -U _FORTIFY_SOURCE -D _FORTIFY_SOURCE=2 -D DEBUG=1 -D IMPL_MFBT -D LZ4LIB_VISIBILITY= -D MOZ_SUPPORT_LEAKCHECKING -I /var/lib/jenkins/workspace/firefox-scan-build/mfbt -I /var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/mfbt -I /var/lib/jenkins/workspace/firefox-scan-build/mfbt/double-conversion -I /var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/dist/include -I /var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/dist/include/nspr -I /var/lib/jenkins/workspace/firefox-scan-build/obj-x86_64-pc-linux-gnu/dist/include/nss -D MOZILLA_CLIENT -internal-isystem /usr/lib/llvm-18/lib/clang/18/include -internal-isystem /usr/local/include -internal-isystem /usr/lib/gcc/x86_64-linux-gnu/14/../../../../x86_64-linux-gnu/include -internal-externc-isystem /usr/include/x86_64-linux-gnu -internal-externc-isystem /include -internal-externc-isystem /usr/include -O2 -Wno-error=tautological-type-limit-compare -Wno-range-loop-analysis -Wno-error=deprecated-declarations -Wno-error=array-bounds -Wno-error=free-nonheap-object -Wno-error=atomic-alignment -Wno-error=deprecated-builtins -Wno-psabi -Wno-error=builtin-macro-redefined -Wno-unknown-warning-option -std=gnu99 -ferror-limit 19 -stack-protector 2 -fstack-clash-protection -ftrivial-auto-var-init=pattern -fgnuc-version=4.2.1 -vectorize-loops -vectorize-slp -analyzer-checker optin.performance.Padding -analyzer-output=html -analyzer-config stable-report-filename=true -faddrsig -D__GCC_HAVE_DWARF2_CFI_ASM=1 -o /tmp/scan-build-2024-07-21-021012-413605-1 -x c /var/lib/jenkins/workspace/firefox-scan-build/mfbt/lz4/lz4hc.c
1/*
  LZ4 HC - High Compression Mode of LZ4
  Copyright (C) 2011-2020, Yann Collet.

  BSD 2-Clause License (http://www.opensource.org/licenses/bsd-license.php)

  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.

  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.

  You can contact the author at :
     - LZ4 source repository : https://github.com/lz4/lz4
     - LZ4 public forum : https://groups.google.com/forum/#!forum/lz4c
33*/
34/* note : lz4hc is not an independent module, it requires lz4.h/lz4.c for proper compilation */


37/* *************************************
38*  Tuning Parameter
39***************************************/

41/*! HEAPMODE :
*  Select how default compression function will allocate workplace memory,
*  in stack (0:fastest), or in heap (1:requires malloc()).
*  Since workplace is rather large, heap mode is recommended.
45**/
46#ifndef LZ4HC_HEAPMODE1
47#  define LZ4HC_HEAPMODE1 1
48#endif


51/*===    Dependency    ===*/
52#define LZ4_HC_STATIC_LINKING_ONLY
53#include "lz4hc.h"


56/*===   Common definitions   ===*/
57#if defined(__GNUC__4)
58#  pragma GCC diagnostic ignored "-Wunused-function"
59#endif
60#if defined (__clang__1)
61#  pragma clang diagnostic ignored "-Wunused-function"
62#endif

64#define LZ4_COMMONDEFS_ONLY
65#ifndef LZ4_SRC_INCLUDED1
66#include "lz4.c"   /* LZ4_count, constants, mem */
67#endif


70/*===   Enums   ===*/
71typedef enum { noDictCtx, usingDictCtxHc } dictCtx_directive;


74/*===   Constants   ===*/
75#define OPTIMAL_ML(int)((((1U<<4)-1)-1)+4) (int)((ML_MASK((1U<<4)-1)-1)+MINMATCH4)
76#define LZ4_OPT_NUM(1<<12)   (1<<12)


79/*===   Macros   ===*/
80#define MIN(a,b)( (a) < (b) ? (a) : (b) )   ( (a) < (b) ? (a) : (b) )
81#define MAX(a,b)( (a) > (b) ? (a) : (b) )   ( (a) > (b) ? (a) : (b) )
82#define HASH_FUNCTION(i)(((i) * 2654435761U) >> ((4*8)-15))         (((i) * 2654435761U) >> ((MINMATCH4*8)-LZ4HC_HASH_LOG15))
83#define DELTANEXTMAXD(p)chainTable[(p) & ((1<<16) - 1)]         chainTable[(p) & LZ4HC_MAXD_MASK((1<<16) - 1)]    /* flexible, LZ4HC_MAXD dependent */
84#define DELTANEXTU16(table, pos)table[(U16)(pos)] table[(U16)(pos)]   /* faster */
85/* Make fields passed to, and updated by LZ4HC_encodeSequence explicit */
86#define UPDATABLE(ip, op, anchor)&ip, &op, &anchor &ip, &op, &anchor

88static U32 LZ4HC_hashPtr(const void* ptr) { return HASH_FUNCTION(LZ4_read32(ptr))(((LZ4_read32(ptr)) * 2654435761U) >> ((4*8)-15)); }


91/**************************************
92*  HC Compression
93**************************************/
94static void LZ4HC_clearTables (LZ4HC_CCtx_internal* hc4)
95{
  MEM_INIT(hc4->hashTable, 0, sizeof(hc4->hashTable))memset(((hc4->hashTable)),((0)),((sizeof(hc4->hashTable
))));
  MEM_INIT(hc4->chainTable, 0xFF, sizeof(hc4->chainTable))memset(((hc4->chainTable)),((0xFF)),((sizeof(hc4->chainTable
))));
98}

100static void LZ4HC_init_internal (LZ4HC_CCtx_internal* hc4, const BYTE* start)
101{
  size_t const bufferSize = (size_t)(hc4->end - hc4->prefixStart);
  size_t newStartingOffset = bufferSize + hc4->dictLimit;
  assert(newStartingOffset >= bufferSize)((void)0);  /* check overflow */
  if (newStartingOffset > 1 GB*(1U<<30)) {
      LZ4HC_clearTables(hc4);
      newStartingOffset = 0;
  }
  newStartingOffset += 64 KB*(1 <<10);
  hc4->nextToUpdate = (U32)newStartingOffset;
  hc4->prefixStart = start;
  hc4->end = start;
  hc4->dictStart = start;
  hc4->dictLimit = (U32)newStartingOffset;
  hc4->lowLimit = (U32)newStartingOffset;
116}


119/* Update chains up to ip (excluded) */
120LZ4_FORCE_INLINEstatic inline __attribute__((always_inline)) void LZ4HC_Insert (LZ4HC_CCtx_internal* hc4, const BYTE* ip)
121{
  U16* const chainTable = hc4->chainTable;
  U32* const hashTable  = hc4->hashTable;
  const BYTE* const prefixPtr = hc4->prefixStart;
  U32 const prefixIdx = hc4->dictLimit;
  U32 const target = (U32)(ip - prefixPtr) + prefixIdx;
  U32 idx = hc4->nextToUpdate;
  assert(ip >= prefixPtr)((void)0);
  assert(target >= prefixIdx)((void)0);

  while (idx < target) {
      U32 const h = LZ4HC_hashPtr(prefixPtr+idx-prefixIdx);
      size_t delta = idx - hashTable[h];
      if (delta>LZ4_DISTANCE_MAX65535) delta = LZ4_DISTANCE_MAX65535;
      DELTANEXTU16(chainTable, idx)chainTable[(U16)(idx)] = (U16)delta;
      hashTable[h] = idx;
      idx++;
  }

  hc4->nextToUpdate = target;
141}

143/** LZ4HC_countBack() :
* @return : negative value, nb of common bytes before ip/match */
145LZ4_FORCE_INLINEstatic inline __attribute__((always_inline))
146int LZ4HC_countBack(const BYTE* const ip, const BYTE* const match,
                  const BYTE* const iMin, const BYTE* const mMin)
148{
  int back = 0;
  int const min = (int)MAX(iMin - ip, mMin - match)( (iMin - ip) > (mMin - match) ? (iMin - ip) : (mMin - match
) );
  assert(min <= 0)((void)0);
  assert(ip >= iMin)((void)0); assert((size_t)(ip-iMin) < (1U<<31))((void)0);
  assert(match >= mMin)((void)0); assert((size_t)(match - mMin) < (1U<<31))((void)0);
  while ( (back > min)
       && (ip[back-1] == match[back-1]) )
          back--;
  return back;
158}

160#if defined(_MSC_VER)
161#  define LZ4HC_rotl32(x,r)((x << r) | (x >> (32 - r))) _rotl(x,r)
162#else
163#  define LZ4HC_rotl32(x,r)((x << r) | (x >> (32 - r))) ((x << r) | (x >> (32 - r)))
164#endif


167static U32 LZ4HC_rotatePattern(size_t const rotate, U32 const pattern)
168{
  size_t const bitsToRotate = (rotate & (sizeof(pattern) - 1)) << 3;
  if (bitsToRotate == 0) return pattern;
  return LZ4HC_rotl32(pattern, (int)bitsToRotate)((pattern << (int)bitsToRotate) | (pattern >> (32
 - (int)bitsToRotate)));
172}

174/* LZ4HC_countPattern() :
* pattern32 must be a sample of repetitive pattern of length 1, 2 or 4 (but not 3!) */
176static unsigned
177LZ4HC_countPattern(const BYTE* ip, const BYTE* const iEnd, U32 const pattern32)
178{
  const BYTE* const iStart = ip;
  reg_t const pattern = (sizeof(pattern)==8) ?
      (reg_t)pattern32 + (((reg_t)pattern32) << (sizeof(pattern)*4)) : pattern32;

  while (likely(ip < iEnd-(sizeof(pattern)-1))(__builtin_expect (((ip < iEnd-(sizeof(pattern)-1)) != 0),
(1)) )) {
      reg_t const diff = LZ4_read_ARCH(ip) ^ pattern;
      if (!diff) { ip+=sizeof(pattern); continue; }
      ip += LZ4_NbCommonBytes(diff);
      return (unsigned)(ip - iStart);
  }

  if (LZ4_isLittleEndian()) {
      reg_t patternByte = pattern;
      while ((ip<iEnd) && (*ip == (BYTE)patternByte)) {
          ip++; patternByte >>= 8;
      }
  } else {  /* big endian */
      U32 bitOffset = (sizeof(pattern)*8) - 8;
      while (ip < iEnd) {
          BYTE const byte = (BYTE)(pattern >> bitOffset);
          if (*ip != byte) break;
          ip ++; bitOffset -= 8;
  }   }

  return (unsigned)(ip - iStart);
204}

206/* LZ4HC_reverseCountPattern() :
* pattern must be a sample of repetitive pattern of length 1, 2 or 4 (but not 3!)
* read using natural platform endianness */
209static unsigned
210LZ4HC_reverseCountPattern(const BYTE* ip, const BYTE* const iLow, U32 pattern)
211{
  const BYTE* const iStart = ip;

  while (likely(ip >= iLow+4)(__builtin_expect (((ip >= iLow+4) != 0),(1)) )) {
      if (LZ4_read32(ip-4) != pattern) break;
      ip -= 4;
  }
  {   const BYTE* bytePtr = (const BYTE*)(&pattern) + 3; /* works for any endianness */
      while (likely(ip>iLow)(__builtin_expect (((ip>iLow) != 0),(1)) )) {
          if (ip[-1] != *bytePtr) break;
          ip--; bytePtr--;
  }   }
  return (unsigned)(iStart - ip);
224}

226/* LZ4HC_protectDictEnd() :
* Checks if the match is in the last 3 bytes of the dictionary, so reading the
* 4 byte MINMATCH would overflow.
* @returns true if the match index is okay.
*/
231static int LZ4HC_protectDictEnd(U32 const dictLimit, U32 const matchIndex)
232{
  return ((U32)((dictLimit - 1) - matchIndex) >= 3);
234}

236typedef enum { rep_untested, rep_not, rep_confirmed } repeat_state_e;
237typedef enum { favorCompressionRatio=0, favorDecompressionSpeed } HCfavor_e;

239LZ4_FORCE_INLINEstatic inline __attribute__((always_inline)) int
240LZ4HC_InsertAndGetWiderMatch (
      LZ4HC_CCtx_internal* const hc4,
      const BYTE* const ip,
      const BYTE* const iLowLimit, const BYTE* const iHighLimit,
      int longest,
      const BYTE** matchpos,
      const BYTE** startpos,
      const int maxNbAttempts,
      const int patternAnalysis, const int chainSwap,
      const dictCtx_directive dict,
      const HCfavor_e favorDecSpeed)
251{
  U16* const chainTable = hc4->chainTable;
  U32* const HashTable = hc4->hashTable;
  const LZ4HC_CCtx_internal * const dictCtx = hc4->dictCtx;
  const BYTE* const prefixPtr = hc4->prefixStart;
  const U32 prefixIdx = hc4->dictLimit;
  const U32 ipIndex = (U32)(ip - prefixPtr) + prefixIdx;
  const int withinStartDistance = (hc4->lowLimit + (LZ4_DISTANCE_MAX65535 + 1) > ipIndex);
  const U32 lowestMatchIndex = (withinStartDistance) ? hc4->lowLimit : ipIndex - LZ4_DISTANCE_MAX65535;
  const BYTE* const dictStart = hc4->dictStart;
  const U32 dictIdx = hc4->lowLimit;
  const BYTE* const dictEnd = dictStart + prefixIdx - dictIdx;
  int const lookBackLength = (int)(ip-iLowLimit);
  int nbAttempts = maxNbAttempts;
  U32 matchChainPos = 0;
  U32 const pattern = LZ4_read32(ip);
  U32 matchIndex;
  repeat_state_e repeat = rep_untested;
  size_t srcPatternLength = 0;

  DEBUGLOG(7, "LZ4HC_InsertAndGetWiderMatch"){};
  /* First Match */
  LZ4HC_Insert(hc4, ip);
  matchIndex = HashTable[LZ4HC_hashPtr(ip)];
  DEBUGLOG(7, "First match at index %u / %u (lowestMatchIndex)",{}
              matchIndex, lowestMatchIndex){};

  while ((matchIndex>=lowestMatchIndex) && (nbAttempts>0)) {
      int matchLength=0;
      nbAttempts--;
      assert(matchIndex < ipIndex)((void)0);
      if (favorDecSpeed && (ipIndex - matchIndex < 8)) {
          /* do nothing */
      } else if (matchIndex >= prefixIdx) {   /* within current Prefix */
          const BYTE* const matchPtr = prefixPtr + matchIndex - prefixIdx;
          assert(matchPtr < ip)((void)0);
          assert(longest >= 1)((void)0);
          if (LZ4_read16(iLowLimit + longest - 1) == LZ4_read16(matchPtr - lookBackLength + longest - 1)) {
              if (LZ4_read32(matchPtr) == pattern) {
                  int const back = lookBackLength ? LZ4HC_countBack(ip, matchPtr, iLowLimit, prefixPtr) : 0;
                  matchLength = MINMATCH4 + (int)LZ4_count(ip+MINMATCH4, matchPtr+MINMATCH4, iHighLimit);
                  matchLength -= back;
                  if (matchLength > longest) {
                      longest = matchLength;
                      *matchpos = matchPtr + back;
                      *startpos = ip + back;
          }   }   }
      } else {   /* lowestMatchIndex <= matchIndex < dictLimit */
          const BYTE* const matchPtr = dictStart + (matchIndex - dictIdx);
          assert(matchIndex >= dictIdx)((void)0);
          if ( likely(matchIndex <= prefixIdx - 4)(__builtin_expect (((matchIndex <= prefixIdx - 4) != 0),(1
)) )
            && (LZ4_read32(matchPtr) == pattern) ) {
              int back = 0;
              const BYTE* vLimit = ip + (prefixIdx - matchIndex);
              if (vLimit > iHighLimit) vLimit = iHighLimit;
              matchLength = (int)LZ4_count(ip+MINMATCH4, matchPtr+MINMATCH4, vLimit) + MINMATCH4;
              if ((ip+matchLength == vLimit) && (vLimit < iHighLimit))
                  matchLength += LZ4_count(ip+matchLength, prefixPtr, iHighLimit);
              back = lookBackLength ? LZ4HC_countBack(ip, matchPtr, iLowLimit, dictStart) : 0;
              matchLength -= back;
              if (matchLength > longest) {
                  longest = matchLength;
                  *matchpos = prefixPtr - prefixIdx + matchIndex + back;   /* virtual pos, relative to ip, to retrieve offset */
                  *startpos = ip + back;
      }   }   }

      if (chainSwap && matchLength==longest) {   /* better match => select a better chain */
          assert(lookBackLength==0)((void)0);   /* search forward only */
          if (matchIndex + (U32)longest <= ipIndex) {
              int const kTrigger = 4;
              U32 distanceToNextMatch = 1;
              int const end = longest - MINMATCH4 + 1;
              int step = 1;
              int accel = 1 << kTrigger;
              int pos;
              for (pos = 0; pos < end; pos += step) {
                  U32 const candidateDist = DELTANEXTU16(chainTable, matchIndex + (U32)pos)chainTable[(U16)(matchIndex + (U32)pos)];
                  step = (accel++ >> kTrigger);
                  if (candidateDist > distanceToNextMatch) {
                      distanceToNextMatch = candidateDist;
                      matchChainPos = (U32)pos;
                      accel = 1 << kTrigger;
              }   }
              if (distanceToNextMatch > 1) {
                  if (distanceToNextMatch > matchIndex) break;   /* avoid overflow */
                  matchIndex -= distanceToNextMatch;
                  continue;
      }   }   }

      {   U32 const distNextMatch = DELTANEXTU16(chainTable, matchIndex)chainTable[(U16)(matchIndex)];
          if (patternAnalysis && distNextMatch==1 && matchChainPos==0) {
              U32 const matchCandidateIdx = matchIndex-1;
              /* may be a repeated pattern */
              if (repeat == rep_untested) {
                  if ( ((pattern & 0xFFFF) == (pattern >> 16))
                    &  ((pattern & 0xFF)   == (pattern >> 24)) ) {
                      repeat = rep_confirmed;
                      srcPatternLength = LZ4HC_countPattern(ip+sizeof(pattern), iHighLimit, pattern) + sizeof(pattern);
                  } else {
                      repeat = rep_not;
              }   }
              if ( (repeat == rep_confirmed) && (matchCandidateIdx >= lowestMatchIndex)
                && LZ4HC_protectDictEnd(prefixIdx, matchCandidateIdx) ) {
                  const int extDict = matchCandidateIdx < prefixIdx;
                  const BYTE* const matchPtr = (extDict ? dictStart - dictIdx : prefixPtr - prefixIdx) + matchCandidateIdx;
                  if (LZ4_read32(matchPtr) == pattern) {  /* good candidate */
                      const BYTE* const iLimit = extDict ? dictEnd : iHighLimit;
                      size_t forwardPatternLength = LZ4HC_countPattern(matchPtr+sizeof(pattern), iLimit, pattern) + sizeof(pattern);
                      if (extDict && matchPtr + forwardPatternLength == iLimit) {
                          U32 const rotatedPattern = LZ4HC_rotatePattern(forwardPatternLength, pattern);
                          forwardPatternLength += LZ4HC_countPattern(prefixPtr, iHighLimit, rotatedPattern);
                      }
                      {   const BYTE* const lowestMatchPtr = extDict ? dictStart : prefixPtr;
                          size_t backLength = LZ4HC_reverseCountPattern(matchPtr, lowestMatchPtr, pattern);
                          size_t currentSegmentLength;
                          if (!extDict
                            && matchPtr - backLength == prefixPtr
                            && dictIdx < prefixIdx) {
                              U32 const rotatedPattern = LZ4HC_rotatePattern((U32)(-(int)backLength), pattern);
                              backLength += LZ4HC_reverseCountPattern(dictEnd, dictStart, rotatedPattern);
                          }
                          /* Limit backLength not go further than lowestMatchIndex */
                          backLength = matchCandidateIdx - MAX(matchCandidateIdx - (U32)backLength, lowestMatchIndex)( (matchCandidateIdx - (U32)backLength) > (lowestMatchIndex
) ? (matchCandidateIdx - (U32)backLength) : (lowestMatchIndex
) );
                          assert(matchCandidateIdx - backLength >= lowestMatchIndex)((void)0);
                          currentSegmentLength = backLength + forwardPatternLength;
                          /* Adjust to end of pattern if the source pattern fits, otherwise the beginning of the pattern */
                          if ( (currentSegmentLength >= srcPatternLength)   /* current pattern segment large enough to contain full srcPatternLength */
                            && (forwardPatternLength <= srcPatternLength) ) { /* haven't reached this position yet */
                              U32 const newMatchIndex = matchCandidateIdx + (U32)forwardPatternLength - (U32)srcPatternLength;  /* best position, full pattern, might be followed by more match */
                              if (LZ4HC_protectDictEnd(prefixIdx, newMatchIndex))
                                  matchIndex = newMatchIndex;
                              else {
                                  /* Can only happen if started in the prefix */
                                  assert(newMatchIndex >= prefixIdx - 3 && newMatchIndex < prefixIdx && !extDict)((void)0);
                                  matchIndex = prefixIdx;
                              }
                          } else {
                              U32 const newMatchIndex = matchCandidateIdx - (U32)backLength;   /* farthest position in current segment, will find a match of length currentSegmentLength + maybe some back */
                              if (!LZ4HC_protectDictEnd(prefixIdx, newMatchIndex)) {
                                  assert(newMatchIndex >= prefixIdx - 3 && newMatchIndex < prefixIdx && !extDict)((void)0);
                                  matchIndex = prefixIdx;
                              } else {
                                  matchIndex = newMatchIndex;
                                  if (lookBackLength==0) {  /* no back possible */
                                      size_t const maxML = MIN(currentSegmentLength, srcPatternLength)( (currentSegmentLength) < (srcPatternLength) ? (currentSegmentLength
) : (srcPatternLength) );
                                      if ((size_t)longest < maxML) {
                                          assert(prefixPtr - prefixIdx + matchIndex != ip)((void)0);
                                          if ((size_t)(ip - prefixPtr) + prefixIdx - matchIndex > LZ4_DISTANCE_MAX65535) break;
                                          assert(maxML < 2 GB)((void)0);
                                          longest = (int)maxML;
                                          *matchpos = prefixPtr - prefixIdx + matchIndex;   /* virtual pos, relative to ip, to retrieve offset */
                                          *startpos = ip;
                                      }
                                      {   U32 const distToNextPattern = DELTANEXTU16(chainTable, matchIndex)chainTable[(U16)(matchIndex)];
                                          if (distToNextPattern > matchIndex) break;  /* avoid overflow */
                                          matchIndex -= distToNextPattern;
                      }   }   }   }   }
                      continue;
              }   }
      }   }   /* PA optimization */

      /* follow current chain */
      matchIndex -= DELTANEXTU16(chainTable, matchIndex + matchChainPos)chainTable[(U16)(matchIndex + matchChainPos)];

  }  /* while ((matchIndex>=lowestMatchIndex) && (nbAttempts)) */

  if ( dict == usingDictCtxHc
    && nbAttempts > 0
    && ipIndex - lowestMatchIndex < LZ4_DISTANCE_MAX65535) {
      size_t const dictEndOffset = (size_t)(dictCtx->end - dictCtx->prefixStart) + dictCtx->dictLimit;
      U32 dictMatchIndex = dictCtx->hashTable[LZ4HC_hashPtr(ip)];
      assert(dictEndOffset <= 1 GB)((void)0);
      matchIndex = dictMatchIndex + lowestMatchIndex - (U32)dictEndOffset;
      while (ipIndex - matchIndex <= LZ4_DISTANCE_MAX65535 && nbAttempts--) {
          const BYTE* const matchPtr = dictCtx->prefixStart - dictCtx->dictLimit + dictMatchIndex;

          if (LZ4_read32(matchPtr) == pattern) {
              int mlt;
              int back = 0;
              const BYTE* vLimit = ip + (dictEndOffset - dictMatchIndex);
              if (vLimit > iHighLimit) vLimit = iHighLimit;
              mlt = (int)LZ4_count(ip+MINMATCH4, matchPtr+MINMATCH4, vLimit) + MINMATCH4;
              back = lookBackLength ? LZ4HC_countBack(ip, matchPtr, iLowLimit, dictCtx->prefixStart) : 0;
              mlt -= back;
              if (mlt > longest) {
                  longest = mlt;
                  *matchpos = prefixPtr - prefixIdx + matchIndex + back;
                  *startpos = ip + back;
          }   }

          {   U32 const nextOffset = DELTANEXTU16(dictCtx->chainTable, dictMatchIndex)dictCtx->chainTable[(U16)(dictMatchIndex)];
              dictMatchIndex -= nextOffset;
              matchIndex -= nextOffset;
  }   }   }

  return longest;
447}

449LZ4_FORCE_INLINEstatic inline __attribute__((always_inline)) int
450LZ4HC_InsertAndFindBestMatch(LZ4HC_CCtx_internal* const hc4,   /* Index table will be updated */
                     const BYTE* const ip, const BYTE* const iLimit,
                     const BYTE** matchpos,
                     const int maxNbAttempts,
                     const int patternAnalysis,
                     const dictCtx_directive dict)
456{
  const BYTE* uselessPtr = ip;
  /* note : LZ4HC_InsertAndGetWiderMatch() is able to modify the starting position of a match (*startpos),
   * but this won't be the case here, as we define iLowLimit==ip,
   * so LZ4HC_InsertAndGetWiderMatch() won't be allowed to search past ip */
  return LZ4HC_InsertAndGetWiderMatch(hc4, ip, ip, iLimit, MINMATCH4-1, matchpos, &uselessPtr, maxNbAttempts, patternAnalysis, 0 /*chainSwap*/, dict, favorCompressionRatio);
462}

464/* LZ4HC_encodeSequence() :
* @return : 0 if ok,
*           1 if buffer issue detected */
467LZ4_FORCE_INLINEstatic inline __attribute__((always_inline)) int LZ4HC_encodeSequence (
  const BYTE** _ip,
  BYTE** _op,
  const BYTE** _anchor,
  int matchLength,
  const BYTE* const match,
  limitedOutput_directive limit,
  BYTE* oend)
475{
476#define ip      (*_ip)
477#define op      (*_op)
478#define anchor  (*_anchor)

  size_t length;
  BYTE* const token = op++;

483#if defined(LZ4_DEBUG) && (LZ4_DEBUG >= 6)
  static const BYTE* start = NULL((void*)0);
  static U32 totalCost = 0;
  U32 const pos = (start==NULL((void*)0)) ? 0 : (U32)(anchor - start);
  U32 const ll = (U32)(ip - anchor);
  U32 const llAdd = (ll>=15) ? ((ll-15) / 255) + 1 : 0;
  U32 const mlAdd = (matchLength>=19) ? ((matchLength-19) / 255) + 1 : 0;
  U32 const cost = 1 + llAdd + ll + 2 + mlAdd;
  if (start==NULL((void*)0)) start = anchor;  /* only works for single segment */
  /* g_debuglog_enable = (pos >= 2228) & (pos <= 2262); */
  DEBUGLOG(6, "pos:%7u -- literals:%4u, match:%4i, offset:%5u, cost:%4u + %5u",{}
              pos,{}
              (U32)(ip - anchor), matchLength, (U32)(ip-match),{}
              cost, totalCost){};
  totalCost += cost;
498#endif

  /* Encode Literal length */
  length = (size_t)(ip - anchor);
  LZ4_STATIC_ASSERT(notLimited == 0){ enum { LZ4_static_assert = 1/(int)(!!(notLimited == 0)) }; };
  /* Check output limit */
  if (limit && ((op + (length / 255) + length + (2 + 1 + LASTLITERALS5)) > oend)) {
      DEBUGLOG(6, "Not enough room to write %i literals (%i bytes remaining)",{}
              (int)length, (int)(oend - op)){};
      return 1;
  }
  if (length >= RUN_MASK((1U<<(8-4))-1)) {
      size_t len = length - RUN_MASK((1U<<(8-4))-1);
      *token = (RUN_MASK((1U<<(8-4))-1) << ML_BITS4);
      for(; len >= 255 ; len -= 255) *op++ = 255;
      *op++ = (BYTE)len;
  } else {
      *token = (BYTE)(length << ML_BITS4);
  }

  /* Copy Literals */
  LZ4_wildCopy8(op, anchor, op + length);
  op += length;

  /* Encode Offset */
  assert( (ip - match) <= LZ4_DISTANCE_MAX )((void)0);   /* note : consider providing offset as a value, rather than as a pointer difference */
  LZ4_writeLE16(op, (U16)(ip - match)); op += 2;

  /* Encode MatchLength */
  assert(matchLength >= MINMATCH)((void)0);
  length = (size_t)matchLength - MINMATCH4;
  if (limit && (op + (length / 255) + (1 + LASTLITERALS5) > oend)) {
      DEBUGLOG(6, "Not enough room to write match length"){};
      return 1;   /* Check output limit */
  }
  if (length >= ML_MASK((1U<<4)-1)) {
      *token += ML_MASK((1U<<4)-1);
      length -= ML_MASK((1U<<4)-1);
      for(; length >= 510 ; length -= 510) { *op++ = 255; *op++ = 255; }
      if (length >= 255) { length -= 255; *op++ = 255; }
      *op++ = (BYTE)length;
  } else {
      *token += (BYTE)(length);
  }

  /* Prepare next loop */
  ip += matchLength;
  anchor = ip;

  return 0;
548}
549#undef ip
550#undef op
551#undef anchor

553LZ4_FORCE_INLINEstatic inline __attribute__((always_inline)) int LZ4HC_compress_hashChain (
  LZ4HC_CCtx_internal* const ctx,
  const char* const source,
  char* const dest,
  int* srcSizePtr,
  int const maxOutputSize,
  int maxNbAttempts,
  const limitedOutput_directive limit,
  const dictCtx_directive dict
  )
563{
  const int inputSize = *srcSizePtr;
  const int patternAnalysis = (maxNbAttempts > 128);   /* levels 9+ */

  const BYTE* ip = (const BYTE*) source;
  const BYTE* anchor = ip;
  const BYTE* const iend = ip + inputSize;
  const BYTE* const mflimit = iend - MFLIMIT12;
  const BYTE* const matchlimit = (iend - LASTLITERALS5);

  BYTE* optr = (BYTE*) dest;
  BYTE* op = (BYTE*) dest;
  BYTE* oend = op + maxOutputSize;

  int   ml0, ml, ml2, ml3;
  const BYTE* start0;
  const BYTE* ref0;
  const BYTE* ref = NULL((void*)0);
  const BYTE* start2 = NULL((void*)0);
  const BYTE* ref2 = NULL((void*)0);
  const BYTE* start3 = NULL((void*)0);
  const BYTE* ref3 = NULL((void*)0);

  /* init */
  *srcSizePtr = 0;
  if (limit == fillOutput) oend -= LASTLITERALS5;                  /* Hack for support LZ4 format restriction */
  if (inputSize < LZ4_minLength) goto _last_literals;             /* Input too small, no compression (all literals) */

  /* Main Loop */
  while (ip <= mflimit) {
      ml = LZ4HC_InsertAndFindBestMatch(ctx, ip, matchlimit, &ref, maxNbAttempts, patternAnalysis, dict);
      if (ml<MINMATCH4) { ip++; continue; }

      /* saved, in case we would skip too much */
      start0 = ip; ref0 = ref; ml0 = ml;

599_Search2:
      if (ip+ml <= mflimit) {
          ml2 = LZ4HC_InsertAndGetWiderMatch(ctx,
                          ip + ml - 2, ip + 0, matchlimit, ml, &ref2, &start2,
                          maxNbAttempts, patternAnalysis, 0, dict, favorCompressionRatio);
      } else {
          ml2 = ml;
      }

      if (ml2 == ml) { /* No better match => encode ML1 */
          optr = op;
          if (LZ4HC_encodeSequence(UPDATABLE(ip, op, anchor)&ip, &op, &anchor, ml, ref, limit, oend)) goto _dest_overflow;
          continue;
      }

      if (start0 < ip) {   /* first match was skipped at least once */
          if (start2 < ip + ml0) {  /* squeezing ML1 between ML0(original ML1) and ML2 */
              ip = start0; ref = ref0; ml = ml0;  /* restore initial ML1 */
      }   }

      /* Here, start0==ip */
      if ((start2 - ip) < 3) {  /* First Match too small : removed */
          ml = ml2;
          ip = start2;
          ref =ref2;
          goto _Search2;
      }

627_Search3:
      /* At this stage, we have :
      *  ml2 > ml1, and
      *  ip1+3 <= ip2 (usually < ip1+ml1) */
      if ((start2 - ip) < OPTIMAL_ML(int)((((1U<<4)-1)-1)+4)) {
          int correction;
          int new_ml = ml;
          if (new_ml > OPTIMAL_ML(int)((((1U<<4)-1)-1)+4)) new_ml = OPTIMAL_ML(int)((((1U<<4)-1)-1)+4);
          if (ip+new_ml > start2 + ml2 - MINMATCH4) new_ml = (int)(start2 - ip) + ml2 - MINMATCH4;
          correction = new_ml - (int)(start2 - ip);
          if (correction > 0) {
              start2 += correction;
              ref2 += correction;
              ml2 -= correction;
          }
      }
      /* Now, we have start2 = ip+new_ml, with new_ml = min(ml, OPTIMAL_ML=18) */

      if (start2 + ml2 <= mflimit) {
          ml3 = LZ4HC_InsertAndGetWiderMatch(ctx,
                          start2 + ml2 - 3, start2, matchlimit, ml2, &ref3, &start3,
                          maxNbAttempts, patternAnalysis, 0, dict, favorCompressionRatio);
      } else {
          ml3 = ml2;
      }

      if (ml3 == ml2) {  /* No better match => encode ML1 and ML2 */
          /* ip & ref are known; Now for ml */
          if (start2 < ip+ml)  ml = (int)(start2 - ip);
          /* Now, encode 2 sequences */
          optr = op;
          if (LZ4HC_encodeSequence(UPDATABLE(ip, op, anchor)&ip, &op, &anchor, ml, ref, limit, oend)) goto _dest_overflow;
          ip = start2;
          optr = op;
          if (LZ4HC_encodeSequence(UPDATABLE(ip, op, anchor)&ip, &op, &anchor, ml2, ref2, limit, oend)) {
              ml  = ml2;
              ref = ref2;
              goto _dest_overflow;
          }
          continue;
      }

      if (start3 < ip+ml+3) {  /* Not enough space for match 2 : remove it */
          if (start3 >= (ip+ml)) {  /* can write Seq1 immediately ==> Seq2 is removed, so Seq3 becomes Seq1 */
              if (start2 < ip+ml) {
                  int correction = (int)(ip+ml - start2);
                  start2 += correction;
                  ref2 += correction;
                  ml2 -= correction;
                  if (ml2 < MINMATCH4) {
                      start2 = start3;
                      ref2 = ref3;
                      ml2 = ml3;
                  }
              }

              optr = op;
              if (LZ4HC_encodeSequence(UPDATABLE(ip, op, anchor)&ip, &op, &anchor, ml, ref, limit, oend)) goto _dest_overflow;
              ip  = start3;
              ref = ref3;
              ml  = ml3;

              start0 = start2;
              ref0 = ref2;
              ml0 = ml2;
              goto _Search2;
          }

          start2 = start3;
          ref2 = ref3;
          ml2 = ml3;
          goto _Search3;
      }

      /*
      * OK, now we have 3 ascending matches;
      * let's write the first one ML1.
      * ip & ref are known; Now decide ml.
      */
      if (start2 < ip+ml) {
          if ((start2 - ip) < OPTIMAL_ML(int)((((1U<<4)-1)-1)+4)) {
              int correction;
              if (ml > OPTIMAL_ML(int)((((1U<<4)-1)-1)+4)) ml = OPTIMAL_ML(int)((((1U<<4)-1)-1)+4);
              if (ip + ml > start2 + ml2 - MINMATCH4) ml = (int)(start2 - ip) + ml2 - MINMATCH4;
              correction = ml - (int)(start2 - ip);
              if (correction > 0) {
                  start2 += correction;
                  ref2 += correction;
                  ml2 -= correction;
              }
          } else {
              ml = (int)(start2 - ip);
          }
      }
      optr = op;
      if (LZ4HC_encodeSequence(UPDATABLE(ip, op, anchor)&ip, &op, &anchor, ml, ref, limit, oend)) goto _dest_overflow;

      /* ML2 becomes ML1 */
      ip = start2; ref = ref2; ml = ml2;

      /* ML3 becomes ML2 */
      start2 = start3; ref2 = ref3; ml2 = ml3;

      /* let's find a new ML3 */
      goto _Search3;
  }

734_last_literals:
  /* Encode Last Literals */
  {   size_t lastRunSize = (size_t)(iend - anchor);  /* literals */
      size_t llAdd = (lastRunSize + 255 - RUN_MASK((1U<<(8-4))-1)) / 255;
      size_t const totalSize = 1 + llAdd + lastRunSize;
      if (limit == fillOutput) oend += LASTLITERALS5;  /* restore correct value */
      if (limit && (op + totalSize > oend)) {
          if (limit == limitedOutput) return 0;
          /* adapt lastRunSize to fill 'dest' */
          lastRunSize  = (size_t)(oend - op) - 1 /*token*/;
          llAdd = (lastRunSize + 256 - RUN_MASK((1U<<(8-4))-1)) / 256;
          lastRunSize -= llAdd;
      }
      DEBUGLOG(6, "Final literal run : %i literals", (int)lastRunSize){};
      ip = anchor + lastRunSize;  /* can be != iend if limit==fillOutput */

      if (lastRunSize >= RUN_MASK((1U<<(8-4))-1)) {
          size_t accumulator = lastRunSize - RUN_MASK((1U<<(8-4))-1);
          *op++ = (RUN_MASK((1U<<(8-4))-1) << ML_BITS4);
          for(; accumulator >= 255 ; accumulator -= 255) *op++ = 255;
          *op++ = (BYTE) accumulator;
      } else {
          *op++ = (BYTE)(lastRunSize << ML_BITS4);
      }
      LZ4_memcpy(op, anchor, lastRunSize)__builtin_memcpy(op, anchor, lastRunSize);
      op += lastRunSize;
  }

  /* End */
  *srcSizePtr = (int) (((const char*)ip) - source);
  return (int) (((char*)op)-dest);

766_dest_overflow:
  if (limit == fillOutput) {
      /* Assumption : ip, anchor, ml and ref must be set correctly */
      size_t const ll = (size_t)(ip - anchor);
      size_t const ll_addbytes = (ll + 240) / 255;
      size_t const ll_totalCost = 1 + ll_addbytes + ll;
      BYTE* const maxLitPos = oend - 3; /* 2 for offset, 1 for token */
      DEBUGLOG(6, "Last sequence overflowing"){};
      op = optr;  /* restore correct out pointer */
      if (op + ll_totalCost <= maxLitPos) {
          /* ll validated; now adjust match length */
          size_t const bytesLeftForMl = (size_t)(maxLitPos - (op+ll_totalCost));
          size_t const maxMlSize = MINMATCH4 + (ML_MASK((1U<<4)-1)-1) + (bytesLeftForMl * 255);
          assert(maxMlSize < INT_MAX)((void)0); assert(ml >= 0)((void)0);
          if ((size_t)ml > maxMlSize) ml = (int)maxMlSize;
          if ((oend + LASTLITERALS5) - (op + ll_totalCost + 2) - 1 + ml >= MFLIMIT12) {
              LZ4HC_encodeSequence(UPDATABLE(ip, op, anchor)&ip, &op, &anchor, ml, ref, notLimited, oend);
      }   }
      goto _last_literals;
  }
  /* compression failed */
  return 0;
788}


791static int LZ4HC_compress_optimal( LZ4HC_CCtx_internal* ctx,
  const char* const source, char* dst,
  int* srcSizePtr, int dstCapacity,
  int const nbSearches, size_t sufficient_len,
  const limitedOutput_directive limit, int const fullUpdate,
  const dictCtx_directive dict,
  const HCfavor_e favorDecSpeed);


800LZ4_FORCE_INLINEstatic inline __attribute__((always_inline)) int LZ4HC_compress_generic_internal (
  LZ4HC_CCtx_internal* const ctx,
  const char* const src,
  char* const dst,
  int* const srcSizePtr,
  int const dstCapacity,
  int cLevel,
  const limitedOutput_directive limit,
  const dictCtx_directive dict
  )
810{
  typedef enum { lz4hc, lz4opt } lz4hc_strat_e;
  typedef struct {
      lz4hc_strat_e strat;
      int nbSearches;
      U32 targetLength;
  } cParams_t;
  static const cParams_t clTable[LZ4HC_CLEVEL_MAX12+1] = {
      { lz4hc,     2, 16 },  /* 0, unused */
      { lz4hc,     2, 16 },  /* 1, unused */
      { lz4hc,     2, 16 },  /* 2, unused */
      { lz4hc,     4, 16 },  /* 3 */
      { lz4hc,     8, 16 },  /* 4 */
      { lz4hc,    16, 16 },  /* 5 */
      { lz4hc,    32, 16 },  /* 6 */
      { lz4hc,    64, 16 },  /* 7 */
      { lz4hc,   128, 16 },  /* 8 */
      { lz4hc,   256, 16 },  /* 9 */
      { lz4opt,   96, 64 },  /*10==LZ4HC_CLEVEL_OPT_MIN*/
      { lz4opt,  512,128 },  /*11 */
      { lz4opt,16384,LZ4_OPT_NUM(1<<12) },  /* 12==LZ4HC_CLEVEL_MAX */
  };

  DEBUGLOG(4, "LZ4HC_compress_generic(ctx=%p, src=%p, srcSize=%d, limit=%d)",{}
              ctx, src, *srcSizePtr, limit){};

  if (limit == fillOutput && dstCapacity < 1) return 0;   /* Impossible to store anything */
  if ((U32)*srcSizePtr > (U32)LZ4_MAX_INPUT_SIZE0x7E000000) return 0;    /* Unsupported input size (too large or negative) */

  ctx->end += *srcSizePtr;
  if (cLevel < 1) cLevel = LZ4HC_CLEVEL_DEFAULT9;   /* note : convention is different from lz4frame, maybe something to review */
  cLevel = MIN(LZ4HC_CLEVEL_MAX, cLevel)( (12) < (cLevel) ? (12) : (cLevel) );
  {   cParams_t const cParam = clTable[cLevel];
      HCfavor_e const favor = ctx->favorDecSpeed ? favorDecompressionSpeed : favorCompressionRatio;
      int result;

      if (cParam.strat == lz4hc) {
          result = LZ4HC_compress_hashChain(ctx,
                              src, dst, srcSizePtr, dstCapacity,
                              cParam.nbSearches, limit, dict);
      } else {
          assert(cParam.strat == lz4opt)((void)0);
          result = LZ4HC_compress_optimal(ctx,
                              src, dst, srcSizePtr, dstCapacity,
                              cParam.nbSearches, cParam.targetLength, limit,
                              cLevel == LZ4HC_CLEVEL_MAX12,   /* ultra mode */
                              dict, favor);
      }
      if (result <= 0) ctx->dirty = 1;
      return result;
  }
861}

863static void LZ4HC_setExternalDict(LZ4HC_CCtx_internal* ctxPtr, const BYTE* newBlock);

865static int
866LZ4HC_compress_generic_noDictCtx (
      LZ4HC_CCtx_internal* const ctx,
      const char* const src,
      char* const dst,
      int* const srcSizePtr,
      int const dstCapacity,
      int cLevel,
      limitedOutput_directive limit
      )
875{
  assert(ctx->dictCtx == NULL)((void)0);
  return LZ4HC_compress_generic_internal(ctx, src, dst, srcSizePtr, dstCapacity, cLevel, limit, noDictCtx);
878}

880static int
881LZ4HC_compress_generic_dictCtx (
      LZ4HC_CCtx_internal* const ctx,
      const char* const src,
      char* const dst,
      int* const srcSizePtr,
      int const dstCapacity,
      int cLevel,
      limitedOutput_directive limit
      )
890{
  const size_t position = (size_t)(ctx->end - ctx->prefixStart) + (ctx->dictLimit - ctx->lowLimit);
  assert(ctx->dictCtx != NULL)((void)0);
  if (position >= 64 KB*(1 <<10)) {
      ctx->dictCtx = NULL((void*)0);
      return LZ4HC_compress_generic_noDictCtx(ctx, src, dst, srcSizePtr, dstCapacity, cLevel, limit);
  } else if (position == 0 && *srcSizePtr > 4 KB*(1 <<10)) {
      LZ4_memcpy(ctx, ctx->dictCtx, sizeof(LZ4HC_CCtx_internal))__builtin_memcpy(ctx, ctx->dictCtx, sizeof(LZ4HC_CCtx_internal
));
      LZ4HC_setExternalDict(ctx, (const BYTE *)src);
      ctx->compressionLevel = (short)cLevel;
      return LZ4HC_compress_generic_noDictCtx(ctx, src, dst, srcSizePtr, dstCapacity, cLevel, limit);
  } else {
      return LZ4HC_compress_generic_internal(ctx, src, dst, srcSizePtr, dstCapacity, cLevel, limit, usingDictCtxHc);
  }
904}

906static int
907LZ4HC_compress_generic (
      LZ4HC_CCtx_internal* const ctx,
      const char* const src,
      char* const dst,
      int* const srcSizePtr,
      int const dstCapacity,
      int cLevel,
      limitedOutput_directive limit
      )
916{
  if (ctx->dictCtx == NULL((void*)0)) {
      return LZ4HC_compress_generic_noDictCtx(ctx, src, dst, srcSizePtr, dstCapacity, cLevel, limit);
  } else {
      return LZ4HC_compress_generic_dictCtx(ctx, src, dst, srcSizePtr, dstCapacity, cLevel, limit);
  }
922}


925int LZ4_sizeofStateHC(void) { return (int)sizeof(LZ4_streamHC_t); }

927static size_t LZ4_streamHC_t_alignment(void)
928{
929#if LZ4_ALIGN_TEST1
  typedef struct { char c; LZ4_streamHC_t t; } t_a;
  return sizeof(t_a) - sizeof(LZ4_streamHC_t);
932#else
  return 1;  /* effectively disabled */
934#endif
935}

937/* state is presumed correctly initialized,
* in which case its size and alignment have already been validate */
939int LZ4_compress_HC_extStateHC_fastReset (void* state, const char* src, char* dst, int srcSize, int dstCapacity, int compressionLevel)
940{
  LZ4HC_CCtx_internal* const ctx = &((LZ4_streamHC_t*)state)->internal_donotuse;
  if (!LZ4_isAligned(state, LZ4_streamHC_t_alignment())) return 0;
  LZ4_resetStreamHC_fast((LZ4_streamHC_t*)state, compressionLevel);
  LZ4HC_init_internal (ctx, (const BYTE*)src);
  if (dstCapacity < LZ4_compressBound(srcSize))
      return LZ4HC_compress_generic (ctx, src, dst, &srcSize, dstCapacity, compressionLevel, limitedOutput);
  else
      return LZ4HC_compress_generic (ctx, src, dst, &srcSize, dstCapacity, compressionLevel, notLimited);
949}

951int LZ4_compress_HC_extStateHC (void* state, const char* src, char* dst, int srcSize, int dstCapacity, int compressionLevel)
952{
  LZ4_streamHC_t* const ctx = LZ4_initStreamHC(state, sizeof(*ctx));
  if (ctx==NULL((void*)0)) return 0;   /* init failure */
  return LZ4_compress_HC_extStateHC_fastReset(state, src, dst, srcSize, dstCapacity, compressionLevel);
956}

958int LZ4_compress_HC(const char* src, char* dst, int srcSize, int dstCapacity, int compressionLevel)
959{
  int cSize;
961#if defined(LZ4HC_HEAPMODE1) && LZ4HC_HEAPMODE1==1
  LZ4_streamHC_t* const statePtr = (LZ4_streamHC_t*)ALLOC(sizeof(LZ4_streamHC_t))malloc(sizeof(LZ4_streamHC_t));
  if (statePtr==NULL((void*)0)) return 0;
964#else
  LZ4_streamHC_t state;
  LZ4_streamHC_t* const statePtr = &state;
967#endif
  cSize = LZ4_compress_HC_extStateHC(statePtr, src, dst, srcSize, dstCapacity, compressionLevel);
969#if defined(LZ4HC_HEAPMODE1) && LZ4HC_HEAPMODE1==1
  FREEMEM(statePtr)free(statePtr);
971#endif
  return cSize;
973}

975/* state is presumed sized correctly (>= sizeof(LZ4_streamHC_t)) */
976int LZ4_compress_HC_destSize(void* state, const char* source, char* dest, int* sourceSizePtr, int targetDestSize, int cLevel)
977{
  LZ4_streamHC_t* const ctx = LZ4_initStreamHC(state, sizeof(*ctx));
  if (ctx==NULL((void*)0)) return 0;   /* init failure */
  LZ4HC_init_internal(&ctx->internal_donotuse, (const BYTE*) source);
  LZ4_setCompressionLevel(ctx, cLevel);
  return LZ4HC_compress_generic(&ctx->internal_donotuse, source, dest, sourceSizePtr, targetDestSize, cLevel, fillOutput);
983}



987/**************************************
988*  Streaming Functions
989**************************************/
990/* allocation */
991#if !defined(LZ4_STATIC_LINKING_ONLY_DISABLE_MEMORY_ALLOCATION)
992LZ4_streamHC_t* LZ4_createStreamHC(void)
993{
  LZ4_streamHC_t* const state =
      (LZ4_streamHC_t*)ALLOC_AND_ZERO(sizeof(LZ4_streamHC_t))calloc(1,sizeof(LZ4_streamHC_t));
  if (state == NULL((void*)0)) return NULL((void*)0);
  LZ4_setCompressionLevel(state, LZ4HC_CLEVEL_DEFAULT9);
  return state;
999}

1001int LZ4_freeStreamHC (LZ4_streamHC_t* LZ4_streamHCPtr)
1002{
  DEBUGLOG(4, "LZ4_freeStreamHC(%p)", LZ4_streamHCPtr){};
  if (!LZ4_streamHCPtr) return 0;  /* support free on NULL */
  FREEMEM(LZ4_streamHCPtr)free(LZ4_streamHCPtr);
  return 0;
1007}
1008#endif


1011LZ4_streamHC_t* LZ4_initStreamHC (void* buffer, size_t size)
1012{
  LZ4_streamHC_t* const LZ4_streamHCPtr = (LZ4_streamHC_t*)buffer;
  DEBUGLOG(4, "LZ4_initStreamHC(%p, %u)", buffer, (unsigned)size){};
  /* check conditions */
  if (buffer == NULL((void*)0)) return NULL((void*)0);
  if (size < sizeof(LZ4_streamHC_t)) return NULL((void*)0);
  if (!LZ4_isAligned(buffer, LZ4_streamHC_t_alignment())) return NULL((void*)0);
  /* init */
  { LZ4HC_CCtx_internal* const hcstate = &(LZ4_streamHCPtr->internal_donotuse);
    MEM_INIT(hcstate, 0, sizeof(*hcstate))memset(((hcstate)),((0)),((sizeof(*hcstate)))); }
  LZ4_setCompressionLevel(LZ4_streamHCPtr, LZ4HC_CLEVEL_DEFAULT9);
  return LZ4_streamHCPtr;
1024}

1026/* just a stub */
1027void LZ4_resetStreamHC (LZ4_streamHC_t* LZ4_streamHCPtr, int compressionLevel)
1028{
  LZ4_initStreamHC(LZ4_streamHCPtr, sizeof(*LZ4_streamHCPtr));
  LZ4_setCompressionLevel(LZ4_streamHCPtr, compressionLevel);
1031}

1033void LZ4_resetStreamHC_fast (LZ4_streamHC_t* LZ4_streamHCPtr, int compressionLevel)
1034{
  DEBUGLOG(4, "LZ4_resetStreamHC_fast(%p, %d)", LZ4_streamHCPtr, compressionLevel){};
  if (LZ4_streamHCPtr->internal_donotuse.dirty) {
      LZ4_initStreamHC(LZ4_streamHCPtr, sizeof(*LZ4_streamHCPtr));
  } else {
      /* preserve end - prefixStart : can trigger clearTable's threshold */
      if (LZ4_streamHCPtr->internal_donotuse.end != NULL((void*)0)) {
          LZ4_streamHCPtr->internal_donotuse.end -= (uptrval)LZ4_streamHCPtr->internal_donotuse.prefixStart;
      } else {
          assert(LZ4_streamHCPtr->internal_donotuse.prefixStart == NULL)((void)0);
      }
      LZ4_streamHCPtr->internal_donotuse.prefixStart = NULL((void*)0);
      LZ4_streamHCPtr->internal_donotuse.dictCtx = NULL((void*)0);
  }
  LZ4_setCompressionLevel(LZ4_streamHCPtr, compressionLevel);
1049}

1051void LZ4_setCompressionLevel(LZ4_streamHC_t* LZ4_streamHCPtr, int compressionLevel)
1052{
  DEBUGLOG(5, "LZ4_setCompressionLevel(%p, %d)", LZ4_streamHCPtr, compressionLevel){};
  if (compressionLevel < 1) compressionLevel = LZ4HC_CLEVEL_DEFAULT9;
  if (compressionLevel > LZ4HC_CLEVEL_MAX12) compressionLevel = LZ4HC_CLEVEL_MAX12;
  LZ4_streamHCPtr->internal_donotuse.compressionLevel = (short)compressionLevel;
1057}

1059void LZ4_favorDecompressionSpeed(LZ4_streamHC_t* LZ4_streamHCPtr, int favor)
1060{
  LZ4_streamHCPtr->internal_donotuse.favorDecSpeed = (favor!=0);
1062}

1064/* LZ4_loadDictHC() :
* LZ4_streamHCPtr is presumed properly initialized */
1066int LZ4_loadDictHC (LZ4_streamHC_t* LZ4_streamHCPtr,
            const char* dictionary, int dictSize)
1068{
  LZ4HC_CCtx_internal* const ctxPtr = &LZ4_streamHCPtr->internal_donotuse;
  DEBUGLOG(4, "LZ4_loadDictHC(ctx:%p, dict:%p, dictSize:%d)", LZ4_streamHCPtr, dictionary, dictSize){};
  assert(LZ4_streamHCPtr != NULL)((void)0);
  if (dictSize > 64 KB*(1 <<10)) {
      dictionary += (size_t)dictSize - 64 KB*(1 <<10);
      dictSize = 64 KB*(1 <<10);
  }
  /* need a full initialization, there are bad side-effects when using resetFast() */
  {   int const cLevel = ctxPtr->compressionLevel;
      LZ4_initStreamHC(LZ4_streamHCPtr, sizeof(*LZ4_streamHCPtr));
      LZ4_setCompressionLevel(LZ4_streamHCPtr, cLevel);
  }
  LZ4HC_init_internal (ctxPtr, (const BYTE*)dictionary);
  ctxPtr->end = (const BYTE*)dictionary + dictSize;
  if (dictSize >= 4) LZ4HC_Insert (ctxPtr, ctxPtr->end-3);
  return dictSize;
1085}

1087void LZ4_attach_HC_dictionary(LZ4_streamHC_t *working_stream, const LZ4_streamHC_t *dictionary_stream) {
  working_stream->internal_donotuse.dictCtx = dictionary_stream != NULL((void*)0) ? &(dictionary_stream->internal_donotuse) : NULL((void*)0);
1089}

1091/* compression */

1093static void LZ4HC_setExternalDict(LZ4HC_CCtx_internal* ctxPtr, const BYTE* newBlock)
1094{
  DEBUGLOG(4, "LZ4HC_setExternalDict(%p, %p)", ctxPtr, newBlock){};
  if (ctxPtr->end >= ctxPtr->prefixStart + 4)
      LZ4HC_Insert (ctxPtr, ctxPtr->end-3);   /* Referencing remaining dictionary content */

  /* Only one memory segment for extDict, so any previous extDict is lost at this stage */
  ctxPtr->lowLimit  = ctxPtr->dictLimit;
  ctxPtr->dictStart  = ctxPtr->prefixStart;
  ctxPtr->dictLimit += (U32)(ctxPtr->end - ctxPtr->prefixStart);
  ctxPtr->prefixStart = newBlock;
  ctxPtr->end  = newBlock;
  ctxPtr->nextToUpdate = ctxPtr->dictLimit;   /* match referencing will resume from there */

  /* cannot reference an extDict and a dictCtx at the same time */
  ctxPtr->dictCtx = NULL((void*)0);
1109}

1111static int
1112LZ4_compressHC_continue_generic (LZ4_streamHC_t* LZ4_streamHCPtr,
                               const char* src, char* dst,
                               int* srcSizePtr, int dstCapacity,
                               limitedOutput_directive limit)
1116{
  LZ4HC_CCtx_internal* const ctxPtr = &LZ4_streamHCPtr->internal_donotuse;
  DEBUGLOG(5, "LZ4_compressHC_continue_generic(ctx=%p, src=%p, srcSize=%d, limit=%d)",{}
              LZ4_streamHCPtr, src, *srcSizePtr, limit){};
  assert(ctxPtr != NULL)((void)0);
  /* auto-init if forgotten */
  if (ctxPtr->prefixStart == NULL((void*)0)) LZ4HC_init_internal (ctxPtr, (const BYTE*) src);

  /* Check overflow */
  if ((size_t)(ctxPtr->end - ctxPtr->prefixStart) + ctxPtr->dictLimit > 2 GB*(1U<<30)) {
      size_t dictSize = (size_t)(ctxPtr->end - ctxPtr->prefixStart);
      if (dictSize > 64 KB*(1 <<10)) dictSize = 64 KB*(1 <<10);
      LZ4_loadDictHC(LZ4_streamHCPtr, (const char*)(ctxPtr->end) - dictSize, (int)dictSize);
  }

  /* Check if blocks follow each other */
  if ((const BYTE*)src != ctxPtr->end)
      LZ4HC_setExternalDict(ctxPtr, (const BYTE*)src);

  /* Check overlapping input/dictionary space */
  {   const BYTE* sourceEnd = (const BYTE*) src + *srcSizePtr;
      const BYTE* const dictBegin = ctxPtr->dictStart;
      const BYTE* const dictEnd   = ctxPtr->dictStart + (ctxPtr->dictLimit - ctxPtr->lowLimit);
      if ((sourceEnd > dictBegin) && ((const BYTE*)src < dictEnd)) {
          if (sourceEnd > dictEnd) sourceEnd = dictEnd;
          ctxPtr->lowLimit += (U32)(sourceEnd - ctxPtr->dictStart);
          ctxPtr->dictStart += (U32)(sourceEnd - ctxPtr->dictStart);
          if (ctxPtr->dictLimit - ctxPtr->lowLimit < 4) {
              ctxPtr->lowLimit = ctxPtr->dictLimit;
              ctxPtr->dictStart = ctxPtr->prefixStart;
  }   }   }

  return LZ4HC_compress_generic (ctxPtr, src, dst, srcSizePtr, dstCapacity, ctxPtr->compressionLevel, limit);
1149}

1151int LZ4_compress_HC_continue (LZ4_streamHC_t* LZ4_streamHCPtr, const char* src, char* dst, int srcSize, int dstCapacity)
1152{
  if (dstCapacity < LZ4_compressBound(srcSize))
      return LZ4_compressHC_continue_generic (LZ4_streamHCPtr, src, dst, &srcSize, dstCapacity, limitedOutput);
  else
      return LZ4_compressHC_continue_generic (LZ4_streamHCPtr, src, dst, &srcSize, dstCapacity, notLimited);
1157}

1159int LZ4_compress_HC_continue_destSize (LZ4_streamHC_t* LZ4_streamHCPtr, const char* src, char* dst, int* srcSizePtr, int targetDestSize)
1160{
  return LZ4_compressHC_continue_generic(LZ4_streamHCPtr, src, dst, srcSizePtr, targetDestSize, fillOutput);
1162}



1166/* LZ4_saveDictHC :
* save history content
* into a user-provided buffer
* which is then used to continue compression
*/
1171int LZ4_saveDictHC (LZ4_streamHC_t* LZ4_streamHCPtr, char* safeBuffer, int dictSize)
1172{
  LZ4HC_CCtx_internal* const streamPtr = &LZ4_streamHCPtr->internal_donotuse;
  int const prefixSize = (int)(streamPtr->end - streamPtr->prefixStart);
  DEBUGLOG(5, "LZ4_saveDictHC(%p, %p, %d)", LZ4_streamHCPtr, safeBuffer, dictSize){};
  assert(prefixSize >= 0)((void)0);
  if (dictSize > 64 KB*(1 <<10)) dictSize = 64 KB*(1 <<10);
1
Assuming the condition is false→
2
←
Taking false branch→
  if (dictSize < 4) dictSize = 0;
3
←
Assuming 'dictSize' is >= 4→
4
←
Taking false branch→
  if (dictSize > prefixSize) dictSize = prefixSize;
5
←
Assuming 'dictSize' is <= 'prefixSize'→
6
←
Taking false branch→
  if (safeBuffer == NULL((void*)0)) assert(dictSize == 0)((void)0);
7
←
Assuming 'safeBuffer' is equal to NULL→
8
←
Taking true branch→
  if (dictSize8.1
'dictSize' is > 0
 > 0)
9
←
Taking true branch→
      LZ4_memmove__builtin_memmove(safeBuffer, streamPtr->end - dictSize, dictSize);
10
←
Null pointer passed as 1st argument to memory copy function
  {   U32 const endIndex = (U32)(streamPtr->end - streamPtr->prefixStart) + streamPtr->dictLimit;
      streamPtr->end = (const BYTE*)safeBuffer + dictSize;
      streamPtr->prefixStart = streamPtr->end - dictSize;
      streamPtr->dictLimit = endIndex - (U32)dictSize;
      streamPtr->lowLimit = endIndex - (U32)dictSize;
      streamPtr->dictStart = streamPtr->prefixStart;
      if (streamPtr->nextToUpdate < streamPtr->dictLimit)
          streamPtr->nextToUpdate = streamPtr->dictLimit;
  }
  return dictSize;
1193}


1196/***************************************************
1197*  Deprecated Functions
1198***************************************************/

1200/* These functions currently generate deprecation warnings */

1202/* Wrappers for deprecated compression functions */
1203int LZ4_compressHC(const char* src, char* dst, int srcSize) { return LZ4_compress_HC (src, dst, srcSize, LZ4_compressBound(srcSize), 0); }
1204int LZ4_compressHC_limitedOutput(const char* src, char* dst, int srcSize, int maxDstSize) { return LZ4_compress_HC(src, dst, srcSize, maxDstSize, 0); }
1205int LZ4_compressHC2(const char* src, char* dst, int srcSize, int cLevel) { return LZ4_compress_HC (src, dst, srcSize, LZ4_compressBound(srcSize), cLevel); }
1206int LZ4_compressHC2_limitedOutput(const char* src, char* dst, int srcSize, int maxDstSize, int cLevel) { return LZ4_compress_HC(src, dst, srcSize, maxDstSize, cLevel); }
1207int LZ4_compressHC_withStateHC (void* state, const char* src, char* dst, int srcSize) { return LZ4_compress_HC_extStateHC (state, src, dst, srcSize, LZ4_compressBound(srcSize), 0); }
1208int LZ4_compressHC_limitedOutput_withStateHC (void* state, const char* src, char* dst, int srcSize, int maxDstSize) { return LZ4_compress_HC_extStateHC (state, src, dst, srcSize, maxDstSize, 0); }
1209int LZ4_compressHC2_withStateHC (void* state, const char* src, char* dst, int srcSize, int cLevel) { return LZ4_compress_HC_extStateHC(state, src, dst, srcSize, LZ4_compressBound(srcSize), cLevel); }
1210int LZ4_compressHC2_limitedOutput_withStateHC (void* state, const char* src, char* dst, int srcSize, int maxDstSize, int cLevel) { return LZ4_compress_HC_extStateHC(state, src, dst, srcSize, maxDstSize, cLevel); }
1211int LZ4_compressHC_continue (LZ4_streamHC_t* ctx, const char* src, char* dst, int srcSize) { return LZ4_compress_HC_continue (ctx, src, dst, srcSize, LZ4_compressBound(srcSize)); }
1212int LZ4_compressHC_limitedOutput_continue (LZ4_streamHC_t* ctx, const char* src, char* dst, int srcSize, int maxDstSize) { return LZ4_compress_HC_continue (ctx, src, dst, srcSize, maxDstSize); }


1215/* Deprecated streaming functions */
1216int LZ4_sizeofStreamStateHC(void) { return sizeof(LZ4_streamHC_t); }

1218/* state is presumed correctly sized, aka >= sizeof(LZ4_streamHC_t)
* @return : 0 on success, !=0 if error */
1220int LZ4_resetStreamStateHC(void* state, char* inputBuffer)
1221{
  LZ4_streamHC_t* const hc4 = LZ4_initStreamHC(state, sizeof(*hc4));
  if (hc4 == NULL((void*)0)) return 1;   /* init failed */
  LZ4HC_init_internal (&hc4->internal_donotuse, (const BYTE*)inputBuffer);
  return 0;
1226}

1228#if !defined(LZ4_STATIC_LINKING_ONLY_DISABLE_MEMORY_ALLOCATION)
1229void* LZ4_createHC (const char* inputBuffer)
1230{
  LZ4_streamHC_t* const hc4 = LZ4_createStreamHC();
  if (hc4 == NULL((void*)0)) return NULL((void*)0);   /* not enough memory */
  LZ4HC_init_internal (&hc4->internal_donotuse, (const BYTE*)inputBuffer);
  return hc4;
1235}

1237int LZ4_freeHC (void* LZ4HC_Data)
1238{
  if (!LZ4HC_Data) return 0;  /* support free on NULL */
  FREEMEM(LZ4HC_Data)free(LZ4HC_Data);
  return 0;
1242}
1243#endif

1245int LZ4_compressHC2_continue (void* LZ4HC_Data, const char* src, char* dst, int srcSize, int cLevel)
1246{
  return LZ4HC_compress_generic (&((LZ4_streamHC_t*)LZ4HC_Data)->internal_donotuse, src, dst, &srcSize, 0, cLevel, notLimited);
1248}

1250int LZ4_compressHC2_limitedOutput_continue (void* LZ4HC_Data, const char* src, char* dst, int srcSize, int dstCapacity, int cLevel)
1251{
  return LZ4HC_compress_generic (&((LZ4_streamHC_t*)LZ4HC_Data)->internal_donotuse, src, dst, &srcSize, dstCapacity, cLevel, limitedOutput);
1253}

1255char* LZ4_slideInputBufferHC(void* LZ4HC_Data)
1256{
  LZ4_streamHC_t* const ctx = (LZ4_streamHC_t*)LZ4HC_Data;
  const BYTE* bufferStart = ctx->internal_donotuse.prefixStart - ctx->internal_donotuse.dictLimit + ctx->internal_donotuse.lowLimit;
  LZ4_resetStreamHC_fast(ctx, ctx->internal_donotuse.compressionLevel);
  /* avoid const char * -> char * conversion warning :( */
  return (char*)(uptrval)bufferStart;
1262}


1265/* ================================================
*  LZ4 Optimal parser (levels [LZ4HC_CLEVEL_OPT_MIN - LZ4HC_CLEVEL_MAX])
* ===============================================*/
1268typedef struct {
  int price;
  int off;
  int mlen;
  int litlen;
1273} LZ4HC_optimal_t;

1275/* price in bytes */
1276LZ4_FORCE_INLINEstatic inline __attribute__((always_inline)) int LZ4HC_literalsPrice(int const litlen)
1277{
  int price = litlen;
  assert(litlen >= 0)((void)0);
  if (litlen >= (int)RUN_MASK((1U<<(8-4))-1))
      price += 1 + ((litlen-(int)RUN_MASK((1U<<(8-4))-1)) / 255);
  return price;
1283}


1286/* requires mlen >= MINMATCH */
1287LZ4_FORCE_INLINEstatic inline __attribute__((always_inline)) int LZ4HC_sequencePrice(int litlen, int mlen)
1288{
  int price = 1 + 2 ; /* token + 16-bit offset */
  assert(litlen >= 0)((void)0);
  assert(mlen >= MINMATCH)((void)0);

  price += LZ4HC_literalsPrice(litlen);

  if (mlen >= (int)(ML_MASK((1U<<4)-1)+MINMATCH4))
      price += 1 + ((mlen-(int)(ML_MASK((1U<<4)-1)+MINMATCH4)) / 255);

  return price;
1299}


1302typedef struct {
  int off;
  int len;
1305} LZ4HC_match_t;

1307LZ4_FORCE_INLINEstatic inline __attribute__((always_inline)) LZ4HC_match_t
1308LZ4HC_FindLongerMatch(LZ4HC_CCtx_internal* const ctx,
                    const BYTE* ip, const BYTE* const iHighLimit,
                    int minLen, int nbSearches,
                    const dictCtx_directive dict,
                    const HCfavor_e favorDecSpeed)
1313{
  LZ4HC_match_t match = { 0 , 0 };
  const BYTE* matchPtr = NULL((void*)0);
  /* note : LZ4HC_InsertAndGetWiderMatch() is able to modify the starting position of a match (*startpos),
   * but this won't be the case here, as we define iLowLimit==ip,
   * so LZ4HC_InsertAndGetWiderMatch() won't be allowed to search past ip */
  int matchLength = LZ4HC_InsertAndGetWiderMatch(ctx, ip, ip, iHighLimit, minLen, &matchPtr, &ip, nbSearches, 1 /*patternAnalysis*/, 1 /*chainSwap*/, dict, favorDecSpeed);
  if (matchLength <= minLen) return match;
  if (favorDecSpeed) {
      if ((matchLength>18) & (matchLength<=36)) matchLength=18;   /* favor shortcut */
  }
  match.len = matchLength;
  match.off = (int)(ip-matchPtr);
  return match;
1327}


1330static int LZ4HC_compress_optimal ( LZ4HC_CCtx_internal* ctx,
                                  const char* const source,
                                  char* dst,
                                  int* srcSizePtr,
                                  int dstCapacity,
                                  int const nbSearches,
                                  size_t sufficient_len,
                                  const limitedOutput_directive limit,
                                  int const fullUpdate,
                                  const dictCtx_directive dict,
                                  const HCfavor_e favorDecSpeed)
1341{
  int retval = 0;
1343#define TRAILING_LITERALS3 3
1344#if defined(LZ4HC_HEAPMODE1) && LZ4HC_HEAPMODE1==1
  LZ4HC_optimal_t* const opt = (LZ4HC_optimal_t*)ALLOC(sizeof(LZ4HC_optimal_t) * (LZ4_OPT_NUM + TRAILING_LITERALS))malloc(sizeof(LZ4HC_optimal_t) * ((1<<12) + 3));
1346#else
  LZ4HC_optimal_t opt[LZ4_OPT_NUM(1<<12) + TRAILING_LITERALS3];   /* ~64 KB, which is a bit large for stack... */
1348#endif

  const BYTE* ip = (const BYTE*) source;
  const BYTE* anchor = ip;
  const BYTE* const iend = ip + *srcSizePtr;
  const BYTE* const mflimit = iend - MFLIMIT12;
  const BYTE* const matchlimit = iend - LASTLITERALS5;
  BYTE* op = (BYTE*) dst;
  BYTE* opSaved = (BYTE*) dst;
  BYTE* oend = op + dstCapacity;
  int ovml = MINMATCH4;  /* overflow - last sequence */
  const BYTE* ovref = NULL((void*)0);

  /* init */
1362#if defined(LZ4HC_HEAPMODE1) && LZ4HC_HEAPMODE1==1
  if (opt == NULL((void*)0)) goto _return_label;
1364#endif
  DEBUGLOG(5, "LZ4HC_compress_optimal(dst=%p, dstCapa=%u)", dst, (unsigned)dstCapacity){};
  *srcSizePtr = 0;
  if (limit == fillOutput) oend -= LASTLITERALS5;   /* Hack for support LZ4 format restriction */
  if (sufficient_len >= LZ4_OPT_NUM(1<<12)) sufficient_len = LZ4_OPT_NUM(1<<12)-1;

  /* Main Loop */
  while (ip <= mflimit) {
       int const llen = (int)(ip - anchor);
       int best_mlen, best_off;
       int cur, last_match_pos = 0;

       LZ4HC_match_t const firstMatch = LZ4HC_FindLongerMatch(ctx, ip, matchlimit, MINMATCH4-1, nbSearches, dict, favorDecSpeed);
       if (firstMatch.len==0) { ip++; continue; }

       if ((size_t)firstMatch.len > sufficient_len) {
           /* good enough solution : immediate encoding */
           int const firstML = firstMatch.len;
           const BYTE* const matchPos = ip - firstMatch.off;
           opSaved = op;
           if ( LZ4HC_encodeSequence(UPDATABLE(ip, op, anchor)&ip, &op, &anchor, firstML, matchPos, limit, oend) ) {  /* updates ip, op and anchor */
               ovml = firstML;
               ovref = matchPos;
               goto _dest_overflow;
           }
           continue;
       }

       /* set prices for first positions (literals) */
       {   int rPos;
           for (rPos = 0 ; rPos < MINMATCH4 ; rPos++) {
               int const cost = LZ4HC_literalsPrice(llen + rPos);
               opt[rPos].mlen = 1;
               opt[rPos].off = 0;
               opt[rPos].litlen = llen + rPos;
               opt[rPos].price = cost;
               DEBUGLOG(7, "rPos:%3i => price:%3i (litlen=%i) -- initial setup",{}
                           rPos, cost, opt[rPos].litlen){};
       }   }
       /* set prices using initial match */
       {   int mlen = MINMATCH4;
           int const matchML = firstMatch.len;   /* necessarily < sufficient_len < LZ4_OPT_NUM */
           int const offset = firstMatch.off;
           assert(matchML < LZ4_OPT_NUM)((void)0);
           for ( ; mlen <= matchML ; mlen++) {
               int const cost = LZ4HC_sequencePrice(llen, mlen);
               opt[mlen].mlen = mlen;
               opt[mlen].off = offset;
               opt[mlen].litlen = llen;
               opt[mlen].price = cost;
               DEBUGLOG(7, "rPos:%3i => price:%3i (matchlen=%i) -- initial setup",{}
                           mlen, cost, mlen){};
       }   }
       last_match_pos = firstMatch.len;
       {   int addLit;
           for (addLit = 1; addLit <= TRAILING_LITERALS3; addLit ++) {
               opt[last_match_pos+addLit].mlen = 1; /* literal */
               opt[last_match_pos+addLit].off = 0;
               opt[last_match_pos+addLit].litlen = addLit;
               opt[last_match_pos+addLit].price = opt[last_match_pos].price + LZ4HC_literalsPrice(addLit);
               DEBUGLOG(7, "rPos:%3i => price:%3i (litlen=%i) -- initial setup",{}
                           last_match_pos+addLit, opt[last_match_pos+addLit].price, addLit){};
       }   }

       /* check further positions */
       for (cur = 1; cur < last_match_pos; cur++) {
           const BYTE* const curPtr = ip + cur;
           LZ4HC_match_t newMatch;

           if (curPtr > mflimit) break;
           DEBUGLOG(7, "rPos:%u[%u] vs [%u]%u",{}
                   cur, opt[cur].price, opt[cur+1].price, cur+1){};
           if (fullUpdate) {
               /* not useful to search here if next position has same (or lower) cost */
               if ( (opt[cur+1].price <= opt[cur].price)
                 /* in some cases, next position has same cost, but cost rises sharply after, so a small match would still be beneficial */
                 && (opt[cur+MINMATCH4].price < opt[cur].price + 3/*min seq price*/) )
                   continue;
           } else {
               /* not useful to search here if next position has same (or lower) cost */
               if (opt[cur+1].price <= opt[cur].price) continue;
           }

           DEBUGLOG(7, "search at rPos:%u", cur){};
           if (fullUpdate)
               newMatch = LZ4HC_FindLongerMatch(ctx, curPtr, matchlimit, MINMATCH4-1, nbSearches, dict, favorDecSpeed);
           else
               /* only test matches of minimum length; slightly faster, but misses a few bytes */
               newMatch = LZ4HC_FindLongerMatch(ctx, curPtr, matchlimit, last_match_pos - cur, nbSearches, dict, favorDecSpeed);
           if (!newMatch.len) continue;

           if ( ((size_t)newMatch.len > sufficient_len)
             || (newMatch.len + cur >= LZ4_OPT_NUM(1<<12)) ) {
               /* immediate encoding */
               best_mlen = newMatch.len;
               best_off = newMatch.off;
               last_match_pos = cur + 1;
               goto encode;
           }

           /* before match : set price with literals at beginning */
           {   int const baseLitlen = opt[cur].litlen;
               int litlen;
               for (litlen = 1; litlen < MINMATCH4; litlen++) {
                   int const price = opt[cur].price - LZ4HC_literalsPrice(baseLitlen) + LZ4HC_literalsPrice(baseLitlen+litlen);
                   int const pos = cur + litlen;
                   if (price < opt[pos].price) {
                       opt[pos].mlen = 1; /* literal */
                       opt[pos].off = 0;
                       opt[pos].litlen = baseLitlen+litlen;
                       opt[pos].price = price;
                       DEBUGLOG(7, "rPos:%3i => price:%3i (litlen=%i)",{}
                                   pos, price, opt[pos].litlen){};
           }   }   }

           /* set prices using match at position = cur */
           {   int const matchML = newMatch.len;
               int ml = MINMATCH4;

               assert(cur + newMatch.len < LZ4_OPT_NUM)((void)0);
               for ( ; ml <= matchML ; ml++) {
                   int const pos = cur + ml;
                   int const offset = newMatch.off;
                   int price;
                   int ll;
                   DEBUGLOG(7, "testing price rPos %i (last_match_pos=%i)",{}
                               pos, last_match_pos){};
                   if (opt[cur].mlen == 1) {
                       ll = opt[cur].litlen;
                       price = ((cur > ll) ? opt[cur - ll].price : 0)
                             + LZ4HC_sequencePrice(ll, ml);
                   } else {
                       ll = 0;
                       price = opt[cur].price + LZ4HC_sequencePrice(0, ml);
                   }

                  assert((U32)favorDecSpeed <= 1)((void)0);
                   if (pos > last_match_pos+TRAILING_LITERALS3
                    || price <= opt[pos].price - (int)favorDecSpeed) {
                       DEBUGLOG(7, "rPos:%3i => price:%3i (matchlen=%i)",{}
                                   pos, price, ml){};
                       assert(pos < LZ4_OPT_NUM)((void)0);
                       if ( (ml == matchML)  /* last pos of last match */
                         && (last_match_pos < pos) )
                           last_match_pos = pos;
                       opt[pos].mlen = ml;
                       opt[pos].off = offset;
                       opt[pos].litlen = ll;
                       opt[pos].price = price;
           }   }   }
           /* complete following positions with literals */
           {   int addLit;
               for (addLit = 1; addLit <= TRAILING_LITERALS3; addLit ++) {
                   opt[last_match_pos+addLit].mlen = 1; /* literal */
                   opt[last_match_pos+addLit].off = 0;
                   opt[last_match_pos+addLit].litlen = addLit;
                   opt[last_match_pos+addLit].price = opt[last_match_pos].price + LZ4HC_literalsPrice(addLit);
                   DEBUGLOG(7, "rPos:%3i => price:%3i (litlen=%i)", last_match_pos+addLit, opt[last_match_pos+addLit].price, addLit){};
           }   }
       }  /* for (cur = 1; cur <= last_match_pos; cur++) */

       assert(last_match_pos < LZ4_OPT_NUM + TRAILING_LITERALS)((void)0);
       best_mlen = opt[last_match_pos].mlen;
       best_off = opt[last_match_pos].off;
       cur = last_match_pos - best_mlen;

1530encode: /* cur, last_match_pos, best_mlen, best_off must be set */
       assert(cur < LZ4_OPT_NUM)((void)0);
       assert(last_match_pos >= 1)((void)0);  /* == 1 when only one candidate */
       DEBUGLOG(6, "reverse traversal, looking for shortest path (last_match_pos=%i)", last_match_pos){};
       {   int candidate_pos = cur;
           int selected_matchLength = best_mlen;
           int selected_offset = best_off;
           while (1) {  /* from end to beginning */
               int const next_matchLength = opt[candidate_pos].mlen;  /* can be 1, means literal */
               int const next_offset = opt[candidate_pos].off;
               DEBUGLOG(7, "pos %i: sequence length %i", candidate_pos, selected_matchLength){};
               opt[candidate_pos].mlen = selected_matchLength;
               opt[candidate_pos].off = selected_offset;
               selected_matchLength = next_matchLength;
               selected_offset = next_offset;
               if (next_matchLength > candidate_pos) break; /* last match elected, first match to encode */
               assert(next_matchLength > 0)((void)0);  /* can be 1, means literal */
               candidate_pos -= next_matchLength;
       }   }

       /* encode all recorded sequences in order */
       {   int rPos = 0;  /* relative position (to ip) */
           while (rPos < last_match_pos) {
               int const ml = opt[rPos].mlen;
               int const offset = opt[rPos].off;
               if (ml == 1) { ip++; rPos++; continue; }  /* literal; note: can end up with several literals, in which case, skip them */
               rPos += ml;
               assert(ml >= MINMATCH)((void)0);
               assert((offset >= 1) && (offset <= LZ4_DISTANCE_MAX))((void)0);
               opSaved = op;
               if ( LZ4HC_encodeSequence(UPDATABLE(ip, op, anchor)&ip, &op, &anchor, ml, ip - offset, limit, oend) ) {  /* updates ip, op and anchor */
                   ovml = ml;
                   ovref = ip - offset;
                   goto _dest_overflow;
       }   }   }
   }  /* while (ip <= mflimit) */

1567_last_literals:
   /* Encode Last Literals */
   {   size_t lastRunSize = (size_t)(iend - anchor);  /* literals */
       size_t llAdd = (lastRunSize + 255 - RUN_MASK((1U<<(8-4))-1)) / 255;
       size_t const totalSize = 1 + llAdd + lastRunSize;
       if (limit == fillOutput) oend += LASTLITERALS5;  /* restore correct value */
       if (limit && (op + totalSize > oend)) {
           if (limit == limitedOutput) { /* Check output limit */
              retval = 0;
              goto _return_label;
           }
           /* adapt lastRunSize to fill 'dst' */
           lastRunSize  = (size_t)(oend - op) - 1 /*token*/;
           llAdd = (lastRunSize + 256 - RUN_MASK((1U<<(8-4))-1)) / 256;
           lastRunSize -= llAdd;
       }
       DEBUGLOG(6, "Final literal run : %i literals", (int)lastRunSize){};
       ip = anchor + lastRunSize; /* can be != iend if limit==fillOutput */

       if (lastRunSize >= RUN_MASK((1U<<(8-4))-1)) {
           size_t accumulator = lastRunSize - RUN_MASK((1U<<(8-4))-1);
           *op++ = (RUN_MASK((1U<<(8-4))-1) << ML_BITS4);
           for(; accumulator >= 255 ; accumulator -= 255) *op++ = 255;
           *op++ = (BYTE) accumulator;
       } else {
           *op++ = (BYTE)(lastRunSize << ML_BITS4);
       }
       LZ4_memcpy(op, anchor, lastRunSize)__builtin_memcpy(op, anchor, lastRunSize);
       op += lastRunSize;
   }

   /* End */
   *srcSizePtr = (int) (((const char*)ip) - source);
   retval = (int) ((char*)op-dst);
   goto _return_label;

1603_dest_overflow:
1604if (limit == fillOutput) {
   /* Assumption : ip, anchor, ovml and ovref must be set correctly */
   size_t const ll = (size_t)(ip - anchor);
   size_t const ll_addbytes = (ll + 240) / 255;
   size_t const ll_totalCost = 1 + ll_addbytes + ll;
   BYTE* const maxLitPos = oend - 3; /* 2 for offset, 1 for token */
   DEBUGLOG(6, "Last sequence overflowing (only %i bytes remaining)", (int)(oend-1-opSaved)){};
   op = opSaved;  /* restore correct out pointer */
   if (op + ll_totalCost <= maxLitPos) {
       /* ll validated; now adjust match length */
       size_t const bytesLeftForMl = (size_t)(maxLitPos - (op+ll_totalCost));
       size_t const maxMlSize = MINMATCH4 + (ML_MASK((1U<<4)-1)-1) + (bytesLeftForMl * 255);
       assert(maxMlSize < INT_MAX)((void)0); assert(ovml >= 0)((void)0);
       if ((size_t)ovml > maxMlSize) ovml = (int)maxMlSize;
       if ((oend + LASTLITERALS5) - (op + ll_totalCost + 2) - 1 + ovml >= MFLIMIT12) {
           DEBUGLOG(6, "Space to end : %i + ml (%i)", (int)((oend + LASTLITERALS) - (op + ll_totalCost + 2) - 1), ovml){};
           DEBUGLOG(6, "Before : ip = %p, anchor = %p", ip, anchor){};
           LZ4HC_encodeSequence(UPDATABLE(ip, op, anchor)&ip, &op, &anchor, ovml, ovref, notLimited, oend);
           DEBUGLOG(6, "After : ip = %p, anchor = %p", ip, anchor){};
   }   }
   goto _last_literals;
1625}
1626_return_label:
1627#if defined(LZ4HC_HEAPMODE1) && LZ4HC_HEAPMODE1==1
   FREEMEM(opt)free(opt);
1629#endif
   return retval;
1631}